Container class

<!-- Bug: Type and Name are switched --> Manages the lifecycle of a Docker container.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as docker from "@pulumi/docker";

// Find the latest Ubuntu precise image.
const ubuntuRemoteImage = new docker.RemoteImage("ubuntu", {name: "ubuntu:precise"});
// Start a container
const ubuntu = new docker.Container("ubuntu", {
    name: "foo",
    image: ubuntuRemoteImage.imageId,
});

import pulumi
import pulumi_docker as docker

# Find the latest Ubuntu precise image.
ubuntu_remote_image = docker.RemoteImage("ubuntu", name="ubuntu:precise")
# Start a container
ubuntu = docker.Container("ubuntu",
    name="foo",
    image=ubuntu_remote_image.image_id)

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Docker = Pulumi.Docker;

return await Deployment.RunAsync(() =>
{
    // Find the latest Ubuntu precise image.
    var ubuntuRemoteImage = new Docker.RemoteImage("ubuntu", new()
    {
        Name = "ubuntu:precise",
    });

    // Start a container
    var ubuntu = new Docker.Container("ubuntu", new()
    {
        Name = "foo",
        Image = ubuntuRemoteImage.ImageId,
    });

});

package main

import (
	"github.com/pulumi/pulumi-docker/sdk/v5/go/docker"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		// Find the latest Ubuntu precise image.
		ubuntuRemoteImage, err := docker.NewRemoteImage(ctx, "ubuntu", &docker.RemoteImageArgs{
			Name: pulumi.String("ubuntu:precise"),
		})
		if err != nil {
			return err
		}
		// Start a container
		_, err = docker.NewContainer(ctx, "ubuntu", &docker.ContainerArgs{
			Name:  pulumi.String("foo"),
			Image: ubuntuRemoteImage.ImageId,
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    docker = {
      source = "pulumi/docker"
    }
  }
}

# Start a container
resource "docker_container" "ubuntu" {
  name  = "foo"
  image = docker_remoteimage.ubuntu.image_id
}
# Find the latest Ubuntu precise image.
resource "docker_remoteimage" "ubuntu" {
  name = "ubuntu:precise"
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.docker.RemoteImage;
import com.pulumi.docker.RemoteImageArgs;
import com.pulumi.docker.Container;
import com.pulumi.docker.ContainerArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        // Find the latest Ubuntu precise image.
        var ubuntuRemoteImage = new RemoteImage("ubuntuRemoteImage", RemoteImageArgs.builder()
            .name("ubuntu:precise")
            .build());

        // Start a container
        var ubuntu = new Container("ubuntu", ContainerArgs.builder()
            .name("foo")
            .image(ubuntuRemoteImage.imageId())
            .build());

    }
}

resources:
  # Start a container
  ubuntu:
    type: docker:Container
    properties:
      name: foo
      image: ${ubuntuRemoteImage.imageId}
  # Find the latest Ubuntu precise image.
  ubuntuRemoteImage:
    type: docker:RemoteImage
    name: ubuntu
    properties:
      name: ubuntu:precise

Import

!/bin/bash

$ pulumi import docker:index/container:Container foo id

Example

Assuming you created a container as follows

#!/bin/bash
docker run --name foo -p8080:80 -d nginx
# prints the container ID
9a550c0f0163d39d77222d3efd58701b625d47676c25c686c95b5b92d1cba6fd

you provide the definition for the resource as follows

import * as pulumi from "@pulumi/pulumi";
import * as docker from "@pulumi/docker";

const foo = new docker.Container("foo", {
    name: "foo",
    image: "nginx",
    ports: [{
        internal: 80,
        external: 8080,
    }],
});

import pulumi
import pulumi_docker as docker

foo = docker.Container("foo",
    name="foo",
    image="nginx",
    ports=[{
        "internal": 80,
        "external": 8080,
    }])

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Docker = Pulumi.Docker;

return await Deployment.RunAsync(() =>
{
    var foo = new Docker.Container("foo", new()
    {
        Name = "foo",
        Image = "nginx",
        Ports = new[]
        {
            new Docker.Inputs.ContainerPortArgs
            {
                Internal = 80,
                External = 8080,
            },
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-docker/sdk/v5/go/docker"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := docker.NewContainer(ctx, "foo", &docker.ContainerArgs{
			Name:  pulumi.String("foo"),
			Image: pulumi.String("nginx"),
			Ports: docker.ContainerPortArray{
				&docker.ContainerPortArgs{
					Internal: pulumi.Int(80),
					External: pulumi.Int(8080),
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    docker = {
      source = "pulumi/docker"
    }
  }
}

resource "docker_container" "foo" {
  name  = "foo"
  image = "nginx"
  ports {
    internal = "80"
    external = "8080"
  }
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.docker.Container;
import com.pulumi.docker.ContainerArgs;
import com.pulumi.docker.inputs.ContainerPortArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var foo = new Container("foo", ContainerArgs.builder()
            .name("foo")
            .image("nginx")
            .ports(ContainerPortArgs.builder()
                .internal(80)
                .external(8080)
                .build())
            .build());

    }
}

resources:
  foo:
    type: docker:Container
    properties:
      name: foo
      image: nginx
      ports:
        - internal: '80'
          external: '8080'

then the import command is as follows

!/bin/bash

$ pulumi import docker:index/container:Container foo 9a550c0f0163d39d77222d3efd58701b625d47676c25c686c95b5b92d1cba6fd