Close|CloudStack Canvas · How-To Guide
How-To Fix

Push a Docker Image to ECR and Get the Image URI

ECS Task Definitions require a container image URI. The most common source is Amazon Elastic Container Registry (ECR). You need to create a repository, build your Docker image, authenticate Docker to ECR, push the image, and then copy the full URI (including tag).

Paste into this field

ECS Task Definition → image

Output looks like

123456789012.dkr.ecr.us-east-1.amazonaws.com/my-app:latest

1Create an ECR repository

Navigate to Elastic Container Registry (search "ECR"). Click "Create repository". Set visibility to "Private". Enter a repository name (e.g. my-app). Click "Create repository".

3Note your repository URI

The repository list shows the URI in the format: ACCOUNT.dkr.ecr.REGION.amazonaws.com/my-app

5Authenticate Docker to ECR

Click into the repository → "View push commands". The first command authenticates Docker to your ECR registry. Run it in your terminal.

7Build your Docker image

In your project directory (where your Dockerfile lives), run: docker build -t my-app .

9Tag the image

Tag it with the full ECR URI: docker tag my-app:latest ACCOUNT.dkr.ecr.REGION.amazonaws.com/my-app:latest

11Push the image

docker push ACCOUNT.dkr.ecr.REGION.amazonaws.com/my-app:latest

13Copy the image URI

In ECR, click your repository → Images tab → copy the URI from the "Image URI" column. It includes the tag. Paste this into the "image" field on your Task Definition node.

Once you have the value, go back to CloudStack Canvas and paste it into the highlighted field.

CloudStack Canvas · Validation Guide

Push a Docker Image to ECR and Get the Image URI — CloudStack Canvas