# DockerImageAsset

A file asset.

- Source: [`node_modules/@aws-cdk/cloud-assembly-schema/lib/assets/docker-image-asset.d.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/node_modules/@aws-cdk/cloud-assembly-schema/lib/assets/docker-image-asset.d.ts#L5)
- Type last changed: v2.187.0 · 31 Mar 2025

## Example

```ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { cloud_assembly_schema } from 'aws-cdk-lib';

declare const assumeRoleAdditionalOptions: any;
const dockerImageAsset: cloud_assembly_schema.DockerImageAsset = {
  destinations: {
    destinationsKey: {
      imageTag: 'imageTag',
      repositoryName: 'repositoryName',

      // the properties below are optional
      assumeRoleAdditionalOptions: {
        assumeRoleAdditionalOptionsKey: assumeRoleAdditionalOptions,
      },
      assumeRoleArn: 'assumeRoleArn',
      assumeRoleExternalId: 'assumeRoleExternalId',
      region: 'region',
    },
  },
  source: {
    cacheDisabled: false,
    cacheFrom: [{
      type: 'type',

      // the properties below are optional
      params: {
        paramsKey: 'params',
      },
    }],
    cacheTo: {
      type: 'type',

      // the properties below are optional
      params: {
        paramsKey: 'params',
      },
    },
    directory: 'directory',
    dockerBuildArgs: {
      dockerBuildArgsKey: 'dockerBuildArgs',
    },
    dockerBuildContexts: {
      dockerBuildContextsKey: 'dockerBuildContexts',
    },
    dockerBuildSecrets: {
      dockerBuildSecretsKey: 'dockerBuildSecrets',
    },
    dockerBuildSsh: 'dockerBuildSsh',
    dockerBuildTarget: 'dockerBuildTarget',
    dockerFile: 'dockerFile',
    dockerOutputs: ['dockerOutputs'],
    executable: ['executable'],
    networkMode: 'networkMode',
    platform: 'platform',
  },

  // the properties below are optional
  displayName: 'displayName',
};
```

## Properties

- `destinations`: { [key: string]: [DockerImageDestination](/cdk/api/v2/docs/aws-cdk-lib.cloud_assembly_schema.DockerImageDestination.html) } (required) — Destinations for this container asset.

- `displayName`: string — A display name for this asset.

  **Default:** The identifier will be used as the display name

- `source`: [DockerImageSource](/cdk/api/v2/docs/aws-cdk-lib.cloud_assembly_schema.DockerImageSource.html) (required) — Source description for container assets.