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"
        }
    ]
},

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