AWS ECR Pull

@hashicorp

The AWS ECR Pull plugin references an existing image, if found, in an AWS Elastic Container Registry. The image information can be used to push an image to a new registry, or be deployed to AWS ECS.

Official
Built-in

Updated 8 months ago

GitHub
(opens in new tab)

AWS ECR Pull Builder

Use an existing, pre-built AWS ECR image.

This builder attempts to find an image by repository and tag in the specified region. If found, it will pass along the image information to the next step.

This builder will not modify the image.

If you wish to rename or retag an image, please use the "docker-pull" component in conjunction with the "aws-ecr" registry option.

Interface

Input: component.Source
Output: ecr.Image

Examples

build {
  use "aws-ecr-pull" {
    region     = "us-east-1"
    repository = "deno-http"
    tag        = "latest"
  }
}

Parameters

Required only

4 Results

force_architectureOptionalstring
Note: This is a temporary field that enables overriding the architecture output attribute. Valid values are: "x86_64", "arm64"
regionOptionalstring
the AWS region the ECR repository is in if not set uses the environment variable AWS_REGION or AWS_REGION_DEFAULT.
repositoryRequiredstring
the AWS ECR repository name
tagRequiredstring
the tag of the image to pull

Outputs

3 Results

architecturestring
imagestring
tagstring