Amazon Elastic Container Service
開発者ガイド (API バージョン 2014-11-13)

ecs-cli push

イメージを Amazon ECR リポジトリにプッシュします。

重要

記載されている機能の一部は、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 は Amazon ECR への呼び出しの FIPS エンドポイントの使用をサポートします。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