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

ecs-cli push

将映像推送到 Amazon ECR 存储库。

重要

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

语法

ecs-cli push [--registry-id registry_id] [--tags key1=value1,key2=value2] [--region region] [--verbose] [--use-fips] ECR_REPOSITORY[:TAG] [--help]

选项

名称

描述

--registry-id registry_id

指定要将映像推送到的 Amazon ECR 注册表 ID。默认情况下,映像将推送到当前 AWS 账户。

类型:字符串

必需:否

--tags value

指定要应用于 Amazon ECR 存储库的元数据。每一个标签都包含一个键和一个可选值。标签键的最大字符长度为 128 个字符,标签值的最大长度为 256 个字符。标签采用以下格式:key1=value1,key2=value2,key3=value3

类型:键值对

必需:否

--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

此示例将名为 ubuntu 的本地映像推送到具有相同名称的 Amazon ECR 存储库。

ecs-cli push ubuntu

输出:

INFO[0000] Getting AWS account ID... INFO[0000] Tagging image repository="aws_account_id.dkr.ecr.us-east-1.amazonaws.com/ubuntu" source-image=ubuntu tag= INFO[0000] Image tagged INFO[0001] Creating repository repository=ubuntu INFO[0001] Repository created INFO[0001] Pushing image repository="aws_account_id.dkr.ecr.us-east-1.amazonaws.com/ubuntu" tag= INFO[0079] Image pushed