Docs Home Pulumi IaC Pulumi ESC Pulumi Insights Pulumi IDP Pulumi Cloud Packages Tutorials
  1. Packages
  2. Docker Provider
  3. API Docs
  4. Image
Docker v4.7.0 published on Wednesday, May 21, 2025 by Pulumi
pulumi/pulumi-docker

docker.Image

Explore with Pulumi AI

docker logo
Docker v4.7.0 published on Wednesday, May 21, 2025 by Pulumi
pulumi/pulumi-docker

    Image builds a Docker image and pushes it Docker and OCI compatible registries. This resource enables running Docker builds as part of a Pulumi deployment.

    Note: We recommend you migrate your images to the more modern Docker Build provider to get the best possible support, features, and performance.

    Note: This resource does not delete tags, locally or remotely, when destroyed.

    Image name

    The Image resource uses imageName to refer to a fully qualified Docker image name, by the format repository:tag. Note that this does not include any digest information and thus will not cause any updates when passed to dependencies, even when using latest tag. To trigger such updates, e.g. when referencing pushed images in container orchestration and management resources, please use the repoDigest Output instead, which is of the format repository@<algorithm>:<hash> and unique per build/push. As of Docker v4.4, repoDigest is now available for local Images.

    Cross-platform builds

    The Image resource supports cross-platform builds when the Docker engine has cross-platform support enabled via emulators. The Image resource currently supports providing only a single operating system and architecture in the platform field, e.g.: linux/amd64. To enable this support, you may need to install the emulators in the environment running your Pulumi program.

    If you are using Linux, you may be using Docker Engine or Docker Desktop for Linux, depending on how you have installed Docker. The FAQ for Docker Desktop for Linux describes the differences and how to select which Docker context is in use.

    • For local development using Docker Desktop, this is enabled by default.

    • For systems using Docker Engine, install the QEMU binaries and register them with using the docker image from github.com/tonistiigi/binfmt:

      docker run --privileged --rm tonistiigi/binfmt --install all

    • In a GitHub Actions workflow, the docker/setup-qemu-action can be used instead by adding this step to your workflow file. Example workflow usage:

      name: Pulumi
on:
  push:
    branches:
      - master
jobs:
  up:
    name: Preview
    runs-on: ubuntu-latest
    steps:
        # This is the step added:
      - name: Set up QEMU
        uses: docker/setup-qemu-action@v2
        # The ordinary pulumi/actions workflow:
      - uses: actions/checkout@v3
      - uses: pulumi/actions@v4
        with:
          command: preview
          stack-name: org-name/stack-name
        env:
          PULUMI_ACCESS_TOKEN: ${{ secrets.PULUMI_ACCESS_TOKEN }}

    Example Usage

    A Docker image build

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

return await Deployment.RunAsync(() => 
{
    var demoImage = new Docker.Image("demo-image", new()
    {
        Build = new Docker.Inputs.DockerBuildArgs
        {
            Context = ".",
            Dockerfile = "Dockerfile",
            Platform = "linux/amd64",
        },
        ImageName = "username/image:tag1",
        SkipPush = true,
    });

    return new Dictionary<string, object?>
    {
        ["imageName"] = demoImage.ImageName,
    };
});

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		demoImage, err := docker.NewImage(ctx, "demo-image", &docker.ImageArgs{
			Build: &docker.DockerBuildArgs{
				Context:    pulumi.String("."),
				Dockerfile: pulumi.String("Dockerfile"),
				Platform:   pulumi.String("linux/amd64"),
			},
			ImageName: pulumi.String("username/image:tag1"),
			SkipPush:  pulumi.Bool(true),
		})
		if err != nil {
			return err
		}
		ctx.Export("imageName", demoImage.ImageName)
		return nil
	})
}

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.docker.Image;
import com.pulumi.docker.ImageArgs;
import com.pulumi.docker.inputs.DockerBuildArgs;
import java.util.List;
import java.util.ArrayList;
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 demoImage = new Image("demoImage", ImageArgs.builder()
            .build(DockerBuildArgs.builder()
                .context(".")
                .dockerfile("Dockerfile")
                .platform("linux/amd64")
                .build())
            .imageName("username/image:tag1")
            .skipPush(true)
            .build());

        ctx.export("imageName", demoImage.imageName());
    }
}

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

const demoImage = new docker.Image("demo-image", {
    build: {
        context: ".",
        dockerfile: "Dockerfile",
        platform: "linux/amd64",
    },
    imageName: "username/image:tag1",
    skipPush: true,
});
export const imageName = demoImage.imageName;

    import pulumi
import pulumi_docker as docker

demo_image = docker.Image("demo-image",
    build={
        "context": ".",
        "dockerfile": "Dockerfile",
        "platform": "linux/amd64",
    },
    image_name="username/image:tag1",
    skip_push=True)
pulumi.export("imageName", demo_image.image_name)

    config: {}
description: A Docker image build
name: image-yaml
outputs:
    imageName: ${demo-image.imageName}
resources:
    demo-image:
        options:
            version: v4.4.0
        properties:
            build:
                context: .
                dockerfile: Dockerfile
                platform: linux/amd64
            imageName: username/image:tag1
            skipPush: true
        type: docker:Image
runtime: yaml
variables: {}

    A Docker image build and push

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

return await Deployment.RunAsync(() => 
{
    var demoPushImage = new Docker.Image("demo-push-image", new()
    {
        Build = new Docker.Inputs.DockerBuildArgs
        {
            Context = ".",
            Dockerfile = "Dockerfile",
        },
        ImageName = "docker.io/username/push-image:tag1",
    });

    return new Dictionary<string, object?>
    {
        ["imageName"] = demoPushImage.ImageName,
        ["repoDigest"] = demoPushImage.RepoDigest,
    };
});

    package main

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

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		demoPushImage, err := docker.NewImage(ctx, "demo-push-image", &docker.ImageArgs{
			Build: &docker.DockerBuildArgs{
				Context:    pulumi.String("."),
				Dockerfile: pulumi.String("Dockerfile"),
			},
			ImageName: pulumi.String("docker.io/username/push-image:tag1"),
		})
		if err != nil {
			return err
		}
		ctx.Export("imageName", demoPushImage.ImageName)
		ctx.Export("repoDigest", demoPushImage.RepoDigest)
		return nil
	})
}

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.docker.Image;
import com.pulumi.docker.ImageArgs;
import com.pulumi.docker.inputs.DockerBuildArgs;
import java.util.List;
import java.util.ArrayList;
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 demoPushImage = new Image("demoPushImage", ImageArgs.builder()
            .build(DockerBuildArgs.builder()
                .context(".")
                .dockerfile("Dockerfile")
                .build())
            .imageName("docker.io/username/push-image:tag1")
            .build());

        ctx.export("imageName", demoPushImage.imageName());
        ctx.export("repoDigest", demoPushImage.repoDigest());
    }
}

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

const demoPushImage = new docker.Image("demo-push-image", {
    build: {
        context: ".",
        dockerfile: "Dockerfile",
    },
    imageName: "docker.io/username/push-image:tag1",
});
export const imageName = demoPushImage.imageName;
export const repoDigest = demoPushImage.repoDigest;

    import pulumi
import pulumi_docker as docker

demo_push_image = docker.Image("demo-push-image",
    build={
        "context": ".",
        "dockerfile": "Dockerfile",
    },
    image_name="docker.io/username/push-image:tag1")
pulumi.export("imageName", demo_push_image.image_name)
pulumi.export("repoDigest", demo_push_image.repo_digest)

    config: {}
description: A Docker image build and push
name: image-push-yaml
outputs:
    imageName: ${demo-push-image.imageName}
    repoDigest: ${demo-push-image.repoDigest}
resources:
    demo-push-image:
        options:
            version: v4.4.0
        properties:
            build:
                context: .
                dockerfile: Dockerfile
            imageName: docker.io/username/push-image:tag1
        type: docker:Image
runtime: yaml
variables: {}

    Docker image build using caching with AWS Elastic Container Registry

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

return await Deployment.RunAsync(() => 
{
    var ecrRepository = new Aws.Ecr.Repository("ecr-repository", new()
    {
        Name = "docker-repository",
    });

    var authToken = Aws.Ecr.GetAuthorizationToken.Invoke(new()
    {
        RegistryId = ecrRepository.RegistryId,
    });

    var myAppImage = new Docker.Image("my-app-image", new()
    {
        Build = new Docker.Inputs.DockerBuildArgs
        {
            Args = 
            {
                { "BUILDKIT_INLINE_CACHE", "1" },
            },
            CacheFrom = new Docker.Inputs.CacheFromArgs
            {
                Images = new[]
                {
                    ecrRepository.RepositoryUrl.Apply(repositoryUrl => $"{repositoryUrl}:latest"),
                },
            },
            Context = "app/",
            Dockerfile = "app/Dockerfile",
        },
        ImageName = ecrRepository.RepositoryUrl.Apply(repositoryUrl => $"{repositoryUrl}:latest"),
        Registry = new Docker.Inputs.RegistryArgs
        {
            Password = Output.CreateSecret(authToken.Apply(getAuthorizationTokenResult => getAuthorizationTokenResult.Password)),
            Server = ecrRepository.RepositoryUrl,
            Username = authToken.Apply(getAuthorizationTokenResult => getAuthorizationTokenResult.UserName),
        },
    });

    return new Dictionary<string, object?>
    {
        ["imageName"] = myAppImage.ImageName,
    };
});

    package main

import (
	"fmt"

	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/ecr"
	"github.com/pulumi/pulumi-docker/sdk/v4/go/docker"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		ecrRepository, err := ecr.NewRepository(ctx, "ecr-repository", &ecr.RepositoryArgs{
			Name: pulumi.String("docker-repository"),
		})
		if err != nil {
			return err
		}
		authToken := ecr.GetAuthorizationTokenOutput(ctx, ecr.GetAuthorizationTokenOutputArgs{
			RegistryId: ecrRepository.RegistryId,
		}, nil)
		myAppImage, err := docker.NewImage(ctx, "my-app-image", &docker.ImageArgs{
			Build: &docker.DockerBuildArgs{
				Args: pulumi.StringMap{
					"BUILDKIT_INLINE_CACHE": pulumi.String("1"),
				},
				CacheFrom: &docker.CacheFromArgs{
					Images: pulumi.StringArray{
						ecrRepository.RepositoryUrl.ApplyT(func(repositoryUrl string) (string, error) {
							return fmt.Sprintf("%v:latest", repositoryUrl), nil
						}).(pulumi.StringOutput),
					},
				},
				Context:    pulumi.String("app/"),
				Dockerfile: pulumi.String("app/Dockerfile"),
			},
			ImageName: ecrRepository.RepositoryUrl.ApplyT(func(repositoryUrl string) (string, error) {
				return fmt.Sprintf("%v:latest", repositoryUrl), nil
			}).(pulumi.StringOutput),
			Registry: &docker.RegistryArgs{
				Password: pulumi.ToSecret(authToken.ApplyT(func(authToken ecr.GetAuthorizationTokenResult) (*string, error) {
					return &authToken.Password, nil
				}).(pulumi.StringPtrOutput)).(pulumi.StringOutput),
				Server: ecrRepository.RepositoryUrl,
				Username: authToken.ApplyT(func(authToken ecr.GetAuthorizationTokenResult) (*string, error) {
					return &authToken.UserName, nil
				}).(pulumi.StringPtrOutput),
			},
		})
		if err != nil {
			return err
		}
		ctx.Export("imageName", myAppImage.ImageName)
		return nil
	})
}

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.ecr.Repository;
import com.pulumi.aws.ecr.RepositoryArgs;
import com.pulumi.aws.ecr.EcrFunctions;
import com.pulumi.aws.ecr.inputs.GetAuthorizationTokenArgs;
import com.pulumi.docker.Image;
import com.pulumi.docker.ImageArgs;
import com.pulumi.docker.inputs.DockerBuildArgs;
import com.pulumi.docker.inputs.CacheFromArgs;
import com.pulumi.docker.inputs.RegistryArgs;
import java.util.List;
import java.util.ArrayList;
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 ecrRepository = new Repository("ecrRepository", RepositoryArgs.builder()
            .name("docker-repository")
            .build());

        final var authToken = EcrFunctions.getAuthorizationToken(GetAuthorizationTokenArgs.builder()
            .registryId(ecrRepository.registryId())
            .build());

        var myAppImage = new Image("myAppImage", ImageArgs.builder()
            .build(DockerBuildArgs.builder()
                .args(Map.of("BUILDKIT_INLINE_CACHE", "1"))
                .cacheFrom(CacheFromArgs.builder()
                    .images(ecrRepository.repositoryUrl().applyValue(_repositoryUrl -> String.format("%s:latest", _repositoryUrl)))
                    .build())
                .context("app/")
                .dockerfile("app/Dockerfile")
                .build())
            .imageName(ecrRepository.repositoryUrl().applyValue(_repositoryUrl -> String.format("%s:latest", _repositoryUrl)))
            .registry(RegistryArgs.builder()
                .password(Output.ofSecret(authToken.applyValue(_authToken -> _authToken.password())))
                .server(ecrRepository.repositoryUrl())
                .username(authToken.applyValue(_authToken -> _authToken.userName()))
                .build())
            .build());

        ctx.export("imageName", myAppImage.imageName());
    }
}

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

const ecrRepository = new aws.ecr.Repository("ecr-repository", {name: "docker-repository"});
const authToken = aws.ecr.getAuthorizationTokenOutput({
    registryId: ecrRepository.registryId,
});
const myAppImage = new docker.Image("my-app-image", {
    build: {
        args: {
            BUILDKIT_INLINE_CACHE: "1",
        },
        cacheFrom: {
            images: [pulumi.interpolate`${ecrRepository.repositoryUrl}:latest`],
        },
        context: "app/",
        dockerfile: "app/Dockerfile",
    },
    imageName: pulumi.interpolate`${ecrRepository.repositoryUrl}:latest`,
    registry: {
        password: pulumi.secret(authToken.apply(authToken => authToken.password)),
        server: ecrRepository.repositoryUrl,
        username: authToken.apply(authToken => authToken.userName),
    },
});
export const imageName = myAppImage.imageName;

    import pulumi
import pulumi_aws as aws
import pulumi_docker as docker

ecr_repository = aws.ecr.Repository("ecr-repository", name="docker-repository")
auth_token = aws.ecr.get_authorization_token_output(registry_id=ecr_repository.registry_id)
my_app_image = docker.Image("my-app-image",
    build={
        "args": {
            "BUILDKIT_INLINE_CACHE": "1",
        },
        "cache_from": {
            "images": [ecr_repository.repository_url.apply(lambda repository_url: f"{repository_url}:latest")],
        },
        "context": "app/",
        "dockerfile": "app/Dockerfile",
    },
    image_name=ecr_repository.repository_url.apply(lambda repository_url: f"{repository_url}:latest"),
    registry={
        "password": pulumi.Output.secret(auth_token.password),
        "server": ecr_repository.repository_url,
        "username": auth_token.user_name,
    })
pulumi.export("imageName", my_app_image.image_name)

    config: {}
description: Docker image build using caching with AWS Elastic Container Registry
name: image-caching-yaml
outputs:
    imageName: ${my-app-image.imageName}
resources:
    ecr-repository:
        properties:
            name: docker-repository
        type: aws:ecr:Repository
    my-app-image:
        options:
            version: v4.1.2
        properties:
            build:
                args:
                    BUILDKIT_INLINE_CACHE: "1"
                cacheFrom:
                    images:
                        - ${ecr-repository.repositoryUrl}:latest
                context: app/
                dockerfile: app/Dockerfile
            imageName: ${ecr-repository.repositoryUrl}:latest
            registry:
                password:
                    fn::secret: ${authToken.password}
                server: ${ecr-repository.repositoryUrl}
                username: ${authToken.userName}
        type: docker:Image
runtime: yaml
variables:
    authToken:
        fn::aws:ecr:getAuthorizationToken:
            registryId: ${ecr-repository.registryId}

    Create Image Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Image(name: string, args: ImageArgs, opts?: CustomResourceOptions);
    @overload
def Image(image_name,
          build,
          local_image_name=None,
          registry=None,
          skip_push=None,
          opts=None)

@overload
def Image(image_name,
          build,
          local_image_name=None,
          registry=None,
          skip_push=None,
          opts=None)
    func NewImage(ctx *Context, name string, args ImageArgs, opts ...ResourceOption) (*Image, error)
    public Image(string name, ImageArgs args, CustomResourceOptions? opts = null)
    public Image(String name, ImageArgs args)
public Image(String name, ImageArgs args, CustomResourceOptions options)

    type: docker:Image
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.

    Parameters

    name string
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    image_name
    build
    local_image_name
    registry
    skip_push
    opts
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args ImageArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var imageResource = new Docker.Image("imageResource", new()
{
    ImageName = "string",
    Build = new Docker.Inputs.DockerBuildArgs
    {
        AddHosts = new[]
        {
            "string",
        },
        Args = 
        {
            { "string", "string" },
        },
        BuilderVersion = Docker.BuilderVersion.BuilderV1,
        CacheFrom = new Docker.Inputs.CacheFromArgs
        {
            Images = new[]
            {
                "string",
            },
        },
        Context = "string",
        Dockerfile = "string",
        Network = "string",
        Platform = "string",
        Target = "string",
    },
    BuildOnPreview = false,
    Registry = new Docker.Inputs.RegistryArgs
    {
        Password = "string",
        Server = "string",
        Username = "string",
    },
    SkipPush = false,
});

    example, err := docker.NewImage(ctx, "imageResource", &docker.ImageArgs{
	ImageName: pulumi.String("string"),
	Build: &docker.DockerBuildArgs{
		AddHosts: pulumi.StringArray{
			pulumi.String("string"),
		},
		Args: pulumi.StringMap{
			"string": pulumi.String("string"),
		},
		BuilderVersion: docker.BuilderVersionBuilderV1,
		CacheFrom: &docker.CacheFromArgs{
			Images: pulumi.StringArray{
				pulumi.String("string"),
			},
		},
		Context:    pulumi.String("string"),
		Dockerfile: pulumi.String("string"),
		Network:    pulumi.String("string"),
		Platform:   pulumi.String("string"),
		Target:     pulumi.String("string"),
	},
	BuildOnPreview: pulumi.Bool(false),
	Registry: &docker.RegistryArgs{
		Password: pulumi.String("string"),
		Server:   pulumi.String("string"),
		Username: pulumi.String("string"),
	},
	SkipPush: pulumi.Bool(false),
})

    var imageResource = new Image("imageResource", ImageArgs.builder()
    .imageName("string")
    .build(DockerBuildArgs.builder()
        .addHosts("string")
        .args(Map.of("string", "string"))
        .builderVersion("BuilderV1")
        .cacheFrom(CacheFromArgs.builder()
            .images("string")
            .build())
        .context("string")
        .dockerfile("string")
        .network("string")
        .platform("string")
        .target("string")
        .build())
    .buildOnPreview(false)
    .registry(RegistryArgs.builder()
        .password("string")
        .server("string")
        .username("string")
        .build())
    .skipPush(false)
    .build());

    image_resource = docker.Image("imageResource",
    image_name="string",
    build={
        "add_hosts": ["string"],
        "args": {
            "string": "string",
        },
        "builder_version": docker.BuilderVersion.BUILDER_V1,
        "cache_from": {
            "images": ["string"],
        },
        "context": "string",
        "dockerfile": "string",
        "network": "string",
        "platform": "string",
        "target": "string",
    },
    build_on_preview=False,
    registry={
        "password": "string",
        "server": "string",
        "username": "string",
    },
    skip_push=False)

    const imageResource = new docker.Image("imageResource", {
    imageName: "string",
    build: {
        addHosts: ["string"],
        args: {
            string: "string",
        },
        builderVersion: docker.index.BuilderVersion.BuilderV1,
        cacheFrom: {
            images: ["string"],
        },
        context: "string",
        dockerfile: "string",
        network: "string",
        platform: "string",
        target: "string",
    },
    buildOnPreview: false,
    registry: {
        password: "string",
        server: "string",
        username: "string",
    },
    skipPush: false,
});

    type: docker:Image
properties:
    build:
        addHosts:
            - string
        args:
            string: string
        builderVersion: BuilderV1
        cacheFrom:
            images:
                - string
        context: string
        dockerfile: string
        network: string
        platform: string
        target: string
    buildOnPreview: false
    imageName: string
    registry:
        password: string
        server: string
        username: string
    skipPush: false

    Image Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Image resource accepts the following input properties:

    ImageName string
    The image name, of the format repository[:tag], e.g. docker.io/username/demo-image:v1. This reference is not unique to each build and push.For the unique manifest SHA of a pushed docker image, or the local image ID, please use repoDigest.
    Build DockerBuild
    The Docker build context
    BuildOnPreview bool
    A flag to build an image on preview
    Registry Registry
    The registry to push the image to
    SkipPush bool
    A flag to skip a registry push.
    ImageName string
    The image name, of the format repository[:tag], e.g. docker.io/username/demo-image:v1. This reference is not unique to each build and push.For the unique manifest SHA of a pushed docker image, or the local image ID, please use repoDigest.
    Build DockerBuildArgs
    The Docker build context
    BuildOnPreview bool
    A flag to build an image on preview
    Registry RegistryArgs
    The registry to push the image to
    SkipPush bool
    A flag to skip a registry push.
    imageName String
    The image name, of the format repository[:tag], e.g. docker.io/username/demo-image:v1. This reference is not unique to each build and push.For the unique manifest SHA of a pushed docker image, or the local image ID, please use repoDigest.
    build DockerBuild
    The Docker build context
    buildOnPreview Boolean
    A flag to build an image on preview
    registry Registry
    The registry to push the image to
    skipPush Boolean
    A flag to skip a registry push.
    imageName string
    The image name, of the format repository[:tag], e.g. docker.io/username/demo-image:v1. This reference is not unique to each build and push.For the unique manifest SHA of a pushed docker image, or the local image ID, please use repoDigest.
    build DockerBuild
    The Docker build context
    buildOnPreview boolean
    A flag to build an image on preview
    registry Registry
    The registry to push the image to
    skipPush boolean
    A flag to skip a registry push.
    image_name str
    The image name, of the format repository[:tag], e.g. docker.io/username/demo-image:v1. This reference is not unique to each build and push.For the unique manifest SHA of a pushed docker image, or the local image ID, please use repoDigest.
    build DockerBuildArgs
    The Docker build context
    build_on_preview bool
    A flag to build an image on preview
    registry RegistryArgs
    The registry to push the image to
    skip_push bool
    A flag to skip a registry push.
    imageName String
    The image name, of the format repository[:tag], e.g. docker.io/username/demo-image:v1. This reference is not unique to each build and push.For the unique manifest SHA of a pushed docker image, or the local image ID, please use repoDigest.
    build Property Map
    The Docker build context
    buildOnPreview Boolean
    A flag to build an image on preview
    registry Property Map
    The registry to push the image to
    skipPush Boolean
    A flag to skip a registry push.

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Image resource produces the following output properties:

    BaseImageName string
    The fully qualified image name that was pushed to the registry.
    Context string
    The path to the build context to use.
    Dockerfile string
    The location of the Dockerfile relative to the docker build context.
    Id string
    The provider-assigned unique ID for this managed resource.
    RegistryServer string
    The name of the registry server hosting the image.
    RepoDigest string

    For pushed images: The manifest digest of an image pushed to a registry, of the format repository@:, e.g. username/demo-image@sha256:a6ae6dd8d39c5bb02320e41abf00cd4cb35905fec540e37d306c878be8d38bd3. This reference is unique per image build and push. Only available for images pushed to a registry. Use when passing a reference to a pushed image to container management resources.

    Local-only imagesFor local images, this field is the image ID of the built local image, of the format :, e.g sha256:826a130323165bb0ccb0374ae774f885c067a951b51a6ee133577f4e5dbc4119

    Platform string
    The image's architecture and OS
    BaseImageName string
    The fully qualified image name that was pushed to the registry.
    Context string
    The path to the build context to use.
    Dockerfile string
    The location of the Dockerfile relative to the docker build context.
    Id string
    The provider-assigned unique ID for this managed resource.
    RegistryServer string
    The name of the registry server hosting the image.
    RepoDigest string

    For pushed images: The manifest digest of an image pushed to a registry, of the format repository@:, e.g. username/demo-image@sha256:a6ae6dd8d39c5bb02320e41abf00cd4cb35905fec540e37d306c878be8d38bd3. This reference is unique per image build and push. Only available for images pushed to a registry. Use when passing a reference to a pushed image to container management resources.

    Local-only imagesFor local images, this field is the image ID of the built local image, of the format :, e.g sha256:826a130323165bb0ccb0374ae774f885c067a951b51a6ee133577f4e5dbc4119

    Platform string
    The image's architecture and OS
    baseImageName String
    The fully qualified image name that was pushed to the registry.
    context String
    The path to the build context to use.
    dockerfile String
    The location of the Dockerfile relative to the docker build context.
    id String
    The provider-assigned unique ID for this managed resource.
    registryServer String
    The name of the registry server hosting the image.
    repoDigest String

    For pushed images: The manifest digest of an image pushed to a registry, of the format repository@:, e.g. username/demo-image@sha256:a6ae6dd8d39c5bb02320e41abf00cd4cb35905fec540e37d306c878be8d38bd3. This reference is unique per image build and push. Only available for images pushed to a registry. Use when passing a reference to a pushed image to container management resources.

    Local-only imagesFor local images, this field is the image ID of the built local image, of the format :, e.g sha256:826a130323165bb0ccb0374ae774f885c067a951b51a6ee133577f4e5dbc4119

    platform String
    The image's architecture and OS
    baseImageName string
    The fully qualified image name that was pushed to the registry.
    context string
    The path to the build context to use.
    dockerfile string
    The location of the Dockerfile relative to the docker build context.
    id string
    The provider-assigned unique ID for this managed resource.
    registryServer string
    The name of the registry server hosting the image.
    repoDigest string

    For pushed images: The manifest digest of an image pushed to a registry, of the format repository@:, e.g. username/demo-image@sha256:a6ae6dd8d39c5bb02320e41abf00cd4cb35905fec540e37d306c878be8d38bd3. This reference is unique per image build and push. Only available for images pushed to a registry. Use when passing a reference to a pushed image to container management resources.

    Local-only imagesFor local images, this field is the image ID of the built local image, of the format :, e.g sha256:826a130323165bb0ccb0374ae774f885c067a951b51a6ee133577f4e5dbc4119

    platform string
    The image's architecture and OS
    base_image_name str
    The fully qualified image name that was pushed to the registry.
    context str
    The path to the build context to use.
    dockerfile str
    The location of the Dockerfile relative to the docker build context.
    id str
    The provider-assigned unique ID for this managed resource.
    registry_server str
    The name of the registry server hosting the image.
    repo_digest str

    For pushed images: The manifest digest of an image pushed to a registry, of the format repository@:, e.g. username/demo-image@sha256:a6ae6dd8d39c5bb02320e41abf00cd4cb35905fec540e37d306c878be8d38bd3. This reference is unique per image build and push. Only available for images pushed to a registry. Use when passing a reference to a pushed image to container management resources.

    Local-only imagesFor local images, this field is the image ID of the built local image, of the format :, e.g sha256:826a130323165bb0ccb0374ae774f885c067a951b51a6ee133577f4e5dbc4119

    platform str
    The image's architecture and OS
    baseImageName String
    The fully qualified image name that was pushed to the registry.
    context String
    The path to the build context to use.
    dockerfile String
    The location of the Dockerfile relative to the docker build context.
    id String
    The provider-assigned unique ID for this managed resource.
    registryServer String
    The name of the registry server hosting the image.
    repoDigest String

    For pushed images: The manifest digest of an image pushed to a registry, of the format repository@:, e.g. username/demo-image@sha256:a6ae6dd8d39c5bb02320e41abf00cd4cb35905fec540e37d306c878be8d38bd3. This reference is unique per image build and push. Only available for images pushed to a registry. Use when passing a reference to a pushed image to container management resources.

    Local-only imagesFor local images, this field is the image ID of the built local image, of the format :, e.g sha256:826a130323165bb0ccb0374ae774f885c067a951b51a6ee133577f4e5dbc4119

    platform String
    The image's architecture and OS

    Supporting Types

    BuilderVersion, BuilderVersionArgs

    BuilderV1
    BuilderV1The first generation builder for Docker Daemon
    BuilderBuildKit
    BuilderBuildKitThe builder based on moby/buildkit project
    BuilderVersionBuilderV1
    BuilderV1The first generation builder for Docker Daemon
    BuilderVersionBuilderBuildKit
    BuilderBuildKitThe builder based on moby/buildkit project
    BuilderV1
    BuilderV1The first generation builder for Docker Daemon
    BuilderBuildKit
    BuilderBuildKitThe builder based on moby/buildkit project
    BuilderV1
    BuilderV1The first generation builder for Docker Daemon
    BuilderBuildKit
    BuilderBuildKitThe builder based on moby/buildkit project
    BUILDER_V1
    BuilderV1The first generation builder for Docker Daemon
    BUILDER_BUILD_KIT
    BuilderBuildKitThe builder based on moby/buildkit project
    "BuilderV1"
    BuilderV1The first generation builder for Docker Daemon
    "BuilderBuildKit"
    BuilderBuildKitThe builder based on moby/buildkit project

    CacheFrom, CacheFromArgs

    Images List<string>
    Specifies cached images
    Images []string
    Specifies cached images
    images List<String>
    Specifies cached images
    images string[]
    Specifies cached images
    images Sequence[str]
    Specifies cached images
    images List<String>
    Specifies cached images

    DockerBuild, DockerBuildArgs

    AddHosts List<string>
    Custom host-to-IP mappings to use while building (format: "host:ip")
    Args Dictionary<string, string>
    An optional map of named build-time argument variables to set during the Docker build. This flag allows you to pass build-time variables that can be accessed like environment variables inside the RUN instruction.
    BuilderVersion Pulumi.Docker.BuilderVersion
    The version of the Docker builder.
    CacheFrom CacheFrom
    A list of image names to use as build cache. Images provided must have a cache manifest. Must provide authentication to cache registry.
    Context string
    The path to the build context to use.
    Dockerfile string
    The path to the Dockerfile to use.
    Network string
    Set the networking mode for RUN instructions
    Platform string
    The architecture of the platform you want to build this image for, e.g. linux/arm64.
    Target string
    The target of the Dockerfile to build
    AddHosts []string
    Custom host-to-IP mappings to use while building (format: "host:ip")
    Args map[string]string
    An optional map of named build-time argument variables to set during the Docker build. This flag allows you to pass build-time variables that can be accessed like environment variables inside the RUN instruction.
    BuilderVersion BuilderVersion
    The version of the Docker builder.
    CacheFrom CacheFrom
    A list of image names to use as build cache. Images provided must have a cache manifest. Must provide authentication to cache registry.
    Context string
    The path to the build context to use.
    Dockerfile string
    The path to the Dockerfile to use.
    Network string
    Set the networking mode for RUN instructions
    Platform string
    The architecture of the platform you want to build this image for, e.g. linux/arm64.
    Target string
    The target of the Dockerfile to build
    addHosts List<String>
    Custom host-to-IP mappings to use while building (format: "host:ip")
    args Map<String,String>
    An optional map of named build-time argument variables to set during the Docker build. This flag allows you to pass build-time variables that can be accessed like environment variables inside the RUN instruction.
    builderVersion BuilderVersion
    The version of the Docker builder.
    cacheFrom CacheFrom
    A list of image names to use as build cache. Images provided must have a cache manifest. Must provide authentication to cache registry.
    context String
    The path to the build context to use.
    dockerfile String
    The path to the Dockerfile to use.
    network String
    Set the networking mode for RUN instructions
    platform String
    The architecture of the platform you want to build this image for, e.g. linux/arm64.
    target String
    The target of the Dockerfile to build
    addHosts string[]
    Custom host-to-IP mappings to use while building (format: "host:ip")
    args {[key: string]: string}
    An optional map of named build-time argument variables to set during the Docker build. This flag allows you to pass build-time variables that can be accessed like environment variables inside the RUN instruction.
    builderVersion BuilderVersion
    The version of the Docker builder.
    cacheFrom CacheFrom
    A list of image names to use as build cache. Images provided must have a cache manifest. Must provide authentication to cache registry.
    context string
    The path to the build context to use.
    dockerfile string
    The path to the Dockerfile to use.
    network string
    Set the networking mode for RUN instructions
    platform string
    The architecture of the platform you want to build this image for, e.g. linux/arm64.
    target string
    The target of the Dockerfile to build
    add_hosts Sequence[str]
    Custom host-to-IP mappings to use while building (format: "host:ip")
    args Mapping[str, str]
    An optional map of named build-time argument variables to set during the Docker build. This flag allows you to pass build-time variables that can be accessed like environment variables inside the RUN instruction.
    builder_version BuilderVersion
    The version of the Docker builder.
    cache_from CacheFrom
    A list of image names to use as build cache. Images provided must have a cache manifest. Must provide authentication to cache registry.
    context str
    The path to the build context to use.
    dockerfile str
    The path to the Dockerfile to use.
    network str
    Set the networking mode for RUN instructions
    platform str
    The architecture of the platform you want to build this image for, e.g. linux/arm64.
    target str
    The target of the Dockerfile to build
    addHosts List<String>
    Custom host-to-IP mappings to use while building (format: "host:ip")
    args Map<String>
    An optional map of named build-time argument variables to set during the Docker build. This flag allows you to pass build-time variables that can be accessed like environment variables inside the RUN instruction.
    builderVersion "BuilderV1" | "BuilderBuildKit"
    The version of the Docker builder.
    cacheFrom Property Map
    A list of image names to use as build cache. Images provided must have a cache manifest. Must provide authentication to cache registry.
    context String
    The path to the build context to use.
    dockerfile String
    The path to the Dockerfile to use.
    network String
    Set the networking mode for RUN instructions
    platform String
    The architecture of the platform you want to build this image for, e.g. linux/arm64.
    target String
    The target of the Dockerfile to build

    Registry, RegistryArgs

    Password string
    The password to authenticate to the registry. Does not cause image rebuild when changed.
    Server string
    The URL of the Docker registry server
    Username string
    The username to authenticate to the registry. Does not cause image rebuild when changed.
    Password string
    The password to authenticate to the registry. Does not cause image rebuild when changed.
    Server string
    The URL of the Docker registry server
    Username string
    The username to authenticate to the registry. Does not cause image rebuild when changed.
    password String
    The password to authenticate to the registry. Does not cause image rebuild when changed.
    server String
    The URL of the Docker registry server
    username String
    The username to authenticate to the registry. Does not cause image rebuild when changed.
    password string
    The password to authenticate to the registry. Does not cause image rebuild when changed.
    server string
    The URL of the Docker registry server
    username string
    The username to authenticate to the registry. Does not cause image rebuild when changed.
    password str
    The password to authenticate to the registry. Does not cause image rebuild when changed.
    server str
    The URL of the Docker registry server
    username str
    The username to authenticate to the registry. Does not cause image rebuild when changed.
    password String
    The password to authenticate to the registry. Does not cause image rebuild when changed.
    server String
    The URL of the Docker registry server
    username String
    The username to authenticate to the registry. Does not cause image rebuild when changed.

    Package Details

    Repository
    Docker pulumi/pulumi-docker
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the docker Terraform Provider.
    docker logo
    Docker v4.7.0 published on Wednesday, May 21, 2025 by Pulumi
    pulumi/pulumi-docker