Amazon ECS 작업 정의 수정

이 단원에서는 CodeCatalyst 워크플로를 사용하여 Amazon Elastic Container Service (AmazonECS) 작업 정의 파일의 image 필드를 업데이트하는 방법을 설명합니다. 이 작업을 수행하려면 워크플로에 Render Amazon ECS 작업 정의 작업을 추가해야 합니다. 이 작업을 수행하면 작업 정의 파일의 이미지 필드가 런타임 시 워크플로에서 제공하는 Docker 이미지 이름으로 업데이트됩니다.

참고

이 작업을 사용하여 작업 정의 environment 필드를 환경 변수로 업데이트할 수도 있습니다.

주제

• 이 작업을 사용하는 경우
• 'Amazon ECS 작업 정의 렌더링' 작업 작동 방식
• 'Render Amazon ECS 작업 정의' 작업에 사용되는 런타임 이미지
• 예: Amazon ECS 태스크데프 수정
• 'Amazon ECS 작업 정의 렌더링' 작업 추가
• 업데이트된 작업 정의 파일 보기
• '렌더 아마존 ECS 태스크 정의' 변수
• 'Amazon ECS 작업 정의 렌더링' 작업 YAML

이 작업을 사용하는 경우

커밋 ID 또는 타임스탬프와 같은 동적 콘텐츠로 Docker 이미지를 빌드하고 태그를 지정하는 워크플로가 있는 경우 이 방법을 사용하십시오.

작업 정의 파일에 항상 동일하게 유지되는 이미지 값이 포함되어 있는 경우에는 이 작업을 사용하지 마세요. 이 경우 작업 정의 파일에 이미지 이름을 수동으로 입력할 수 있습니다.

'Amazon ECS 작업 정의 렌더링' 작업 작동 방식

워크플로의 빌드 및 Amazon에 배포 작업과 함께 Amazon ECS 작업 정의 렌더링 ECS 작업을 사용해야 합니다. 이러한 작업을 함께 수행하면 다음과 같이 작동합니다.

1. 빌드 작업은 Docker 이미지를 빌드하고 이름, 커밋 ID, 타임스탬프 또는 기타 동적 콘텐츠로 태그를 지정합니다. 예를 들어 빌드 작업은 다음과 같을 수 있습니다.

   MyECSWorkflow
     Actions:
       BuildAction:
         Identifier: aws/build@v1
         ...
         Configuration:
           Steps:
           # Build, tag, and push the Docker image...
             - Run: docker build -t MyDockerImage:${WorkflowSource.CommitId} .
             ...

   위 코드에서 docker build -t 디렉티브는 Docker 이미지를 빌드하고 작업 런타임 시 커밋 ID로 태그를 지정하도록 지시합니다. 생성된 이미지 이름은 다음과 같을 수 있습니다.

   MyDockerImage:a37bd7e

2. Render Amazon ECS 작업 정의 작업은 동적으로 생성된 이미지 이름MyDockerImage:a37bd7e, 을 작업 정의 파일에 다음과 같이 추가합니다.

   {
       "executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
       "containerDefinitions": [
           {
               "name": "codecatalyst-ecs-container",
               "image":  MyDockerImage:a37bd7e, 
               "essential": true,
               ...
               "portMappings": [
                   {
                       "hostPort": 80,
                       "protocol": "tcp",
                       "containerPort": 80
                   }
               ]
           }
       ],
   ...
   }

   선택적으로 Render Amazon ECS 작업 정의 작업에서 다음과 같이 작업 정의에 환경 변수를 추가하도록 할 수도 있습니다.

   {
     "executionRoleArn": "arn:aws:iam::account_ID:role/codecatalyst-ecs-task-execution-role",
     "containerDefinitions": [
       {
         "name": "codecatalyst-ecs-container",
         "image":  MyDockerImage:a37bd7e,
         ...
         "environment": [
           {
             name": "ECS_LOGLEVEL",
             value": "info"
           }
         ]
       }
     ],
   ...
   }

   환경 변수에 대한 자세한 내용은 Amazon Elastic Container Service 개발자 안내서의 환경 변수 지정을 참조하십시오.

3. Amazon에 배포 ECS 작업은 업데이트된 작업 정의 파일을 ECS Amazon에 등록합니다. 업데이트된 작업 정의 파일을 등록하면 새 이미지가 MyDockerImage:a37bd7e ECS Amazon에 배포됩니다.

'Render Amazon ECS 작업 정의' 작업에 사용되는 런타임 이미지

렌더 아마존 ECS 작업 정의 작업은 2022년 11월 이미지에서 실행됩니다. 자세한 내용은 활성 이미지 단원을 참조하십시오.