AWS Fundamentals Logo
AWS Fundamentals
L2 Construct

TarballImageAsset

An asset that represents a Docker image. The image will loaded from an existing tarball and uploaded to an ECR repository.

Import

import { TarballImageAsset } from 'aws-cdk-lib/aws-ecr-assets';

Or use the module namespace:

import * as ecr_assets from 'aws-cdk-lib/aws-ecr-assets';
// ecr_assets.TarballImageAsset

Properties

Configuration passed to the constructor as TarballImageAssetProps.

tarballFileRequired
string

Absolute path to the tarball. It is recommended to use the script running directory (e.g. `__dirname` in Node.js projects or dirname of `__file__` in Python) if your tarball is located as a resource inside your project.

displayNameOptional
string

A display name for this asset. If supplied, the display name will be used in locations where the asset identifier is printed, like in the CLI progress information. If the same asset is added multiple times, the display name of the first occurrence is used. The default is the construct path of the `TarballImageAsset` construct, with respect to the enclosing stack. If the asset is produced by a construct helper function (such as `lambda.Code.fromAssetImage()`), this will look like `MyFunction/AssetImage`. We use the stack-relative construct path so that in the common case where you have multiple stacks with the same asset, we won't show something like `/MyBetaStack/MyFunction/Code` when you are actually deploying to production.

Default: - Stack-relative construct path

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL2 (Higher-level)
Moduleaws-ecr-assets
Properties2

Related Constructs

External Links