ecs-cli pull
Description
Pull an image from an Amazon ECR repository.
Important
Some features described may only be available with the latest version of the ECS CLI. To obtain the latest version, see Installing the Amazon ECS CLI.
Syntax
ecs-cli pull [--registry-id
registry_id
] [--region
region
]
ECR_REPOSITORY
[:TAG
|@DIGEST
]
[--help]
Options
Name | Description |
---|---|
|
Specifies the ECR registry ID from which to pull the image. By default, images are pulled from the current AWS account. Required: No |
|
Specifies the AWS Region to use. Defaults to the cluster configured using the configure command. Type: String Required: No |
|
Specifies the name of the ECS profile configuration to use. Defaults to the profile configured using the configure profile command. Type: String Required: No |
|
Specifies the AWS profile to use. Enables you to use the AWS credentials from an existing
named profile in Type: String Required: No |
|
Specifies the name of the ECS cluster configuration to use. Defaults to the cluster configuration set as the default. Type: String Required: No |
|
Shows the help text for the specified command. Required: No |
Examples
Example 1
This example pulls a local image called amazonlinux
from an ECR
repository with the same name.
ecs-cli pull amazonlinux
Output:
INFO[0000] Getting AWS account ID... INFO[0000] Pulling image repository="
aws_account_id
.dkr.ecr.us-east-1.amazonaws.com/amazonlinux" tag= INFO[0129] Image pulled