Amazon Elastic Container Service
开发人员指南 (API 版本 2014-11-13)
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

ecs-cli pull

从 Amazon ECR 存储库中拉取映像。

重要

所介绍的某些功能仅可用于最新版本的 Amazon ECS CLI。有关获取最新版本的更多信息,请参阅 安装 Amazon ECS CLI

语法

ecs-cli pull [--registry-id registry_id] [--region region] [--verbose] [--use-fips] ECR_REPOSITORY[:TAG|@DIGEST] [--help]

选项

名称 描述

--registry-id registry_id

指定要从中拉取映像的 Amazon ECR 注册表 ID。默认情况下,将从当前 AWS 账户中拉取映像。

必需:否

--verbose, --debug

打开调试日志记录。这将提供帮助诊断问题的更详细的命令输出。

必需:否

--use-fips

通过 FIPS 终端节点将调用路由到 Amazon ECR。

必需:否

--region, -r region

指定要使用的 AWS 区域。默认为使用 configure 命令配置的集群。

类型:字符串

必需:否

--cluster-config cluster_config_name

指定要使用的 Amazon ECS 集群配置的名称。默认为作为默认值设置的集群设置。

类型:字符串

必需:否

--ecs-profile ecs_profile

指定要使用的 Amazon ECS 配置文件的名称。默认为使用 configure profile 命令配置的配置文件。

类型:字符串

必需:否

--aws-profile aws_profile

指定要使用的 AWS 配置文件。使您能够使用 ~/.aws/credentials 中现有指定配置文件中的 AWS 凭证。

类型:字符串

必需:否

--cluster, -c cluster_name

指定要使用的 Amazon ECS 集群名称。默认为使用 configure 命令配置的集群。

类型:字符串

必需:否

--help, -h

显示指定命令的帮助文本。

必需:否

使用 FIPS 终端节点

Amazon ECS CLI 支持使用 FIPS 终端节点调用 Amazon ECR。为确保您使用的是 FIPS 终端节点访问 Amazon ECR,请对 push、pull 或 images 命令使用 --use-fips 标记。FIPS 终端节点目前仅在 us-west-1、us-west-2、us-east-1、us-east-2 和 AWS GovCloud (US) 中可用。有关更多信息,请参阅美国联邦信息处理标准 (FIPS) 140-2

示例

示例 1

此示例从具有相同名称的 Amazon ECR 存储库中拉取名为 amazonlinux 的本地映像。

ecs-cli pull amazonlinux

输出:

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