pulumi-docker 4.7.0a1705628423__py3-none-any.whl → 4.7.0a1736849606__py3-none-any.whl

pulumi_docker/registry_image.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 
 __all__ = ['RegistryImageArgs', 'RegistryImage']
@@ -17,13 +22,13 @@ class RegistryImageArgs:
                  insecure_skip_verify: Optional[pulumi.Input[bool]] = None,
                  keep_remotely: Optional[pulumi.Input[bool]] = None,
                  name: Optional[pulumi.Input[str]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None):
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None):
         """
         The set of arguments for constructing a RegistryImage resource.
         :param pulumi.Input[bool] insecure_skip_verify: If `true`, the verification of TLS certificates of the server/registry is disabled. Defaults to `false`
         :param pulumi.Input[bool] keep_remotely: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker registry on destroy operation. Defaults to `false`
         :param pulumi.Input[str] name: The name of the Docker image.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
         """
         if insecure_skip_verify is not None:
             pulumi.set(__self__, "insecure_skip_verify", insecure_skip_verify)
@@ -72,14 +77,14 @@ class RegistryImageArgs:
 
     @property
     @pulumi.getter
-    def triggers(self) -> Optional[pulumi.Input[Mapping[str, Any]]]:
+    def triggers(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
         A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
         """
         return pulumi.get(self, "triggers")
 
     @triggers.setter
-    def triggers(self, value: Optional[pulumi.Input[Mapping[str, Any]]]):
+    def triggers(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]):
         pulumi.set(self, "triggers", value)
 
 
@@ -90,14 +95,14 @@ class _RegistryImageState:
                  keep_remotely: Optional[pulumi.Input[bool]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  sha256_digest: Optional[pulumi.Input[str]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None):
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None):
         """
         Input properties used for looking up and filtering RegistryImage resources.
         :param pulumi.Input[bool] insecure_skip_verify: If `true`, the verification of TLS certificates of the server/registry is disabled. Defaults to `false`
         :param pulumi.Input[bool] keep_remotely: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker registry on destroy operation. Defaults to `false`
         :param pulumi.Input[str] name: The name of the Docker image.
         :param pulumi.Input[str] sha256_digest: The sha256 digest of the image.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
         """
         if insecure_skip_verify is not None:
             pulumi.set(__self__, "insecure_skip_verify", insecure_skip_verify)
@@ -160,14 +165,14 @@ class _RegistryImageState:
 
     @property
     @pulumi.getter
-    def triggers(self) -> Optional[pulumi.Input[Mapping[str, Any]]]:
+    def triggers(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
         A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
         """
         return pulumi.get(self, "triggers")
 
     @triggers.setter
-    def triggers(self, value: Optional[pulumi.Input[Mapping[str, Any]]]):
+    def triggers(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]):
         pulumi.set(self, "triggers", value)
 
 
@@ -179,34 +184,18 @@ class RegistryImage(pulumi.CustomResource):
                  insecure_skip_verify: Optional[pulumi.Input[bool]] = None,
                  keep_remotely: Optional[pulumi.Input[bool]] = None,
                  name: Optional[pulumi.Input[str]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None,
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  __props__=None):
         """
         <!-- Bug: Type and Name are switched -->
         Manages the lifecycle of docker image in a registry. You can upload images to a registry (= `docker push`) and also delete them again
 
-        ## Example Usage
-
-        Build an image with the `RemoteImage` resource and then push it to a registry:
-
-        ```python
-        import pulumi
-        import pulumi_docker as docker
-
-        helloworld = docker.RegistryImage("helloworld", keep_remotely=True)
-        image = docker.RemoteImage("image",
-            name="registry.com/somename:1.0",
-            build=docker.RemoteImageBuildArgs(
-                context=f"{path['cwd']}/absolutePathToContextFolder",
-            ))
-        ```
-
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[bool] insecure_skip_verify: If `true`, the verification of TLS certificates of the server/registry is disabled. Defaults to `false`
         :param pulumi.Input[bool] keep_remotely: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker registry on destroy operation. Defaults to `false`
         :param pulumi.Input[str] name: The name of the Docker image.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
         """
         ...
     @overload
@@ -218,22 +207,6 @@ class RegistryImage(pulumi.CustomResource):
         <!-- Bug: Type and Name are switched -->
         Manages the lifecycle of docker image in a registry. You can upload images to a registry (= `docker push`) and also delete them again
 
-        ## Example Usage
-
-        Build an image with the `RemoteImage` resource and then push it to a registry:
-
-        ```python
-        import pulumi
-        import pulumi_docker as docker
-
-        helloworld = docker.RegistryImage("helloworld", keep_remotely=True)
-        image = docker.RemoteImage("image",
-            name="registry.com/somename:1.0",
-            build=docker.RemoteImageBuildArgs(
-                context=f"{path['cwd']}/absolutePathToContextFolder",
-            ))
-        ```
-
         :param str resource_name: The name of the resource.
         :param RegistryImageArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -252,7 +225,7 @@ class RegistryImage(pulumi.CustomResource):
                  insecure_skip_verify: Optional[pulumi.Input[bool]] = None,
                  keep_remotely: Optional[pulumi.Input[bool]] = None,
                  name: Optional[pulumi.Input[str]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None,
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -281,7 +254,7 @@ class RegistryImage(pulumi.CustomResource):
             keep_remotely: Optional[pulumi.Input[bool]] = None,
             name: Optional[pulumi.Input[str]] = None,
             sha256_digest: Optional[pulumi.Input[str]] = None,
-            triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None) -> 'RegistryImage':
+            triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None) -> 'RegistryImage':
         """
         Get an existing RegistryImage resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -293,7 +266,7 @@ class RegistryImage(pulumi.CustomResource):
         :param pulumi.Input[bool] keep_remotely: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker registry on destroy operation. Defaults to `false`
         :param pulumi.Input[str] name: The name of the Docker image.
         :param pulumi.Input[str] sha256_digest: The sha256 digest of the image.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -340,7 +313,7 @@ class RegistryImage(pulumi.CustomResource):
 
     @property
     @pulumi.getter
-    def triggers(self) -> pulumi.Output[Optional[Mapping[str, Any]]]:
+    def triggers(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
         """
         A map of arbitrary strings that, when changed, will force the `RegistryImage` resource to be replaced. This can be used to repush a local image
         """

pulumi_docker/remote_image.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -22,16 +27,16 @@ class RemoteImageArgs:
                  keep_locally: Optional[pulumi.Input[bool]] = None,
                  platform: Optional[pulumi.Input[str]] = None,
                  pull_triggers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None):
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None):
         """
         The set of arguments for constructing a RemoteImage resource.
-        :param pulumi.Input[str] name: type of ulimit, e.g. `nofile`
+        :param pulumi.Input[str] name: The name of the Docker image, including any tags or SHA256 repo digests.
         :param pulumi.Input['RemoteImageBuildArgs'] build: Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
-        :param pulumi.Input[bool] force_remove: Always remove intermediate containers
+        :param pulumi.Input[bool] force_remove: If true, then the image is removed forcibly when the resource is destroyed.
         :param pulumi.Input[bool] keep_locally: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker local storage on destroy operation.
-        :param pulumi.Input[str] platform: Set platform if server is multi-platform capable
+        :param pulumi.Input[str] platform: The platform to use when pulling the image. Defaults to the platform of the current machine.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] pull_triggers: List of values which cause an image pull when changed. This is used to store the image digest from the registry when using the docker*registry*image.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
         """
         pulumi.set(__self__, "name", name)
         if build is not None:
@@ -51,7 +56,7 @@ class RemoteImageArgs:
     @pulumi.getter
     def name(self) -> pulumi.Input[str]:
         """
-        type of ulimit, e.g. `nofile`
+        The name of the Docker image, including any tags or SHA256 repo digests.
         """
         return pulumi.get(self, "name")
 
@@ -75,7 +80,7 @@ class RemoteImageArgs:
     @pulumi.getter(name="forceRemove")
     def force_remove(self) -> Optional[pulumi.Input[bool]]:
         """
-        Always remove intermediate containers
+        If true, then the image is removed forcibly when the resource is destroyed.
         """
         return pulumi.get(self, "force_remove")
 
@@ -99,7 +104,7 @@ class RemoteImageArgs:
     @pulumi.getter
     def platform(self) -> Optional[pulumi.Input[str]]:
         """
-        Set platform if server is multi-platform capable
+        The platform to use when pulling the image. Defaults to the platform of the current machine.
         """
         return pulumi.get(self, "platform")
 
@@ -121,14 +126,14 @@ class RemoteImageArgs:
 
     @property
     @pulumi.getter
-    def triggers(self) -> Optional[pulumi.Input[Mapping[str, Any]]]:
+    def triggers(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
         A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
         """
         return pulumi.get(self, "triggers")
 
     @triggers.setter
-    def triggers(self, value: Optional[pulumi.Input[Mapping[str, Any]]]):
+    def triggers(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]):
         pulumi.set(self, "triggers", value)
 
 
@@ -143,18 +148,18 @@ class _RemoteImageState:
                  platform: Optional[pulumi.Input[str]] = None,
                  pull_triggers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
                  repo_digest: Optional[pulumi.Input[str]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None):
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None):
         """
         Input properties used for looking up and filtering RemoteImage resources.
         :param pulumi.Input['RemoteImageBuildArgs'] build: Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
-        :param pulumi.Input[bool] force_remove: Always remove intermediate containers
+        :param pulumi.Input[bool] force_remove: If true, then the image is removed forcibly when the resource is destroyed.
         :param pulumi.Input[str] image_id: The ID of the image (as seen when executing `docker inspect` on the image). Can be used to reference the image via its ID in other resources.
         :param pulumi.Input[bool] keep_locally: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker local storage on destroy operation.
-        :param pulumi.Input[str] name: type of ulimit, e.g. `nofile`
-        :param pulumi.Input[str] platform: Set platform if server is multi-platform capable
+        :param pulumi.Input[str] name: The name of the Docker image, including any tags or SHA256 repo digests.
+        :param pulumi.Input[str] platform: The platform to use when pulling the image. Defaults to the platform of the current machine.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] pull_triggers: List of values which cause an image pull when changed. This is used to store the image digest from the registry when using the docker*registry*image.
         :param pulumi.Input[str] repo_digest: The image sha256 digest in the form of `repo[:tag]@sha256:<hash>`.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
         """
         if build is not None:
             pulumi.set(__self__, "build", build)
@@ -191,7 +196,7 @@ class _RemoteImageState:
     @pulumi.getter(name="forceRemove")
     def force_remove(self) -> Optional[pulumi.Input[bool]]:
         """
-        Always remove intermediate containers
+        If true, then the image is removed forcibly when the resource is destroyed.
         """
         return pulumi.get(self, "force_remove")
 
@@ -227,7 +232,7 @@ class _RemoteImageState:
     @pulumi.getter
     def name(self) -> Optional[pulumi.Input[str]]:
         """
-        type of ulimit, e.g. `nofile`
+        The name of the Docker image, including any tags or SHA256 repo digests.
         """
         return pulumi.get(self, "name")
 
@@ -239,7 +244,7 @@ class _RemoteImageState:
     @pulumi.getter
     def platform(self) -> Optional[pulumi.Input[str]]:
         """
-        Set platform if server is multi-platform capable
+        The platform to use when pulling the image. Defaults to the platform of the current machine.
         """
         return pulumi.get(self, "platform")
 
@@ -273,14 +278,14 @@ class _RemoteImageState:
 
     @property
     @pulumi.getter
-    def triggers(self) -> Optional[pulumi.Input[Mapping[str, Any]]]:
+    def triggers(self) -> Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]:
         """
         A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
         """
         return pulumi.get(self, "triggers")
 
     @triggers.setter
-    def triggers(self, value: Optional[pulumi.Input[Mapping[str, Any]]]):
+    def triggers(self, value: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]]):
         pulumi.set(self, "triggers", value)
 
 
@@ -289,13 +294,13 @@ class RemoteImage(pulumi.CustomResource):
     def __init__(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 build: Optional[pulumi.Input[pulumi.InputType['RemoteImageBuildArgs']]] = None,
+                 build: Optional[pulumi.Input[Union['RemoteImageBuildArgs', 'RemoteImageBuildArgsDict']]] = None,
                  force_remove: Optional[pulumi.Input[bool]] = None,
                  keep_locally: Optional[pulumi.Input[bool]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  platform: Optional[pulumi.Input[str]] = None,
                  pull_triggers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None,
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  __props__=None):
         """
         <!-- Bug: Type and Name are switched -->
@@ -303,6 +308,7 @@ class RemoteImage(pulumi.CustomResource):
          This resource will *not* pull new layers of the image automatically unless used in conjunction with RegistryImage data source to update the `pull_triggers` field.
 
         ## Example Usage
+
         ### Basic
 
         Finds and downloads the latest `ubuntu:precise` image but does not check
@@ -314,6 +320,7 @@ class RemoteImage(pulumi.CustomResource):
 
         ubuntu = docker.RemoteImage("ubuntu", name="ubuntu:precise")
         ```
+
         ### Dynamic updates
 
         To be able to update an image dynamically when the `sha256` sum changes,
@@ -323,21 +330,46 @@ class RemoteImage(pulumi.CustomResource):
         import pulumi
         import pulumi_docker as docker
 
-        ubuntu_registry_image = docker.get_registry_image(name="ubuntu:precise")
-        ubuntu_remote_image = docker.RemoteImage("ubuntuRemoteImage",
-            name=ubuntu_registry_image.name,
-            pull_triggers=[ubuntu_registry_image.sha256_digest])
+        ubuntu = docker.get_registry_image(name="ubuntu:precise")
+        ubuntu_remote_image = docker.RemoteImage("ubuntu",
+            name=ubuntu.name,
+            pull_triggers=[ubuntu.sha256_digest])
         ```
 
+        ### Build
+
+        You can also use the resource to build an image.
+        In this case the image "zoo" and "zoo:develop" are built.
+
+        ```python
+        import pulumi
+        import pulumi_docker as docker
+
+        zoo = docker.RemoteImage("zoo",
+            name="zoo",
+            build={
+                "context": ".",
+                "tags": ["zoo:develop"],
+                "build_arg": {
+                    "foo": "zoo",
+                },
+                "label": {
+                    "author": "zoo",
+                },
+            })
+        ```
+
+        You can use the `triggers` argument to specify when the image should be rebuild. This is for example helpful when you want to rebuild the docker image whenever the source code changes.
+
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[pulumi.InputType['RemoteImageBuildArgs']] build: Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
-        :param pulumi.Input[bool] force_remove: Always remove intermediate containers
+        :param pulumi.Input[Union['RemoteImageBuildArgs', 'RemoteImageBuildArgsDict']] build: Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
+        :param pulumi.Input[bool] force_remove: If true, then the image is removed forcibly when the resource is destroyed.
         :param pulumi.Input[bool] keep_locally: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker local storage on destroy operation.
-        :param pulumi.Input[str] name: type of ulimit, e.g. `nofile`
-        :param pulumi.Input[str] platform: Set platform if server is multi-platform capable
+        :param pulumi.Input[str] name: The name of the Docker image, including any tags or SHA256 repo digests.
+        :param pulumi.Input[str] platform: The platform to use when pulling the image. Defaults to the platform of the current machine.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] pull_triggers: List of values which cause an image pull when changed. This is used to store the image digest from the registry when using the docker*registry*image.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
         """
         ...
     @overload
@@ -351,6 +383,7 @@ class RemoteImage(pulumi.CustomResource):
          This resource will *not* pull new layers of the image automatically unless used in conjunction with RegistryImage data source to update the `pull_triggers` field.
 
         ## Example Usage
+
         ### Basic
 
         Finds and downloads the latest `ubuntu:precise` image but does not check
@@ -362,6 +395,7 @@ class RemoteImage(pulumi.CustomResource):
 
         ubuntu = docker.RemoteImage("ubuntu", name="ubuntu:precise")
         ```
+
         ### Dynamic updates
 
         To be able to update an image dynamically when the `sha256` sum changes,
@@ -371,12 +405,37 @@ class RemoteImage(pulumi.CustomResource):
         import pulumi
         import pulumi_docker as docker
 
-        ubuntu_registry_image = docker.get_registry_image(name="ubuntu:precise")
-        ubuntu_remote_image = docker.RemoteImage("ubuntuRemoteImage",
-            name=ubuntu_registry_image.name,
-            pull_triggers=[ubuntu_registry_image.sha256_digest])
+        ubuntu = docker.get_registry_image(name="ubuntu:precise")
+        ubuntu_remote_image = docker.RemoteImage("ubuntu",
+            name=ubuntu.name,
+            pull_triggers=[ubuntu.sha256_digest])
         ```
 
+        ### Build
+
+        You can also use the resource to build an image.
+        In this case the image "zoo" and "zoo:develop" are built.
+
+        ```python
+        import pulumi
+        import pulumi_docker as docker
+
+        zoo = docker.RemoteImage("zoo",
+            name="zoo",
+            build={
+                "context": ".",
+                "tags": ["zoo:develop"],
+                "build_arg": {
+                    "foo": "zoo",
+                },
+                "label": {
+                    "author": "zoo",
+                },
+            })
+        ```
+
+        You can use the `triggers` argument to specify when the image should be rebuild. This is for example helpful when you want to rebuild the docker image whenever the source code changes.
+
         :param str resource_name: The name of the resource.
         :param RemoteImageArgs args: The arguments to use to populate this resource's properties.
         :param pulumi.ResourceOptions opts: Options for the resource.
@@ -392,13 +451,13 @@ class RemoteImage(pulumi.CustomResource):
     def _internal_init(__self__,
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
-                 build: Optional[pulumi.Input[pulumi.InputType['RemoteImageBuildArgs']]] = None,
+                 build: Optional[pulumi.Input[Union['RemoteImageBuildArgs', 'RemoteImageBuildArgsDict']]] = None,
                  force_remove: Optional[pulumi.Input[bool]] = None,
                  keep_locally: Optional[pulumi.Input[bool]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  platform: Optional[pulumi.Input[str]] = None,
                  pull_triggers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
-                 triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None,
+                 triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
         if not isinstance(opts, pulumi.ResourceOptions):
@@ -429,7 +488,7 @@ class RemoteImage(pulumi.CustomResource):
     def get(resource_name: str,
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
-            build: Optional[pulumi.Input[pulumi.InputType['RemoteImageBuildArgs']]] = None,
+            build: Optional[pulumi.Input[Union['RemoteImageBuildArgs', 'RemoteImageBuildArgsDict']]] = None,
             force_remove: Optional[pulumi.Input[bool]] = None,
             image_id: Optional[pulumi.Input[str]] = None,
             keep_locally: Optional[pulumi.Input[bool]] = None,
@@ -437,7 +496,7 @@ class RemoteImage(pulumi.CustomResource):
             platform: Optional[pulumi.Input[str]] = None,
             pull_triggers: Optional[pulumi.Input[Sequence[pulumi.Input[str]]]] = None,
             repo_digest: Optional[pulumi.Input[str]] = None,
-            triggers: Optional[pulumi.Input[Mapping[str, Any]]] = None) -> 'RemoteImage':
+            triggers: Optional[pulumi.Input[Mapping[str, pulumi.Input[str]]]] = None) -> 'RemoteImage':
         """
         Get an existing RemoteImage resource's state with the given name, id, and optional extra
         properties used to qualify the lookup.
@@ -445,15 +504,15 @@ class RemoteImage(pulumi.CustomResource):
         :param str resource_name: The unique name of the resulting resource.
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
-        :param pulumi.Input[pulumi.InputType['RemoteImageBuildArgs']] build: Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
-        :param pulumi.Input[bool] force_remove: Always remove intermediate containers
+        :param pulumi.Input[Union['RemoteImageBuildArgs', 'RemoteImageBuildArgsDict']] build: Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
+        :param pulumi.Input[bool] force_remove: If true, then the image is removed forcibly when the resource is destroyed.
         :param pulumi.Input[str] image_id: The ID of the image (as seen when executing `docker inspect` on the image). Can be used to reference the image via its ID in other resources.
         :param pulumi.Input[bool] keep_locally: If true, then the Docker image won't be deleted on destroy operation. If this is false, it will delete the image from the docker local storage on destroy operation.
-        :param pulumi.Input[str] name: type of ulimit, e.g. `nofile`
-        :param pulumi.Input[str] platform: Set platform if server is multi-platform capable
+        :param pulumi.Input[str] name: The name of the Docker image, including any tags or SHA256 repo digests.
+        :param pulumi.Input[str] platform: The platform to use when pulling the image. Defaults to the platform of the current machine.
         :param pulumi.Input[Sequence[pulumi.Input[str]]] pull_triggers: List of values which cause an image pull when changed. This is used to store the image digest from the registry when using the docker*registry*image.
         :param pulumi.Input[str] repo_digest: The image sha256 digest in the form of `repo[:tag]@sha256:<hash>`.
-        :param pulumi.Input[Mapping[str, Any]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
+        :param pulumi.Input[Mapping[str, pulumi.Input[str]]] triggers: A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))
 
@@ -482,7 +541,7 @@ class RemoteImage(pulumi.CustomResource):
     @pulumi.getter(name="forceRemove")
     def force_remove(self) -> pulumi.Output[Optional[bool]]:
         """
-        Always remove intermediate containers
+        If true, then the image is removed forcibly when the resource is destroyed.
         """
         return pulumi.get(self, "force_remove")
 
@@ -506,7 +565,7 @@ class RemoteImage(pulumi.CustomResource):
     @pulumi.getter
     def name(self) -> pulumi.Output[str]:
         """
-        type of ulimit, e.g. `nofile`
+        The name of the Docker image, including any tags or SHA256 repo digests.
         """
         return pulumi.get(self, "name")
 
@@ -514,7 +573,7 @@ class RemoteImage(pulumi.CustomResource):
     @pulumi.getter
     def platform(self) -> pulumi.Output[Optional[str]]:
         """
-        Set platform if server is multi-platform capable
+        The platform to use when pulling the image. Defaults to the platform of the current machine.
         """
         return pulumi.get(self, "platform")
 
@@ -536,7 +595,7 @@ class RemoteImage(pulumi.CustomResource):
 
     @property
     @pulumi.getter
-    def triggers(self) -> pulumi.Output[Optional[Mapping[str, Any]]]:
+    def triggers(self) -> pulumi.Output[Optional[Mapping[str, str]]]:
         """
         A map of arbitrary strings that, when changed, will force the `RemoteImage` resource to be replaced. This can be used to rebuild an image when contents of source code folders change
         """

pulumi_docker/secret.py

@@ -4,9 +4,14 @@
 
 import copy
 import warnings
+import sys
 import pulumi
 import pulumi.runtime
 from typing import Any, Mapping, Optional, Sequence, Union, overload
+if sys.version_info >= (3, 11):
+    from typing import NotRequired, TypedDict, TypeAlias
+else:
+    from typing_extensions import NotRequired, TypedDict, TypeAlias
 from . import _utilities
 from . import outputs
 from ._inputs import *
@@ -130,18 +135,20 @@ class Secret(pulumi.CustomResource):
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  data: Optional[pulumi.Input[str]] = None,
-                 labels: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['SecretLabelArgs']]]]] = None,
+                 labels: Optional[pulumi.Input[Sequence[pulumi.Input[Union['SecretLabelArgs', 'SecretLabelArgsDict']]]]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         """
         ## Import
 
-        #!/bin/bash Docker secret cannot be imported as the secret data, once set, is never exposed again.
+        #!/bin/bash
+
+        Docker secret cannot be imported as the secret data, once set, is never exposed again.
 
         :param str resource_name: The name of the resource.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] data: Base64-url-safe-encoded secret data
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['SecretLabelArgs']]]] labels: User-defined key/value metadata
+        :param pulumi.Input[Sequence[pulumi.Input[Union['SecretLabelArgs', 'SecretLabelArgsDict']]]] labels: User-defined key/value metadata
         :param pulumi.Input[str] name: User-defined name of the secret
         """
         ...
@@ -153,7 +160,9 @@ class Secret(pulumi.CustomResource):
         """
         ## Import
 
-        #!/bin/bash Docker secret cannot be imported as the secret data, once set, is never exposed again.
+        #!/bin/bash
+
+        Docker secret cannot be imported as the secret data, once set, is never exposed again.
 
         :param str resource_name: The name of the resource.
         :param SecretArgs args: The arguments to use to populate this resource's properties.
@@ -171,7 +180,7 @@ class Secret(pulumi.CustomResource):
                  resource_name: str,
                  opts: Optional[pulumi.ResourceOptions] = None,
                  data: Optional[pulumi.Input[str]] = None,
-                 labels: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['SecretLabelArgs']]]]] = None,
+                 labels: Optional[pulumi.Input[Sequence[pulumi.Input[Union['SecretLabelArgs', 'SecretLabelArgsDict']]]]] = None,
                  name: Optional[pulumi.Input[str]] = None,
                  __props__=None):
         opts = pulumi.ResourceOptions.merge(_utilities.get_resource_opts_defaults(), opts)
@@ -200,7 +209,7 @@ class Secret(pulumi.CustomResource):
             id: pulumi.Input[str],
             opts: Optional[pulumi.ResourceOptions] = None,
             data: Optional[pulumi.Input[str]] = None,
-            labels: Optional[pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['SecretLabelArgs']]]]] = None,
+            labels: Optional[pulumi.Input[Sequence[pulumi.Input[Union['SecretLabelArgs', 'SecretLabelArgsDict']]]]] = None,
             name: Optional[pulumi.Input[str]] = None) -> 'Secret':
         """
         Get an existing Secret resource's state with the given name, id, and optional extra
@@ -210,7 +219,7 @@ class Secret(pulumi.CustomResource):
         :param pulumi.Input[str] id: The unique provider ID of the resource to lookup.
         :param pulumi.ResourceOptions opts: Options for the resource.
         :param pulumi.Input[str] data: Base64-url-safe-encoded secret data
-        :param pulumi.Input[Sequence[pulumi.Input[pulumi.InputType['SecretLabelArgs']]]] labels: User-defined key/value metadata
+        :param pulumi.Input[Sequence[pulumi.Input[Union['SecretLabelArgs', 'SecretLabelArgsDict']]]] labels: User-defined key/value metadata
         :param pulumi.Input[str] name: User-defined name of the secret
         """
         opts = pulumi.ResourceOptions.merge(opts, pulumi.ResourceOptions(id=id))