Amazon ECR ソースアクションリファレンス - AWS CodePipeline
アクションタイプ設定パラメータ 入力アーティファクト出力アーティファクト出力変数サービスロールのアクセス許可: Amazon ECR アクションアクションの宣言 (Amazon ECR の例)関連情報

Amazon ECR ソースアクションリファレンス

新規イメージが Amazon ECR リポジトリにプッシュされた場合、パイプラインをトリガーします。このアクションは、Amazon ECR にプッシュされたイメージの URI を参照するイメージ定義ファイルを提供します。このソースアクションは、他のソースアーティファクトのソース場所を許可するために、CodeCommit などの他のソースアクションと組み合わせて使用されることがよくあります。詳細については、「チュートリアル: Amazon ECR ソース、ECS - CodeDeploy 間のデプロイでパイプラインを作成する」を参照してください。

コンソールを使用してパイプラインを作成または編集すると、CodePipeline はリポジトリで変更が生じた場合にパイプラインを開始する EventBridge ルールを作成します。

注記

Amazon ECR、Amazon S3、または CodeCommit ソースの場合、入力変換エントリを使用してソースオーバーライドを作成し、パイプラインイベントの EventBridge で revisionValue を使用することもできます。ここで、revisionValue はオブジェクトキー、コミット、またはイメージ ID のソースイベント変数から派生します。詳細については、Amazon ECR ソースアクションと EventBridge リソース、イベントに対して有効にしたソースを使用して Amazon S3 ソースアクションに接続する、または CodeCommit ソースアクションと EventBridge の手順に含まれる入力変換エントリのオプション手順を参照してください。

Amazon ECR アクションを介してパイプラインを接続する前に、Amazon ECR リポジトリを作成し、イメージをプッシュしておく必要があります。

アクションタイプ

  • カテゴリ: Source

  • 所有者: AWS

  • プロバイダー: ECR

  • バージョン: 1

設定パラメータ

RepositoryName

必須: はい

イメージがプッシュされた Amazon ECR リポジトリの名前。

ImageTag

必須: いいえ

イメージに使用するタグ。

注記

ImageTag の値を指定しない場合、デフォルト値は latest になります。

入力アーティファクト

  • アーティファクトの数: 0

  • 説明: 入力アーティファクトは、このアクションタイプには適用されません。

出力アーティファクト

出力変数

このアクションを設定すると、パイプライン内のダウンストリームアクションのアクション設定によって参照できる変数が生成されます。このアクションは、アクションに名前空間がない場合でも、出力変数として表示できる変数を生成します。名前空間を使用してアクションを設定し、これらの変数をダウンストリームアクションの設定で使用できるようにします。

詳細については、「変数リファレンス」を参照してください。

RegistryId

リポジトリが格納されているレジストリに関連付けられている. AWSアカウント ID。

RepositoryName

イメージがプッシュされた Amazon ECR リポジトリの名前。

ImageTag

イメージに使用するタグ。

注記

ソースリビジョンがオーバーライドされている場合、ImageTag 出力変数は出力されません

ImageDigest

イメージマニフェストの sha256 ダイジェスト。

ImageURI

イメージの URL。

サービスロールのアクセス許可: Amazon ECR アクション

Amazon ECR がサポートされるように、以下をポリシーステートメントに追加します。

{
    "Effect": "Allow",
    "Action": [
        "ecr:DescribeImages"
    ],
    "Resource": "resource_ARN"
},

このアクションの詳細については、「Amazon ECR ソースアクションリファレンス」を参照してください。

アクションの宣言 (Amazon ECR の例)

YAML
Name: Source
Actions:
  - InputArtifacts: []
    ActionTypeId:
      Version: '1'
      Owner: AWS
      Category: Source
      Provider: ECR
    OutputArtifacts:
      - Name: SourceArtifact
    RunOrder: 1
    Configuration:
      ImageTag: latest
      RepositoryName: my-image-repo

    Name: ImageSource
JSON
{
    "Name": "Source",
    "Actions": [
        {
            "InputArtifacts": [],
            "ActionTypeId": {
                "Version": "1",
                "Owner": "AWS",
                "Category": "Source",
                "Provider": "ECR"
            },
            "OutputArtifacts": [
                {
                    "Name": "SourceArtifact"
                }
            ],
            "RunOrder": 1,
            "Configuration": {
                "ImageTag": "latest",
                "RepositoryName": "my-image-repo"
            },
            "Name": "ImageSource"
        }
    ]
},

このアクションを利用する際に役立つ関連リソースは以下の通りです。