Amazon ECR 示例使用 AWS CLI - AWS Command Line Interface

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

Amazon ECR 示例使用 AWS CLI

下列程式碼範例說明如何透過 AWS Command Line Interface 搭配 Amazon ECR 使用來執行動作和實作常見案例。

Actions 是大型程式的程式碼摘錄,必須在內容中執行。雖然動作會告訴您如何呼叫個別服務函數,但您可以在其相關情境和跨服務範例中查看內容中的動作。

Scenarios (案例) 是向您展示如何呼叫相同服務中的多個函數來完成特定任務的程式碼範例。

每個範例都包含一個連結 GitHub,您可以在其中找到如何在內容中設定和執行程式碼的指示。

主題

動作

下列程式碼範例會示範如何使用batch-check-layer-availability

AWS CLI

檢查圖層可用性的步驟

下列batch-check-layer-availability範例會檢查cluster-autoscaler存放庫sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed中包含摘要的圖層的可用性。

aws ecr batch-check-layer-availability \ --repository-name cluster-autoscaler \ --layer-digests sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed

輸出:

{ "layers": [ { "layerDigest": "sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed", "layerAvailability": "AVAILABLE", "layerSize": 2777, "mediaType": "application/vnd.docker.container.image.v1+json" } ], "failures": [] }

下列程式碼範例會示範如何使用batch-delete-image

AWS CLI

範例 1:若要刪除影像

下列batch-delete-image範例會在帳戶的預設登錄precise中,刪除含有指定儲存庫中標記的影像。

aws ecr batch-delete-image \ --repository-name ubuntu \ --image-ids imageTag=precise

輸出:

{ "failures": [], "imageIds": [ { "imageTag": "precise", "imageDigest": "sha256:19665f1e6d1e504117a1743c0a3d3753086354a38375961f2e665416ef4b1b2f" } ] }

範例 2:刪除多個影像

下列batch-delete-image範例會刪除指定儲存庫team1中標記為 prod and 的所有影像。

aws ecr batch-delete-image \ --repository-name MyRepository \ --image-ids imageTag=prod imageTag=team1

輸出:

{ "imageIds": [ { "imageDigest": "sha256:123456789012", "imageTag": "prod" }, { "imageDigest": "sha256:567890121234", "imageTag": "team1" } ], "failures": [] }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的刪除映像

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考BatchDeleteImage中的。

下列程式碼範例會示範如何使用batch-get-image

AWS CLI

示例 1:獲取圖像

下列batch-get-image範例會取得含有在帳戶預設登錄v1.13.6cluster-autoscaler中呼叫的儲存庫中標記的影像。

aws ecr batch-get-image \ --repository-name cluster-autoscaler \ --image-ids imageTag=v1.13.6

輸出:

{ "images": [ { "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "imageId": { "imageDigest": "sha256:4a1c6567c38904384ebc64e35b7eeddd8451110c299e3368d2210066487d97e5", "imageTag": "v1.13.6" }, "imageManifest": "{\n \"schemaVersion\": 2,\n \"mediaType\": \"application/vnd.docker.distribution.manifest.v2+json\",\n \"config\": {\n \"mediaType\": \"application/vnd.docker.container.image.v1+json\",\n \"size\": 2777,\n \"digest\": \"sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed\"\n },\n \"layers\": [\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 17743696,\n \"digest\": \"sha256:39fafc05754f195f134ca11ecdb1c9a691ab0848c697fffeb5a85f900caaf6e1\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 2565026,\n \"digest\": \"sha256:8c8a779d3a537b767ae1091fe6e00c2590afd16767aa6096d1b318d75494819f\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28005981,\n \"digest\": \"sha256:c44ba47496991c9982ee493b47fd25c252caabf2b4ae7dd679c9a27b6a3c8fb7\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 775,\n \"digest\": \"sha256:e2c388b44226544363ca007be7b896bcce1baebea04da23cbd165eac30be650f\"\n }\n ]\n}" } ], "failures": [] }

示例 2:獲取多個圖像

下列batch-get-image範例會顯示所有標記為prod和指定儲存庫team1中之映像的詳細資訊。

aws ecr batch-get-image \ --repository-name MyRepository \ --image-ids imageTag=prod imageTag=team1

輸出:

{ "images": [ { "registryId": "123456789012", "repositoryName": "MyRepository", "imageId": { "imageDigest": "sha256:123456789012", "imageTag": "prod" }, "imageManifest": "manifestExample1" }, { "registryId": "567890121234", "repositoryName": "MyRepository", "imageId": { "imageDigest": "sha256:123456789012", "imageTag": "team1" }, "imageManifest": "manifestExample2" } ], "failures": [] }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的映像

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考BatchGetImage中的。

下列程式碼範例會示範如何使用complete-layer-upload

AWS CLI

完成影像圖層上傳

下列complete-layer-upload範例完成上傳至layer-test儲存庫的影像圖層。

aws ecr complete-layer-upload \ --repository-name layer-test \ --upload-id 6cb64b8a-9378-0e33-2ab1-b780fab8a9e9 \ --layer-digests 6cb64b8a-9378-0e33-2ab1-b780fab8a9e9:48074e6d3a68b39aad8ccc002cdad912d4148c0f92b3729323e

輸出:

{ "uploadId": "6cb64b8a-9378-0e33-2ab1-b780fab8a9e9", "layerDigest": "sha256:9a77f85878aa1906f2020a0ecdf7a7e962d57e882250acd773383224b3fe9a02", "repositoryName": "layer-test", "registryId": "130757420319" }

下列程式碼範例會示範如何使用create-repository

AWS CLI

範例 1:建立存放庫

下列create-repository範例會在帳戶的預設登錄中,在指定的命名空間內建立儲存庫。

aws ecr create-repository \ --repository-name project-a/nginx-web-app

輸出:

{ "repository": { "registryId": "123456789012", "repositoryName": "sample-repo", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/project-a/nginx-web-app" } }

如需詳細資訊,請參Amazon ECR 使用者指南中的建立儲存庫

示例 2:創建配置了圖像標籤不變性的存儲庫

下列create-repository範例會在帳戶的預設登錄中建立標籤不變性所設定的存放庫。

aws ecr create-repository \ --repository-name sample-repo \ --image-tag-mutability IMMUTABLE

輸出:

{ "repository": { "registryId": "123456789012", "repositoryName": "sample-repo", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/sample-repo", "imageTagMutability": "IMMUTABLE" } }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的影像標籤可變性

範例 3:建立使用掃描組態設定的存放庫

下列create-repository範例會建立一個設定為在帳戶預設登錄中對映像推送執行弱點掃描的存放庫。

aws ecr create-repository \ --repository-name sample-repo \ --image-scanning-configuration scanOnPush=true

輸出:

{ "repository": { "registryId": "123456789012", "repositoryName": "sample-repo", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/sample-repo", "imageScanningConfiguration": { "scanOnPush": true } } }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的影像掃描

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考CreateRepository中的。

下列程式碼範例會示範如何使用delete-lifecycle-policy

AWS CLI

若要刪除存放庫的生命週期原則

下列delete-lifecycle-policy範例會刪除存hello-world放庫的生命週期原則。

aws ecr delete-lifecycle-policy \ --repository-name hello-world

輸出:

{ "registryId": "012345678910", "repositoryName": "hello-world", "lifecyclePolicyText": "{\"rules\":[{\"rulePriority\":1,\"description\":\"Remove untagged images.\",\"selection\":{\"tagStatus\":\"untagged\",\"countType\":\"sinceImagePushed\",\"countUnit\":\"days\",\"countNumber\":10},\"action\":{\"type\":\"expire\"}}]}", "lastEvaluatedAt": 0.0 }

下列程式碼範例會示範如何使用delete-repository-policy

AWS CLI

刪除儲存區域的儲存區域原則

下列delete-repository-policy範例會刪除存放庫的儲存cluster-autoscaler區域原則。

aws ecr delete-repository-policy \ --repository-name cluster-autoscaler

輸出:

{ "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"allow public pull\",\n \"Effect\" : \"Allow\",\n \"Principal\" : \"*\",\n \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n } ]\n}" }

下列程式碼範例會示範如何使用delete-repository

AWS CLI

若要刪除存放庫

下列delete-repository範例命令 force 會刪除帳號預設登錄中指定的儲存庫。如果存放庫包含影像,則需要此--force旗標。

aws ecr delete-repository \ --repository-name ubuntu \ --force

輸出:

{ "repository": { "registryId": "123456789012", "repositoryName": "ubuntu", "repositoryArn": "arn:aws:ecr:us-west-2:123456789012:repository/ubuntu" } }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的刪除儲存庫

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DeleteRepository中的。

下列程式碼範例會示範如何使用describe-image-scan-findings

AWS CLI

描述影像的掃描發現項目

下列describe-image-scan-findings範例會使用帳戶預設登錄中指定存放庫中的映像摘要,傳回影像的影像掃描發現項目。

aws ecr describe-image-scan-findings \ --repository-name sample-repo \ --image-id imageDigest=sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6

輸出:

{ "imageScanFindings": { "findings": [ { "name": "CVE-2019-5188", "description": "A code execution vulnerability exists in the directory rehashing functionality of E2fsprogs e2fsck 1.45.4. A specially crafted ext4 directory can cause an out-of-bounds write on the stack, resulting in code execution. An attacker can corrupt a partition to trigger this vulnerability.", "uri": "http://people.ubuntu.com/~ubuntu-security/cve/CVE-2019-5188", "severity": "MEDIUM", "attributes": [ { "key": "package_version", "value": "1.44.1-1ubuntu1.1" }, { "key": "package_name", "value": "e2fsprogs" }, { "key": "CVSS2_VECTOR", "value": "AV:L/AC:L/Au:N/C:P/I:P/A:P" }, { "key": "CVSS2_SCORE", "value": "4.6" } ] } ], "imageScanCompletedAt": 1579839105.0, "vulnerabilitySourceUpdatedAt": 1579811117.0, "findingSeverityCounts": { "MEDIUM": 1 } }, "registryId": "123456789012", "repositoryName": "sample-repo", "imageId": { "imageDigest": "sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6" }, "imageScanStatus": { "status": "COMPLETE", "description": "The scan was completed successfully." } }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的影像掃描

下列程式碼範例會示範如何使用describe-images

AWS CLI

描述儲存庫中的影像

下列describe-images範例會顯示有關cluster-autoscaler儲存庫中含有標籤v1.13.6之影像的詳細資訊。

aws ecr describe-images \ --repository-name cluster-autoscaler \ --image-ids imageTag=v1.13.6

輸出:

{ "imageDetails": [ { "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "imageDigest": "sha256:4a1c6567c38904384ebc64e35b7eeddd8451110c299e3368d2210066487d97e5", "imageTags": [ "v1.13.6" ], "imageSizeInBytes": 48318255, "imagePushedAt": 1565128275.0 } ] }
  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考DescribeImages中的。

下列程式碼範例會示範如何使用describe-repositories

AWS CLI

描述登錄中的儲存庫

此範例說明帳戶預設登錄中的儲存庫。

命令:

aws ecr describe-repositories

輸出:

{ "repositories": [ { "registryId": "012345678910", "repositoryName": "ubuntu", "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/ubuntu" }, { "registryId": "012345678910", "repositoryName": "test", "repositoryArn": "arn:aws:ecr:us-west-2:012345678910:repository/test" } ] }

下列程式碼範例會示範如何使用get-authorization-token

AWS CLI

若要取得預設登錄的授權權杖

下列get-authorization-token範例命令會取得預設登錄的授權憑證。

aws ecr get-authorization-token

輸出:

{ "authorizationData": [ { "authorizationToken": "QVdTOkN...", "expiresAt": 1448875853.241, "proxyEndpoint": "https://123456789012.dkr.ecr.us-west-2.amazonaws.com" } ] }

下列程式碼範例會示範如何使用get-download-url-for-layer

AWS CLI

取得圖層下載 URL 的步驟

下列get-download-url-for-layer範例會顯示儲存庫sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed中包含摘要之圖層的下載 cluster-autoscaler URL。

aws ecr get-download-url-for-layer \ --repository-name cluster-autoscaler \ --layer-digest sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed

輸出:

{ "downloadUrl": "https://prod-us-west-2-starport-layer-bucket.s3.us-west-2.amazonaws.com/e501-012345678910-9cb60dc0-7284-5643-3987-da6dac0465f0/04620aac-66a5-4167-8232-55ee7ef6d565?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Date=20190814T220617Z&X-Amz-SignedHeaders=host&X-Amz-Expires=3600&X-Amz-Credential=AKIA32P3D2JDNMVAJLGF%2F20190814%2Fus-west-2%2Fs3%2Faws4_request&X-Amz-Signature=9161345894947a1672467a0da7a1550f2f7157318312fe4941b59976239c3337", "layerDigest": "sha256:6171c7451a50945f8ddd72f7732cc04d7a0d1f48138a426b2e64387fdeb834ed" }

下列程式碼範例會示範如何使用get-lifecycle-policy-preview

AWS CLI

擷取生命週期原則預覽的詳細資料

下列get-lifecycle-policy-preview範例會擷取帳戶預設登錄中指定存放庫的生命週期原則預覽結果。

命令:

aws ecr get-lifecycle-policy-preview \ --repository-name "project-a/amazon-ecs-sample"

輸出:

{ "registryId": "012345678910", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\n \"rules\": [\n {\n \"rulePriority\": 1,\n \"description\": \"Expire images older than 14 days\",\n \"selection\": {\n \"tagStatus\": \"untagged\",\n \"countType\": \"sinceImagePushed\",\n \"countUnit\": \"days\",\n \"countNumber\": 14\n },\n \"action\": {\n \"type\": \"expire\"\n }\n }\n ]\n}\n", "status": "COMPLETE", "previewResults": [], "summary": { "expiringImageTotalCount": 0 } }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的生命週期政策

下列程式碼範例會示範如何使用get-lifecycle-policy

AWS CLI

若要擷取生命週期原則

下列get-lifecycle-policy範例會在帳戶的預設登錄中顯示指定存放庫的生命週期原則詳細資料。

aws ecr get-lifecycle-policy \ --repository-name "project-a/amazon-ecs-sample"

輸出:

{ "registryId": "123456789012", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\"rules\":[{\"rulePriority\":1,\"description\":\"Expire images older than 14 days\",\"selection\":{\"tagStatus\":\"untagged\",\"countType\":\"sinceImagePushed\",\"countUnit\":\"days\",\"countNumber\":14},\"action\":{\"type\":\"expire\"}}]}", "lastEvaluatedAt": 1504295007.0 }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的生命週期政策

下列程式碼範例會示範如何使用get-login-password

AWS CLI

若要擷取密碼以驗證登錄

以下get-login-password顯示一個密碼,您可以將密碼與您選擇的容器用戶端搭配使用,以對 IAM 主體可存取的任何 Amazon ECR 登錄進行驗證。

aws ecr get-login-password

輸出:

<password>

若要與 Docker CLI 搭配使用,請將get-login-password命令的輸出傳送至指docker login令。擷取密碼時,請確定您指定的區域與 Amazon ECR 登錄所在的區域相同。

aws ecr get-login-password \ --region <region> \ | docker login \ --username AWS \ --password-stdin <aws_account_id>.dkr.ecr.<region>.amazonaws.com

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的登錄身份驗證

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考GetLoginPassword中的。

下列程式碼範例會示範如何使用get-login

AWS CLI

若要將 Docker 登入指令擷取至您的預設登錄

此範例會列印可用來登入預設 Amazon ECR 登錄的命令。

命令:

aws ecr get-login

輸出:

docker login -u AWS -p <password> -e none https://<aws_account_id>.dkr.ecr.<region>.amazonaws.com

若要登入其他帳戶的登錄

此範例會列印一或多個指令,讓您用來登入與其他帳戶相關聯的 Amazon ECR 登錄。

命令:

aws ecr get-login --registry-ids 012345678910 023456789012

輸出:

docker login -u <username> -p <token-1> -e none <endpoint-1> docker login -u <username> -p <token-2> -e none <endpoint-2>
  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考GetLogin中的。

下列程式碼範例會示範如何使用get-repository-policy

AWS CLI

擷取儲存區域的儲存區域原則

下列get-repository-policy範例顯示有關儲存庫之儲存區域原則的cluster-autoscaler詳細資訊。

aws ecr get-repository-policy \ --repository-name cluster-autoscaler

輸出:

{ "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"allow public pull\",\n \"Effect\" : \"Allow\",\n \"Principal\" : \"*\",\n \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n } ]\n}" }

下列程式碼範例會示範如何使用initiate-layer-upload

AWS CLI

啟動影像圖層上傳

下列initiate-layer-upload範例會啟動影像層上傳至layer-test儲存庫。

aws ecr initiate-layer-upload \ --repository-name layer-test

輸出:

{ "partSize": 10485760, "uploadId": "6cb64b8a-9378-0e33-2ab1-b780fab8a9e9" }

下列程式碼範例會示範如何使用list-images

AWS CLI

若要列出儲存庫中的影像

下列list-images範例會顯示cluster-autoscaler儲存庫中的影像清單。

aws ecr list-images \ --repository-name cluster-autoscaler

輸出:

{ "imageIds": [ { "imageDigest": "sha256:99c6fb4377e9a420a1eb3b410a951c9f464eff3b7dbc76c65e434e39b94b6570", "imageTag": "v1.13.8" }, { "imageDigest": "sha256:99c6fb4377e9a420a1eb3b410a951c9f464eff3b7dbc76c65e434e39b94b6570", "imageTag": "v1.13.7" }, { "imageDigest": "sha256:4a1c6567c38904384ebc64e35b7eeddd8451110c299e3368d2210066487d97e5", "imageTag": "v1.13.6" } ] }
  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考ListImages中的。

下列程式碼範例會示範如何使用list-tags-for-resource

AWS CLI

若要列出儲存庫的標籤

下列list-tags-for-resource範例會顯示與hello-world存放庫相關聯的標籤清單。

aws ecr list-tags-for-resource \ --resource-arn arn:aws:ecr:us-west-2:012345678910:repository/hello-world

輸出:

{ "tags": [ { "Key": "Stage", "Value": "Integ" } ] }

下列程式碼範例會示範如何使用put-image-scanning-configuration

AWS CLI

更新存放庫的影像掃描組態

下列put-image-scanning-configuration範例會更新指定存放庫的影像掃描組態。

aws ecr put-image-scanning-configuration \ --repository-name sample-repo \ --image-scanning-configuration scanOnPush=true

輸出:

{ "registryId": "012345678910", "repositoryName": "sample-repo", "imageScanningConfiguration": { "scanOnPush": true } }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的影像掃描

下列程式碼範例會示範如何使用put-image-tag-mutability

AWS CLI

若要更新儲存庫的影像標籤可變性設定

下面的put-image-tag-mutability例子配置標籤不變性指定的存儲庫。這樣可以防止覆寫儲存庫中的所有影像標籤。

aws ecr put-image-tag-mutability \ --repository-name hello-repository \ --image-tag-mutability IMMUTABLE

輸出:

{ "registryId": "012345678910", "repositoryName": "sample-repo", "imageTagMutability": "IMMUTABLE" }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的影像標籤可變性

下列程式碼範例會示範如何使用put-image

AWS CLI

若要使用其資訊清單重新標記影像

下列put-image範例會在具有現有映像資訊清單的hello-world儲存庫中建立新標籤。

aws ecr put-image \ --repository-name hello-world \ --image-tag 2019.08 \ --image-manifest file://hello-world.manifest.json

hello-world.manifest.json 的內容:

{ "schemaVersion": 2, "mediaType": "application/vnd.docker.distribution.manifest.v2+json", "config": { "mediaType": "application/vnd.docker.container.image.v1+json", "size": 5695, "digest": "sha256:cea5fe7701b7db3dd1c372f3cea6f43cdda444fcc488f530829145e426d8b980" }, "layers": [ { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 39096921, "digest": "sha256:d8868e50ac4c7104d2200d42f432b661b2da8c1e417ccfae217e6a1e04bb9295" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 57938, "digest": "sha256:83251ac64627fc331584f6c498b3aba5badc01574e2c70b2499af3af16630eed" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 423, "digest": "sha256:589bba2f1b36ae56f0152c246e2541c5aa604b058febfcf2be32e9a304fec610" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 680, "digest": "sha256:d62ecaceda3964b735cdd2af613d6bb136a52c1da0838b2ff4b4dab4212bcb1c" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 162, "digest": "sha256:6d93b41cfc6bf0d2522b7cf61588de4cd045065b36c52bd3aec2ba0622b2b22b" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 28268840, "digest": "sha256:6986b4d4c07932c680b3587f2eac8b0e013568c003cc23b04044628a5c5e599f" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 35369152, "digest": "sha256:8c5ec60f10102dc8da0649d866c7c2f706e459d0bdc25c83ad2de86f4996c276" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 155, "digest": "sha256:cde50b1c594539c5f67cbede9aef95c9ae321ccfb857f7b251b45b84198adc85" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 28737, "digest": "sha256:2e102807ab72a73fc9abf53e8c50e421bdc337a0a8afcb242176edeec65977e4" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 190, "digest": "sha256:fc379bbd5ed37808772bef016553a297356c59b8f134659e6ee4ecb563c2f5a7" }, { "mediaType": "application/vnd.docker.image.rootfs.diff.tar.gzip", "size": 28748, "digest": "sha256:021db240dfccf5a1aff19507d17c0177e5888e518acf295b52204b1825e8b7ee" } ] }

輸出:

{ "image": { "registryId": "130757420319", "repositoryName": "hello-world", "imageId": { "imageDigest": "sha256:8ece96b74f87652876199d83bd107d0435a196133af383ac54cb82b6cc5283ae", "imageTag": "2019.08" }, "imageManifest": "{\n \"schemaVersion\": 2,\n \"mediaType\": \"application/vnd.docker.distribution.manifest.v2+json\",\n \"config\": {\n \"mediaType\": \"application/vnd.docker.container.image.v1+json\",\n \"size\": 5695,\n \"digest\": \"sha256:cea5fe7701b7db3dd1c372f3cea6f43cdda444fcc488f530829145e426d8b980\"\n },\n \"layers\": [\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 39096921,\n \"digest\": \"sha256:d8868e50ac4c7104d2200d42f432b661b2da8c1e417ccfae217e6a1e04bb9295\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 57938,\n \"digest\": \"sha256:83251ac64627fc331584f6c498b3aba5badc01574e2c70b2499af3af16630eed\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 423,\n \"digest\": \"sha256:589bba2f1b36ae56f0152c246e2541c5aa604b058febfcf2be32e9a304fec610\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 680,\n \"digest\": \"sha256:d62ecaceda3964b735cdd2af613d6bb136a52c1da0838b2ff4b4dab4212bcb1c\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 162,\n \"digest\": \"sha256:6d93b41cfc6bf0d2522b7cf61588de4cd045065b36c52bd3aec2ba0622b2b22b\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28268840,\n \"digest\": \"sha256:6986b4d4c07932c680b3587f2eac8b0e013568c003cc23b04044628a5c5e599f\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 35369152,\n \"digest\": \"sha256:8c5ec60f10102dc8da0649d866c7c2f706e459d0bdc25c83ad2de86f4996c276\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 155,\n \"digest\": \"sha256:cde50b1c594539c5f67cbede9aef95c9ae321ccfb857f7b251b45b84198adc85\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28737,\n \"digest\": \"sha256:2e102807ab72a73fc9abf53e8c50e421bdc337a0a8afcb242176edeec65977e4\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 190,\n \"digest\": \"sha256:fc379bbd5ed37808772bef016553a297356c59b8f134659e6ee4ecb563c2f5a7\"\n },\n {\n \"mediaType\": \"application/vnd.docker.image.rootfs.diff.tar.gzip\",\n \"size\": 28748,\n \"digest\": \"sha256:021db240dfccf5a1aff19507d17c0177e5888e518acf295b52204b1825e8b7ee\"\n }\n ]\n}\n" } }
  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考PutImage中的。

下列程式碼範例會示範如何使用put-lifecycle-policy

AWS CLI

若要建立生命週期原則

下列put-lifecycle-policy範例會在帳號的預設登錄中,為指定的存放庫建立生命週期原則。

aws ecr put-lifecycle-policy \ --repository-name "project-a/amazon-ecs-sample" \ --lifecycle-policy-text "file://policy.json"

policy.json 的內容:

{ "rules": [ { "rulePriority": 1, "description": "Expire images older than 14 days", "selection": { "tagStatus": "untagged", "countType": "sinceImagePushed", "countUnit": "days", "countNumber": 14 }, "action": { "type": "expire" } } ] }

輸出:

{ "registryId": "<aws_account_id>", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\"rules\":[{\"rulePriority\":1,\"description\":\"Expire images older than 14 days\",\"selection\":{\"tagStatus\":\"untagged\",\"countType\":\"sinceImagePushed\",\"countUnit\":\"days\",\"countNumber\":14},\"action\":{\"type\":\"expire\"}}]}" }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的生命週期政策

下列程式碼範例會示範如何使用set-repository-policy

AWS CLI

若要設定存放庫的儲存庫原則

下列set-repository-policy範例會將檔案中包含的儲存庫原則附加至cluster-autoscaler儲存庫。

aws ecr set-repository-policy \ --repository-name cluster-autoscaler \ --policy-text file://my-policy.json

my-policy.json 的內容:

{ "Version" : "2008-10-17", "Statement" : [ { "Sid" : "allow public pull", "Effect" : "Allow", "Principal" : "*", "Action" : [ "ecr:BatchCheckLayerAvailability", "ecr:BatchGetImage", "ecr:GetDownloadUrlForLayer" ] } ] }

輸出:

{ "registryId": "012345678910", "repositoryName": "cluster-autoscaler", "policyText": "{\n \"Version\" : \"2008-10-17\",\n \"Statement\" : [ {\n \"Sid\" : \"allow public pull\",\n \"Effect\" : \"Allow\",\n \"Principal\" : \"*\",\n \"Action\" : [ \"ecr:BatchCheckLayerAvailability\", \"ecr:BatchGetImage\", \"ecr:GetDownloadUrlForLayer\" ]\n } ]\n}" }

下列程式碼範例會示範如何使用start-image-scan

AWS CLI

啟動映像弱點掃瞄

下列start-image-scan範例會針對指定存放庫中的影像摘要啟動影像掃描,並由其指定。

aws ecr start-image-scan \ --repository-name sample-repo \ --image-id imageDigest=sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6

輸出:

{ "registryId": "012345678910", "repositoryName": "sample-repo", "imageId": { "imageDigest": "sha256:74b2c688c700ec95a93e478cdb959737c148df3fbf5ea706abe0318726e885e6" }, "imageScanStatus": { "status": "IN_PROGRESS" } }

如需詳細資訊,請參閱 Amazon ECR 使用者指南中的影像掃描

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考StartImageScan中的。

下列程式碼範例會示範如何使用start-lifecycle-policy-preview

AWS CLI

建立生命週期原則預覽

下列start-lifecycle-policy-preview範例會針對指定的存放庫建立由 JSON 檔案定義的生命週期原則預覽。

aws ecr start-lifecycle-policy-preview \ --repository-name "project-a/amazon-ecs-sample" \ --lifecycle-policy-text "file://policy.json"

policy.json 的內容:

{ "rules": [ { "rulePriority": 1, "description": "Expire images older than 14 days", "selection": { "tagStatus": "untagged", "countType": "sinceImagePushed", "countUnit": "days", "countNumber": 14 }, "action": { "type": "expire" } } ] }

輸出:

{ "registryId": "012345678910", "repositoryName": "project-a/amazon-ecs-sample", "lifecyclePolicyText": "{\n \"rules\": [\n {\n \"rulePriority\": 1,\n \"description\": \"Expire images older than 14 days\",\n \"selection\": {\n \"tagStatus\": \"untagged\",\n \"countType\": \"sinceImagePushed\",\n \"countUnit\": \"days\",\n \"countNumber\": 14\n },\n \"action\": {\n \"type\": \"expire\"\n }\n }\n ]\n}\n", "status": "IN_PROGRESS" }

下列程式碼範例會示範如何使用tag-resource

AWS CLI

標記儲存庫

下列tag-resource範例會在hello-world儲存庫中使用索引鍵Stage和值Integ來設定標籤。

aws ecr tag-resource \ --resource-arn arn:aws:ecr:us-west-2:012345678910:repository/hello-world \ --tags Key=Stage,Value=Integ

此命令不會產生輸出。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考TagResource中的。

下列程式碼範例會示範如何使用untag-resource

AWS CLI

若要取消標記儲存庫

下列untag-resource範例會從hello-world儲存庫移除含有索引鍵Stage的標籤。

aws ecr untag-resource \ --resource-arn arn:aws:ecr:us-west-2:012345678910:repository/hello-world \ --tag-keys Stage

此命令不會產生輸出。

  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UntagResource中的。

下列程式碼範例會示範如何使用upload-layer-part

AWS CLI

上載圖層部分的步驟

以下內容將圖像層部分upload-layer-part上傳到layer-test存儲庫。

aws ecr upload-layer-part \ --repository-name layer-test \ --upload-id 6cb64b8a-9378-0e33-2ab1-b780fab8a9e9 \ --part-first-byte 0 \ --part-last-byte 8323314 \ --layer-part-blob file:///var/lib/docker/image/overlay2/layerdb/sha256/ff986b10a018b48074e6d3a68b39aad8ccc002cdad912d4148c0f92b3729323e/layer.b64

輸出:

{ "uploadId": "6cb64b8a-9378-0e33-2ab1-b780fab8a9e9", "registryId": "012345678910", "lastByteReceived": 8323314, "repositoryName": "layer-test" }
  • 如需 API 詳細資訊,請參閱AWS CLI 命令參考UploadLayerPart中的。