翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# Amazon ECR ソースアクションリファレンス
新規イメージが Amazon ECR リポジトリにプッシュされた場合、パイプラインをトリガーします。このアクションは、Amazon ECR にプッシュされたイメージの URI を参照するイメージ定義ファイルを提供します。このソースアクションは、他のソースアーティファクトのソース場所を許可するために、CodeCommit などの他のソースアクションと組み合わせて使用されることがよくあります。詳細については、「[チュートリアル: Amazon ECR ソース、ECS - CodeDeploy 間のデプロイでパイプラインを作成する](tutorials-ecs-ecr-codedeploy.md)」を参照してください。
コンソールを使用してパイプラインを作成または編集すると、CodePipeline はリポジトリで変更が生じた場合にパイプラインを開始する EventBridge ルールを作成します。
**注記**
Amazon ECR、Amazon S3、または CodeCommit ソースの場合、入力変換エントリを使用してソースオーバーライドを作成し、パイプラインイベントの EventBridge で `revisionValue` を使用することもできます。ここで、`revisionValue` はオブジェクトキー、コミット、またはイメージ ID のソースイベント変数から派生します。詳細については、[Amazon ECR ソースアクションと EventBridge リソース](create-cwe-ecr-source.md)、[イベントに対して有効にしたソースを使用して Amazon S3 ソースアクションに接続する](create-S3-source-events.md)、または [CodeCommit ソースアクションと EventBridge](triggering.md) の手順に含まれる入力変換エントリのオプション手順を参照してください。
Amazon ECR アクションを介してパイプラインを接続する前に、Amazon ECR リポジトリを作成し、イメージをプッシュしておく必要があります。
**Topics**
+ [アクションタイプ](#action-reference-ECR-type)
+ [設定パラメータ](#action-reference-ECR-config)
+ [入力アーティファクト](#action-reference-ECR-input)
+ [出力アーティファクト](#action-reference-ECR-output)
+ [出力変数](#action-reference-ECR-variables)
+ [サービスロールのアクセス許可: Amazon ECR アクション](#edit-role-ecr)
+ [アクションの宣言 (Amazon ECR の例)](#action-reference-ECR-example)
+ [関連情報](#action-reference-ECR-links)
## アクションタイプ
+ カテゴリ:`Source`
+ 所有者: `AWS`
+ プロバイダー: `ECR`
+ バージョン: `1`
## 設定パラメータ
**RepositoryName**
必須: はい
イメージがプッシュされた Amazon ECR リポジトリの名前。
**ImageTag**
必須: いいえ
イメージに使用するタグ。
`ImageTag` の値を指定しない場合、デフォルト値は `latest` になります。
## 入力アーティファクト
+ **アーティファクトの数:** `0`
+ **説明:** 入力アーティファクトは、このアクションタイプには適用されません。
## 出力アーティファクト
+ **アーティファクトの数:** `1`
+ **説明:** このアクションは、パイプライン実行をトリガーしたイメージの URI を含む `imageDetail.json` ファイルがあるアーティファクトを生成します。`imageDetail.json` ファイルの詳細については、「[Amazon ECS Blue/Green デプロイアクション用の imageDetail.json ファイル](file-reference.md#file-reference-ecs-bluegreen)」を参照してください。
## 出力変数
このアクションを設定すると、パイプライン内のダウンストリームアクションのアクション設定によって参照できる変数が生成されます。このアクションは、アクションに名前空間がない場合でも、出力変数として表示できる変数を生成します。名前空間を使用してアクションを設定し、これらの変数をダウンストリームアクションの設定で使用できるようにします。
詳細については、「[変数リファレンス](reference-variables.md)」を参照してください。
**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 ソースアクションリファレンス](#action-reference-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"
}
]
},
```
------
## 関連情報
このアクションを利用する際に役立つ関連リソースは以下の通りです。
+ [チュートリアル: Amazon ECR ソース、ECS - CodeDeploy 間のデプロイでパイプラインを作成する](tutorials-ecs-ecr-codedeploy.md) - このチュートリアルでは、サンプルアプリ仕様ファイル、サンプル CodeDeploy アプリケーションおよび、デプロイグループを提供し、CodeCommit とAmazon ECS インスタンスにデプロイする Amazon ECR ソースを使用してパイプラインを作成します。