@pulumi/docker 3.1.0-alpha.1626976245 → 3.1.0

package/remoteImage.d.ts

@@ -1,24 +1,28 @@
 import * as pulumi from "@pulumi/pulumi";
 import { input as inputs, output as outputs } from "./types";
 /**
+ * <!-- Bug: Type and Name are switched -->
  * Pulls a Docker image to a given Docker host from a Docker Registry.
- *
- * This resource will *not* pull new layers of the image automatically unless used in
- * conjunction with [`docker.RegistryImage`](https://www.terraform.io/docs/providers/docker/d/registry_image.html)
- * data source to update the `pullTriggers` field.
+ *  This resource will *not* pull new layers of the image automatically unless used in conjunction with docker.RegistryImage data source to update the `pullTriggers` field.
  *
  * ## Example Usage
+ * ### Basic
+ *
+ * Finds and downloads the latest `ubuntu:precise` image but does not check
+ * for further updates of the image
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
  * import * as docker from "@pulumi/docker";
  *
- * // Find the latest Ubuntu precise image.
  * const ubuntu = new docker.RemoteImage("ubuntu", {
  *     name: "ubuntu:precise",
  * });
  * ```
- * ### Dynamic image
+ * ### Dynamic updates
+ *
+ * To be able to update an image dynamically when the `sha256` sum changes,
+ * you need to use it in combination with `docker.RegistryImage` as follows:
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
@@ -32,6 +36,69 @@ import { input as inputs, output as outputs } from "./types";
  *     pullTriggers: [ubuntuRegistryImage.then(ubuntuRegistryImage => ubuntuRegistryImage.sha256Digest)],
  * });
  * ```
+ * ### Build
+ *
+ * You can also use the resource to build an image.
+ * In this case the image "zoo" and "zoo:develop" are built.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as docker from "@pulumi/docker";
+ *
+ * const zoo = new docker.RemoteImage("zoo", {
+ *     name: "zoo",
+ *     build: {
+ *         path: ".",
+ *         tags: ["zoo:develop"],
+ *         buildArg: {
+ *             foo: "zoo",
+ *         },
+ *         label: {
+ *             author: "zoo",
+ *         },
+ *     },
+ * });
+ * ```
+ *
+ * <!-- schema generated by tfplugindocs -->
+ * ## Schema
+ *
+ * ### Required
+ *
+ * - **name** (String) The name of the Docker image, including any tags or SHA256 repo digests.
+ *
+ * ### Optional
+ *
+ * - **build** (Block Set, Max: 1) Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too. (see below for nested schema)
+ * - **force_remove** (Boolean) If true, then the image is removed forcibly when the resource is destroyed.
+ * - **id** (String) The ID of this resource.
+ * - **keep_locally** (Boolean) 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.
+ * - **pull_trigger** (String, Deprecated) A value which cause an image pull when changed
+ * - **pull_triggers** (Set of String) 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.
+ *
+ * ### Read-Only
+ *
+ * - **latest** (String, Deprecated) The ID of the image in the form of `sha256:<hash>` image digest. Do not confuse it with the default `latest` tag.
+ * - **output** (String, Deprecated)
+ * - **repo_digest** (String) The image sha256 digest in the form of `repo[:tag]@sha256:<hash>`.
+ *
+ * <a id="nestedblock--build"></a>
+ * ### Nested Schema for `build`
+ *
+ * Required:
+ *
+ * - **path** (String) Context path
+ *
+ * Optional:
+ *
+ * - **build_arg** (Map of String) Set build-time variables
+ * - **dockerfile** (String) Name of the Dockerfile. Defaults to `Dockerfile`.
+ * - **force_remove** (Boolean) Always remove intermediate containers
+ * - **label** (Map of String) Set metadata for an image
+ * - **no_cache** (Boolean) Do not use cache when building the image
+ * - **remove** (Boolean) Remove intermediate containers after a successful build. Defaults to  `true`.
+ * - **tag** (List of String) Name and optionally a tag in the 'name:tag' format
+ * - **target** (String) Set the target build stage to build
  */
 export declare class RemoteImage extends pulumi.CustomResource {
     /**
@@ -50,38 +117,48 @@ export declare class RemoteImage extends pulumi.CustomResource {
      */
     static isInstance(obj: any): obj is RemoteImage;
     /**
-     * See Build below for details.
+     * Configuration to build an image. Please see [docker build command
+     * reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
      */
     readonly build: pulumi.Output<outputs.RemoteImageBuild | undefined>;
     /**
-     * Force remove the image when the resource is destroyed
+     * If true, then the image is removed forcibly when the resource is destroyed.
      */
     readonly forceRemove: pulumi.Output<boolean | undefined>;
     /**
-     * If true, then the Docker image won't be
-     * deleted on destroy operation. If this is false, it will delete the image from
+     * 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.
      */
     readonly keepLocally: pulumi.Output<boolean | undefined>;
+    /**
+     * The ID of the image in the form of `sha256:<hash>` image digest. Do not confuse it with the default `latest` tag.
+     *
+     * @deprecated Use repo_digest instead
+     */
     readonly latest: pulumi.Output<string>;
     /**
      * The name of the Docker image, including any tags or SHA256 repo digests.
      */
     readonly name: pulumi.Output<string>;
+    /**
+     * @deprecated Is unused and will be removed.
+     */
     readonly output: pulumi.Output<string>;
     /**
-     * **Deprecated**, use `pullTriggers` instead.
+     * A value which cause an image pull when changed
      *
      * @deprecated Use field pull_triggers instead
      */
     readonly pullTrigger: pulumi.Output<string | undefined>;
     /**
-     * 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.RegistryImage` [data source](https://www.terraform.io/docs/providers/docker/d/registry_image.html)
-     * to trigger an image update.
+     * 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](../data-sources/registry_image.md).
      */
     readonly pullTriggers: pulumi.Output<string[] | undefined>;
+    /**
+     * The image sha256 digest in the form of `repo[:tag]@sha256:<hash>`.
+     */
+    readonly repoDigest: pulumi.Output<string>;
     /**
      * Create a RemoteImage resource with the given unique name, arguments, and options.
      *
@@ -96,54 +173,64 @@ export declare class RemoteImage extends pulumi.CustomResource {
  */
 export interface RemoteImageState {
     /**
-     * See Build below for details.
+     * Configuration to build an image. Please see [docker build command
+     * reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
      */
     readonly build?: pulumi.Input<inputs.RemoteImageBuild>;
     /**
-     * Force remove the image when the resource is destroyed
+     * If true, then the image is removed forcibly when the resource is destroyed.
      */
     readonly forceRemove?: pulumi.Input<boolean>;
     /**
-     * If true, then the Docker image won't be
-     * deleted on destroy operation. If this is false, it will delete the image from
+     * 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.
      */
     readonly keepLocally?: pulumi.Input<boolean>;
+    /**
+     * The ID of the image in the form of `sha256:<hash>` image digest. Do not confuse it with the default `latest` tag.
+     *
+     * @deprecated Use repo_digest instead
+     */
     readonly latest?: pulumi.Input<string>;
     /**
      * The name of the Docker image, including any tags or SHA256 repo digests.
      */
     readonly name?: pulumi.Input<string>;
+    /**
+     * @deprecated Is unused and will be removed.
+     */
     readonly output?: pulumi.Input<string>;
     /**
-     * **Deprecated**, use `pullTriggers` instead.
+     * A value which cause an image pull when changed
      *
      * @deprecated Use field pull_triggers instead
      */
     readonly pullTrigger?: pulumi.Input<string>;
     /**
-     * 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.RegistryImage` [data source](https://www.terraform.io/docs/providers/docker/d/registry_image.html)
-     * to trigger an image update.
+     * 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](../data-sources/registry_image.md).
      */
     readonly pullTriggers?: pulumi.Input<pulumi.Input<string>[]>;
+    /**
+     * The image sha256 digest in the form of `repo[:tag]@sha256:<hash>`.
+     */
+    readonly repoDigest?: pulumi.Input<string>;
 }
 /**
  * The set of arguments for constructing a RemoteImage resource.
  */
 export interface RemoteImageArgs {
     /**
-     * See Build below for details.
+     * Configuration to build an image. Please see [docker build command
+     * reference](https://docs.docker.com/engine/reference/commandline/build/#options) too.
      */
     readonly build?: pulumi.Input<inputs.RemoteImageBuild>;
     /**
-     * Force remove the image when the resource is destroyed
+     * If true, then the image is removed forcibly when the resource is destroyed.
      */
     readonly forceRemove?: pulumi.Input<boolean>;
     /**
-     * If true, then the Docker image won't be
-     * deleted on destroy operation. If this is false, it will delete the image from
+     * 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.
      */
     readonly keepLocally?: pulumi.Input<boolean>;
@@ -152,16 +239,14 @@ export interface RemoteImageArgs {
      */
     readonly name: pulumi.Input<string>;
     /**
-     * **Deprecated**, use `pullTriggers` instead.
+     * A value which cause an image pull when changed
      *
      * @deprecated Use field pull_triggers instead
      */
     readonly pullTrigger?: pulumi.Input<string>;
     /**
-     * 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.RegistryImage` [data source](https://www.terraform.io/docs/providers/docker/d/registry_image.html)
-     * to trigger an image update.
+     * 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](../data-sources/registry_image.md).
      */
     readonly pullTriggers?: pulumi.Input<pulumi.Input<string>[]>;
 }

package/remoteImage.js

@@ -5,24 +5,28 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const pulumi = require("@pulumi/pulumi");
 const utilities = require("./utilities");
 /**
+ * <!-- Bug: Type and Name are switched -->
  * Pulls a Docker image to a given Docker host from a Docker Registry.
- *
- * This resource will *not* pull new layers of the image automatically unless used in
- * conjunction with [`docker.RegistryImage`](https://www.terraform.io/docs/providers/docker/d/registry_image.html)
- * data source to update the `pullTriggers` field.
+ *  This resource will *not* pull new layers of the image automatically unless used in conjunction with docker.RegistryImage data source to update the `pullTriggers` field.
  *
  * ## Example Usage
+ * ### Basic
+ *
+ * Finds and downloads the latest `ubuntu:precise` image but does not check
+ * for further updates of the image
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
  * import * as docker from "@pulumi/docker";
  *
- * // Find the latest Ubuntu precise image.
  * const ubuntu = new docker.RemoteImage("ubuntu", {
  *     name: "ubuntu:precise",
  * });
  * ```
- * ### Dynamic image
+ * ### Dynamic updates
+ *
+ * To be able to update an image dynamically when the `sha256` sum changes,
+ * you need to use it in combination with `docker.RegistryImage` as follows:
  *
  * ```typescript
  * import * as pulumi from "@pulumi/pulumi";
@@ -36,6 +40,69 @@ const utilities = require("./utilities");
  *     pullTriggers: [ubuntuRegistryImage.then(ubuntuRegistryImage => ubuntuRegistryImage.sha256Digest)],
  * });
  * ```
+ * ### Build
+ *
+ * You can also use the resource to build an image.
+ * In this case the image "zoo" and "zoo:develop" are built.
+ *
+ * ```typescript
+ * import * as pulumi from "@pulumi/pulumi";
+ * import * as docker from "@pulumi/docker";
+ *
+ * const zoo = new docker.RemoteImage("zoo", {
+ *     name: "zoo",
+ *     build: {
+ *         path: ".",
+ *         tags: ["zoo:develop"],
+ *         buildArg: {
+ *             foo: "zoo",
+ *         },
+ *         label: {
+ *             author: "zoo",
+ *         },
+ *     },
+ * });
+ * ```
+ *
+ * <!-- schema generated by tfplugindocs -->
+ * ## Schema
+ *
+ * ### Required
+ *
+ * - **name** (String) The name of the Docker image, including any tags or SHA256 repo digests.
+ *
+ * ### Optional
+ *
+ * - **build** (Block Set, Max: 1) Configuration to build an image. Please see [docker build command reference](https://docs.docker.com/engine/reference/commandline/build/#options) too. (see below for nested schema)
+ * - **force_remove** (Boolean) If true, then the image is removed forcibly when the resource is destroyed.
+ * - **id** (String) The ID of this resource.
+ * - **keep_locally** (Boolean) 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.
+ * - **pull_trigger** (String, Deprecated) A value which cause an image pull when changed
+ * - **pull_triggers** (Set of String) 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.
+ *
+ * ### Read-Only
+ *
+ * - **latest** (String, Deprecated) The ID of the image in the form of `sha256:<hash>` image digest. Do not confuse it with the default `latest` tag.
+ * - **output** (String, Deprecated)
+ * - **repo_digest** (String) The image sha256 digest in the form of `repo[:tag]@sha256:<hash>`.
+ *
+ * <a id="nestedblock--build"></a>
+ * ### Nested Schema for `build`
+ *
+ * Required:
+ *
+ * - **path** (String) Context path
+ *
+ * Optional:
+ *
+ * - **build_arg** (Map of String) Set build-time variables
+ * - **dockerfile** (String) Name of the Dockerfile. Defaults to `Dockerfile`.
+ * - **force_remove** (Boolean) Always remove intermediate containers
+ * - **label** (Map of String) Set metadata for an image
+ * - **no_cache** (Boolean) Do not use cache when building the image
+ * - **remove** (Boolean) Remove intermediate containers after a successful build. Defaults to  `true`.
+ * - **tag** (List of String) Name and optionally a tag in the 'name:tag' format
+ * - **target** (String) Set the target build stage to build
  */
 class RemoteImage extends pulumi.CustomResource {
     constructor(name, argsOrState, opts) {
@@ -51,6 +118,7 @@ class RemoteImage extends pulumi.CustomResource {
             inputs["output"] = state ? state.output : undefined;
             inputs["pullTrigger"] = state ? state.pullTrigger : undefined;
             inputs["pullTriggers"] = state ? state.pullTriggers : undefined;
+            inputs["repoDigest"] = state ? state.repoDigest : undefined;
         }
         else {
             const args = argsOrState;
@@ -65,6 +133,7 @@ class RemoteImage extends pulumi.CustomResource {
             inputs["pullTriggers"] = args ? args.pullTriggers : undefined;
             inputs["latest"] = undefined /*out*/;
             inputs["output"] = undefined /*out*/;
+            inputs["repoDigest"] = undefined /*out*/;
         }
         if (!opts.version) {
             opts = pulumi.mergeOptions(opts, { version: utilities.getVersion() });

package/remoteImage.js.map

@@ -1 +1 @@
-{"version":3,"file":"remoteImage.js","sourceRoot":"","sources":["../remoteImage.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"remoteImage.js","sourceRoot":"","sources":["../remoteImage.ts"],"names":[],"mappings":"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"}

package/secret.d.ts

@@ -3,7 +3,7 @@ import { input as inputs, output as outputs } from "./types";
 /**
  * ## Import
  *
- * Docker secret cannot be imported as the secret data, once set, is never exposed again.
+ * Import is supported using the following syntax#!/bin/bash # Docker secret cannot be imported as the secret data, once set, is never exposed again.
  */
 export declare class Secret extends pulumi.CustomResource {
     /**
@@ -22,15 +22,15 @@ export declare class Secret extends pulumi.CustomResource {
      */
     static isInstance(obj: any): obj is Secret;
     /**
-     * The base64 encoded data of the secret.
+     * Base64-url-safe-encoded secret data
      */
     readonly data: pulumi.Output<string>;
     /**
-     * See Labels below for details.
+     * User-defined key/value metadata
      */
     readonly labels: pulumi.Output<outputs.SecretLabel[] | undefined>;
     /**
-     * The name of the Docker secret.
+     * User-defined name of the secret
      */
     readonly name: pulumi.Output<string>;
     /**
@@ -47,15 +47,15 @@ export declare class Secret extends pulumi.CustomResource {
  */
 export interface SecretState {
     /**
-     * The base64 encoded data of the secret.
+     * Base64-url-safe-encoded secret data
      */
     readonly data?: pulumi.Input<string>;
     /**
-     * See Labels below for details.
+     * User-defined key/value metadata
      */
     readonly labels?: pulumi.Input<pulumi.Input<inputs.SecretLabel>[]>;
     /**
-     * The name of the Docker secret.
+     * User-defined name of the secret
      */
     readonly name?: pulumi.Input<string>;
 }
@@ -64,15 +64,15 @@ export interface SecretState {
  */
 export interface SecretArgs {
     /**
-     * The base64 encoded data of the secret.
+     * Base64-url-safe-encoded secret data
      */
     readonly data: pulumi.Input<string>;
     /**
-     * See Labels below for details.
+     * User-defined key/value metadata
      */
     readonly labels?: pulumi.Input<pulumi.Input<inputs.SecretLabel>[]>;
     /**
-     * The name of the Docker secret.
+     * User-defined name of the secret
      */
     readonly name?: pulumi.Input<string>;
 }

package/secret.js

@@ -7,7 +7,7 @@ const utilities = require("./utilities");
 /**
  * ## Import
  *
- * Docker secret cannot be imported as the secret data, once set, is never exposed again.
+ * Import is supported using the following syntax#!/bin/bash # Docker secret cannot be imported as the secret data, once set, is never exposed again.
  */
 class Secret extends pulumi.CustomResource {
     constructor(name, argsOrState, opts) {

package/service.d.ts

@@ -3,10 +3,36 @@ import { input as inputs, output as outputs } from "./types";
 /**
  * ## Import
  *
- * Docker service can be imported using the long id, e.g. for a service with the short id `55ba873dd`
+ * ### Example Assuming you created a `service` as follows #!/bin/bash docker service create --name foo -p 8080:80 nginx # prints th ID 4pcphbxkfn2rffhbhe6czytgi you provide the definition for the resource as follows terraform resource "docker_service" "foo" {
+ *
+ *  name = "foo"
+ *
+ *  task_spec {
+ *
+ *  container_spec {
+ *
+ *  image = "nginx"
+ *
+ *  }
+ *
+ *  }
+ *
+ *  endpoint_spec {
+ *
+ *  ports {
+ *
+ *  target_port
+ *
+ * = "80"
+ *
+ *  published_port = "8080"
+ *
+ *  }
+ *
+ *  } } then the import command is as follows #!/bin/bash
  *
  * ```sh
- *  $ pulumi import docker:index/service:Service foo $(docker service inspect -f {{.ID}} 55b)
+ *  $ pulumi import docker:index/service:Service foo 4pcphbxkfn2rffhbhe6czytgi
  * ```
  */
 export declare class Service extends pulumi.CustomResource {
@@ -26,39 +52,39 @@ export declare class Service extends pulumi.CustomResource {
      */
     static isInstance(obj: any): obj is Service;
     /**
-     * See Auth below for details.
+     * Configuration for the authentication for pulling the images of the service
      */
     readonly auth: pulumi.Output<outputs.ServiceAuth | undefined>;
     /**
-     * See Converge Config below for details.
+     * A configuration to ensure that a service converges aka reaches the desired that of all task up and running
      */
     readonly convergeConfig: pulumi.Output<outputs.ServiceConvergeConfig | undefined>;
     /**
-     * See EndpointSpec below for details.
+     * Properties that can be configured to access and load balance a service
      */
     readonly endpointSpec: pulumi.Output<outputs.ServiceEndpointSpec>;
     /**
-     * See Labels below for details.
+     * User-defined key/value metadata
      */
     readonly labels: pulumi.Output<outputs.ServiceLabel[]>;
     /**
-     * See Mode below for details.
+     * Scheduling mode for the service
      */
     readonly mode: pulumi.Output<outputs.ServiceMode>;
     /**
-     * The name of the Docker service.
+     * Name of the service
      */
     readonly name: pulumi.Output<string>;
     /**
-     * See RollbackConfig below for details.
+     * Specification for the rollback strategy of the service
      */
     readonly rollbackConfig: pulumi.Output<outputs.ServiceRollbackConfig | undefined>;
     /**
-     * See TaskSpec below for details.
+     * User modifiable task configuration
      */
     readonly taskSpec: pulumi.Output<outputs.ServiceTaskSpec>;
     /**
-     * See UpdateConfig below for details.
+     * Specification for the update strategy of the service
      */
     readonly updateConfig: pulumi.Output<outputs.ServiceUpdateConfig | undefined>;
     /**
@@ -75,39 +101,39 @@ export declare class Service extends pulumi.CustomResource {
  */
 export interface ServiceState {
     /**
-     * See Auth below for details.
+     * Configuration for the authentication for pulling the images of the service
      */
     readonly auth?: pulumi.Input<inputs.ServiceAuth>;
     /**
-     * See Converge Config below for details.
+     * A configuration to ensure that a service converges aka reaches the desired that of all task up and running
      */
     readonly convergeConfig?: pulumi.Input<inputs.ServiceConvergeConfig>;
     /**
-     * See EndpointSpec below for details.
+     * Properties that can be configured to access and load balance a service
      */
     readonly endpointSpec?: pulumi.Input<inputs.ServiceEndpointSpec>;
     /**
-     * See Labels below for details.
+     * User-defined key/value metadata
      */
     readonly labels?: pulumi.Input<pulumi.Input<inputs.ServiceLabel>[]>;
     /**
-     * See Mode below for details.
+     * Scheduling mode for the service
      */
     readonly mode?: pulumi.Input<inputs.ServiceMode>;
     /**
-     * The name of the Docker service.
+     * Name of the service
      */
     readonly name?: pulumi.Input<string>;
     /**
-     * See RollbackConfig below for details.
+     * Specification for the rollback strategy of the service
      */
     readonly rollbackConfig?: pulumi.Input<inputs.ServiceRollbackConfig>;
     /**
-     * See TaskSpec below for details.
+     * User modifiable task configuration
      */
     readonly taskSpec?: pulumi.Input<inputs.ServiceTaskSpec>;
     /**
-     * See UpdateConfig below for details.
+     * Specification for the update strategy of the service
      */
     readonly updateConfig?: pulumi.Input<inputs.ServiceUpdateConfig>;
 }
@@ -116,39 +142,39 @@ export interface ServiceState {
  */
 export interface ServiceArgs {
     /**
-     * See Auth below for details.
+     * Configuration for the authentication for pulling the images of the service
      */
     readonly auth?: pulumi.Input<inputs.ServiceAuth>;
     /**
-     * See Converge Config below for details.
+     * A configuration to ensure that a service converges aka reaches the desired that of all task up and running
      */
     readonly convergeConfig?: pulumi.Input<inputs.ServiceConvergeConfig>;
     /**
-     * See EndpointSpec below for details.
+     * Properties that can be configured to access and load balance a service
      */
     readonly endpointSpec?: pulumi.Input<inputs.ServiceEndpointSpec>;
     /**
-     * See Labels below for details.
+     * User-defined key/value metadata
      */
     readonly labels?: pulumi.Input<pulumi.Input<inputs.ServiceLabel>[]>;
     /**
-     * See Mode below for details.
+     * Scheduling mode for the service
      */
     readonly mode?: pulumi.Input<inputs.ServiceMode>;
     /**
-     * The name of the Docker service.
+     * Name of the service
      */
     readonly name?: pulumi.Input<string>;
     /**
-     * See RollbackConfig below for details.
+     * Specification for the rollback strategy of the service
      */
     readonly rollbackConfig?: pulumi.Input<inputs.ServiceRollbackConfig>;
     /**
-     * See TaskSpec below for details.
+     * User modifiable task configuration
      */
     readonly taskSpec: pulumi.Input<inputs.ServiceTaskSpec>;
     /**
-     * See UpdateConfig below for details.
+     * Specification for the update strategy of the service
      */
     readonly updateConfig?: pulumi.Input<inputs.ServiceUpdateConfig>;
 }