Amazon ECR 來源動作參考

將新映像推送至 Amazon ECR 儲存庫時觸發管道。此動作提供參考推送至 Amazon ECR 之映像的 URI 的映像定義檔案。此來源動作通常與 CodeCommit 等另一個來源動作搭配使用，以允許所有其他來源成品的來源位置。如需詳細資訊，請參閱教學課程：使用 Amazon ECR 來源和 ECS-to-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。

Input artifacts (輸入成品)

• 成品數量： 0

• 描述：輸入成品不適用於此動作類型。

輸出成品

• 成品數量： 1

• 描述：這個動作會產生包含 imageDetail.json 檔案的成品，而此檔案包含觸發管道執行之映像的 URI。如需 imageDetail.json 詳細資訊，請參閱 Amazon ECS 藍/綠部署動作的 imageDetail.json 檔案。

輸出變數

設定時，此動作會產生變數，供管道中的下游動作的動作組態所參考。即使此動作沒有命名空間，此動作產生的變數仍可視為輸出變數。您可以設定動作的命名空間，讓這些變數可供下游動作的組態使用。

如需詳細資訊，請參閱變數參考。

RegistryId

與包含儲存庫的登錄相關聯的 AWS 帳戶 ID。

RepositoryName

推送映像的 Amazon ECR 儲存庫名稱。

ImageTag

用於映像的標籤。

ImageDigest

映像資訊清單的 sha256 摘要。

ImageURI

映像的 URI。

動作宣告 (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-to-CodeDeploy 部署建立管道 – 本教學課程提供範例應用程式規格檔案，以及範例 CodeDeploy 應用程式和部署群組，以使用部署至 Amazon ECS 執行個體的 CodeCommit 和 Amazon ECR 來源建立管道。