本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
示例:修改 Amazon ECS 任務定義
以下是完整工作流程的範例,其中包括 Render Amazon ECS 任務定義動作以及建置和部署動作。工作流程的目的是建立 Docker 映像檔並將其部署到您的 Amazon ECS 叢集中。工作流程由下列依序執行的建置區塊組成:
-
觸發器 — 當您將變更推送至來源儲存庫時,此觸發器會自動啟動工作流程執行。關於觸發條件的詳細資訊,請參閱 使用觸發器啟動工作流程自動執行。
-
構建操作(
BuildDocker
)— 在觸發器上,該操作使用 Docker 文件構建 Docker 映像,使用提交 ID 對其進行標記,然後將圖像推送到 Amazon。ECR如需建置動作的詳細資訊,請參閱以工作流程建置。 -
Render Amazon ECS 任務定義動作 (
RenderTaskDef
) — 建置動作完成後,此動作會使用包含正確提交 ID 的image
欄taskdef.json
位值來更新位於來源儲存庫根目錄中的現有項目。它會以新的檔案名稱 (task-definition-random-string.json
) 儲存更新的檔案,然後建立包含此檔案的輸出加工品。render 動作也會產生名為的變數,task-definition
並將其設定為新工作定義檔案的名稱。工件和變量將用於部署操作,這是下一個。 -
部署到 Amazon ECS 動作 (
DeployToECS
) — 完成渲染 Amazon ECS 任務定義動作後,「部署到 Amazon」ECS 動作會尋找渲染動作 (TaskDefArtifact
) 產生的輸出成品,在其中尋找task-definition-random-string.json
檔案,然後將其註冊到您的 Amazon ECS 服務。然後,Amazon ECS 服務會遵循task-definition-random-string.json
檔案中的指示,在 Amazon 叢集中執行 Amazon ECS 任務及關聯的 Docker 映像容器。ECS
Name: codecatalyst-ecs-workflow SchemaVersion: 1.0 Triggers: - Type: PUSH Branches: - main Actions: BuildDocker: Identifier: aws/build@v1 Environment: Name: codecatalyst-ecs-environment Connections: - Name: codecatalyst-account-connection Role: codecatalyst-ecs-build-role Inputs: Variables: - Name: REPOSITORY_URI Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo - Name: IMAGE_TAG Value: ${WorkflowSource.CommitId} Configuration: Steps: #pre_build: - Run: echo Logging in to Amazon ECR... - Run: aws --version - Run: aws ecr get-login-password --region us-east-2 | docker login --username AWS --password-stdin 111122223333.dkr.ecr.us-east-2.amazonaws.com #build: - Run: echo Build started on `date` - Run: echo Building the Docker image... - Run: docker build -t $REPOSITORY_URI:latest . - Run: docker tag $REPOSITORY_URI:latest $REPOSITORY_URI:$IMAGE_TAG #post_build: - Run: echo Build completed on `date` - Run: echo Pushing the Docker images... - Run: docker push $REPOSITORY_URI:latest - Run: docker push $REPOSITORY_URI:$IMAGE_TAG RenderTaskDef: DependsOn: - BuildDocker Identifier: aws/ecs-render-task-definition@v1 Inputs: Variables: - Name: REPOSITORY_URI Value: 111122223333.dkr.ecr.us-east-2.amazonaws.com/codecatalyst-ecs-image-repo - Name: IMAGE_TAG Value: ${WorkflowSource.CommitId} Configuration: task-definition: taskdef.json container-definition-name: codecatalyst-ecs-container image: $REPOSITORY_URI:$IMAGE_TAG # The output artifact contains the updated task definition file. # The new file is prefixed with 'task-definition'. # The output variable is set to the name of the updated task definition file. Outputs: Artifacts: - Name: TaskDefArtifact Files: - "task-definition*" Variables: - task-definition DeployToECS: Identifier: aws/ecs-deploy@v1 Environment: Name: codecatalyst-ecs-environment Connections: - Name: codecatalyst-account-connection Role: codecatalyst-ecs-deploy-role #Input artifact contains the updated task definition file. Inputs: Sources: [] Artifacts: - TaskDefArtifact Configuration: region: us-east-2 cluster: codecatalyst-ecs-cluster service: codecatalyst-ecs-service task-definition: ${RenderTaskDef.task-definition}