AWS CDK Reference

Appearance

v2.275.0

RepositoryImage Class ​

An image hosted in a public or private repository.

For images hosted in Amazon ECR, see EcrImage.

Source
aws-ecs/lib/images/repository.ts

Example ​

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

declare const dockerImageAsset: ecr_assets.DockerImageAsset;
const repositoryImage = ecs.RepositoryImage.fromDockerImageAsset(dockerImageAsset);
python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
from aws_cdk import aws_ecr_assets as ecr_assets
from aws_cdk import aws_ecs as ecs

# docker_image_asset: ecr_assets.DockerImageAsset

repository_image = ecs.RepositoryImage.from_docker_image_asset(docker_image_asset)
java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.services.ecr.assets.*;
import software.amazon.awscdk.services.ecs.*;

DockerImageAsset dockerImageAsset;

ContainerImage repositoryImage = RepositoryImage.fromDockerImageAsset(dockerImageAsset);
csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK.AWS.Ecr.Assets;
using Amazon.CDK.AWS.ECS;

DockerImageAsset dockerImageAsset;

var repositoryImage = RepositoryImage.FromDockerImageAsset(dockerImageAsset);
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"

var dockerImageAsset DockerImageAsset

repositoryImage := awscdk.Aws_ecs.RepositoryImage_FromDockerImageAsset(dockerImageAsset)

Initializer ​

ts
new RepositoryImage(imageName: string, props?: RepositoryImageProps)
python
RepositoryImage(image_name: str, props: typing.Optional[RepositoryImageProps] = None)
java
new RepositoryImage(String imageName, RepositoryImageProps props)
csharp
new RepositoryImage(string imageName, RepositoryImageProps? props = null)
go
NewRepositoryImage(ImageName *string, Props RepositoryImageProps)

Methods ​

bind(scope: Construct, containerDefinition: ContainerDefinition): ContainerImageConfigdef bind(self, scope: Construct, container_definition: ContainerDefinition) -> ContainerImageConfigpublic ContainerImageConfig bind(Construct scope, ContainerDefinition containerDefinition)public ContainerImageConfig Bind(Construct scope, ContainerDefinition containerDefinition)func Bind(Scope Construct, ContainerDefinition ContainerDefinition) ContainerImageConfig#
Called when the image is used by a ContainerDefinition.
fromAsset(directory: string, props?: AssetImageProps): AssetImage@staticmethod def from_asset(directory: str, props: typing.Optional[AssetImageProps] = None) -> AssetImagepublic static AssetImage fromAsset(String directory, AssetImageProps props)public static AssetImage FromAsset(string directory, AssetImageProps? props = null)func FromAsset(Directory *string, Props AssetImageProps) AssetImagestatic#
Reference an image that's constructed directly from sources on disk.

If you already have a DockerImageAsset instance, you can use the ContainerImage.fromDockerImageAsset method instead.

1 parameter

Parameters

  • directorydirectorydirectorydirectoryDirectory — The directory containing the Dockerfile.
fromDockerImageAsset(asset: DockerImageAsset): ContainerImage@staticmethod def from_docker_image_asset(asset: DockerImageAsset) -> ContainerImagepublic static ContainerImage fromDockerImageAsset(DockerImageAsset asset)public static ContainerImage FromDockerImageAsset(DockerImageAsset asset)func FromDockerImageAsset(Asset DockerImageAsset) ContainerImagestatic#
Use an existing `DockerImageAsset` for this container image.
1 parameter

Parameters

  • assetassetassetassetAsset — The DockerImageAsset to use for this container definition.
fromEcrRepository(repository: IRepository, tag?: string): EcrImage@staticmethod def from_ecr_repository(repository: IRepository, tag: typing.Optional[str] = None) -> EcrImagepublic static EcrImage fromEcrRepository(IRepository repository, String tag)public static EcrImage FromEcrRepository(IRepository repository, string? tag = null)func FromEcrRepository(Repository IRepository, Tag *string) EcrImagestatic#
Reference an image in an ECR repository.
1 parameter

Parameters

  • tagtagtagtagTag — If you don't specify this parameter, latest is used as default.
fromRegistry(name: string, props?: RepositoryImageProps): RepositoryImage // chainable@staticmethod def from_registry(name: str, props: typing.Optional[RepositoryImageProps] = None) -> RepositoryImagepublic static RepositoryImage fromRegistry(String name, RepositoryImageProps props)public static RepositoryImage FromRegistry(string name, RepositoryImageProps? props = null)func FromRegistry(Name *string, Props RepositoryImageProps) RepositoryImagestatic#
Reference an image on DockerHub or another online registry.
fromTarball(tarballFile: string): ContainerImage@staticmethod def from_tarball(tarball_file: str) -> ContainerImagepublic static ContainerImage fromTarball(String tarballFile)public static ContainerImage FromTarball(string tarballFile)func FromTarball(TarballFile *string) ContainerImagestatic#
Use an existing tarball for this container image.

Use this method if the container image has already been created by another process (e.g. jib) and you want to add it as a container image asset.

1 parameter

Parameters

  • tarballFiletarball_filetarballFiletarballFileTarballFile — Absolute path to the tarball.