콘솔을 사용하여 Amazon ECS 서비스 업데이트 - Amazon Elastic Container Service

콘솔을 사용하여 Amazon ECS 서비스 업데이트

Amazon ECS 콘솔을 사용하여 Amazon ECS 서비스를 업데이트할 수 있습니다. 현재 서비스 구성이 미리 채워져 있습니다. 작업 정의, 원하는 작업 수, 용량 공급자 전략, 플랫폼 버전, 배포 구성 또는 이들의 조합을 업데이트할 수 있습니다.

블루/그린 배포 구성을 업데이트하는 방법에 대한 자세한 내용은 콘솔을 사용하여 Amazon ECS 블루/그린 배포 업데이트을 참조하세요.

콘솔 사용 시 다음 사항을 고려해야 합니다.

서비스를 일시적으로 중지하려면 원하는 작업을 0으로 설정합니다. 그런 다음, 서비스를 시작할 준비가 되면 원래 원하는 작업 수로 서비스를 업데이트합니다.

콘솔 사용 시 다음 사항을 고려해야 합니다.

  • AWS Command Line Interface를 사용하여 다음 파라미터 중 하나를 사용하는 서비스를 업데이트해야 합니다.

    • 블루/그린 배포

    • 서비스 검색 - 서비스 검색 구성만 볼 수 있습니다.

    • 사용자 지정 지표를 사용하는 추적 정책

    • 서비스 업데이트 - awsvpc 네트워크 구성 및 상태 확인 유예 기간을 업데이트할 수 없습니다.

    AWS CLI를 사용하여 서비스를 업데이트하는 방법에 대한 자세한 내용은 AWS Command Line Interface 참조의 update-service를 참조하세요.

  • 태스크 정의에서 컨테이너가 사용하는 포트를 변경하는 경우 업데이트된 포트와 함께 작동하도록 컨테이너 인스턴스에 대한 보안 그룹을 업데이트해야 합니다.

  • Amazon ECS는 Elastic Load Balancing 로드 밸런서 또는 Amazon ECS 컨테이너 인스턴스에 연결된 보안 그룹을 자동으로 업데이트하지 않습니다.

  • 서비스가 로드 밸런서를 사용하는 경우, 서비스를 생성할 때 정의한 로드 밸런서 구성은 콘솔을 사용하여 변경할 수 없습니다. 대신 AWS CLI 또는 SDK를 사용하여 로드 밸런서 구성을 수정할 수 있습니다. 구성을 변경하는 방법에 대한 자세한 내용은 Amazon Elastic Container Service API 참조의 UpdateService를 참조하세요.

  • 서비스에 대한 작업 정의를 업데이트하는 경우, 로드 밸런서 구성에서 지정한 컨테이너 이름 및 컨테이너 포트는 작업 정의에서 그대로 유지해야 합니다.

태스크 정의가 작업에서 사용되는 서비스에서 유지 관리되는 작업의 수와 같은 서비스 구성 파라미터 중 일부를 변경하기 위해 기존 서비스를 업데이트할 수 있습니다. 또는 작업에서 Fargate 시작 유형을 사용 중인 경우에는 서비스에서 사용되는 플랫폼 버전을 변경할 수 있습니다. Linux 플랫폼 버전을 사용하는 서비스는 Windows 플랫폼 버전을 사용하도록 업데이트할 수 없으며 그 반대의 경우도 마찬가지입니다. 더 많은 용량이 필요한 애플리케이션의 경우에는 서비스를 확장할 수 있습니다. 사용되지 않는 용량이 있어 축소해야 할 경우, 서비스에서 원하는 작업 수를 줄여 리소스를 해제할 수 있습니다.

작업에 업데이트된 컨테이너 이미지를 사용하려는 경우 해당 이미지로 새 태스크 정의 개정을 만들고 콘솔에서 새 배포 적용 옵션을 사용하여 서비스에 배포할 수 있습니다.

서비스 스케줄러는 (서비스에 대한 배포 구성에서) 최소 정상 상태 백분율 및 최대 백분율 파라미터를 사용하여 배포 전략을 결정합니다.

서비스가 롤링 업데이트(ECS) 배포 유형을 사용하는 경우, 최소 정상 상태 백분율(minimum healthy percent)은 배포 중에 RUNNING 상태를 유지해야 하는 서비스의 작업 수에 대한 하한을 나타내며, 원하는 작업 수(가장 가까운 정수로 반올림됨)의 백분율로 표시됩니다. EC2 시작 유형을 사용하는 작업이 서비스에 포함된 경우, 이 파라미터는 컨테이너 인스턴스가 DRAINING 상태에 있는 동안에도 적용됩니다. 추가 클러스터 용량을 사용하지 않고 배포하려면 이 파라미터를 사용합니다. 예를 들어 서비스에서 원하는 작업 수가 4개이고 최소 정상 상태 백분율이 50%일 경우 스케줄러가 새 작업 2개를 시작하기 전에 기존 작업 2개를 중지하여 클러스터 용량을 확보할 수 있습니다. 로드 밸런서를 사용하지 않는 서비스의 태스크는 RUNNING 상태일 경우에 정상 상태로 간주됩니다. 로드 밸런서를 사용하는 서비스의 태스크는 RUNNING 상태이고 로드 밸런서에 의해 정상 상태로 보고되는 경우에 정상 상태로 간주됩니다. 최소 정상 상태 백분율의 기본값은 100%입니다.

서비스가 롤링 업데이트(ECS) 배포 유형을 사용하는 경우, 최대 백분율 파라미터는 배포 중에 PENDING, RUNNING 또는 STOPPING 상태로 허용되는 서비스의 작업 수에 대한 상한을 나타내며, 원하는 작업 수(가장 가까운 정수로 반내림)의 백분율로 표시됩니다. EC2 시작 유형을 사용하는 작업이 서비스에 포함된 경우, 이 파라미터는 컨테이너 인스턴스가 DRAINING 상태에 있는 동안에도 적용됩니다. 이 파라미터를 사용하여 배포 배치 크기를 정의합니다. 예를 들면, 서비스에서 원하는 작업의 수가 4개이고 최대 백분율 값이 200%인 경우, 스케줄러가 기존 작업 4개를 중지하기 전에 새 작업 4개를 시작할 수 있습니다. 단, 이렇게 하는 데 필요한 클러스터 리소스를 사용할 수 있는 경우를 전제로 합니다. 최대 백분율의 기본값은 200%입니다.

서비스 스케줄러가 업데이트 도중 태스크를 교체할 때 서비스는 먼저 로드 밸런서(사용될 경우)에서 태스크를 제거하고 연결이 드레이닝될 때까지 대기합니다. 그런 다음, 태스크를 실행하는 컨테이너에 docker stop과 동등한 명령이 전송됩니다. 그 결과 SIGTERM 신호 및 30초 제한 시간이 발생하고, 이 제한 시간이 경과되면 SIGKILL이 전송되어 컨테이너가 강제로 중지됩니다. 컨테이너가 SIGTERM 신호를 정상적으로 처리하여 신호 수신 후 30초 이내에 종료할 경우 SIGKILL 신호가 전송되지 않습니다. 서비스 스케줄러는 최소 정상 상태 백분율 및 최대 백분율 파라미터 설정에 정의된 대로 태스크를 시작 및 중지합니다.

또한 서비스 스케줄러는 컨테이너 상태 확인 또는 로드 밸런서 대상 그룹 상태 확인이 실패한 후 비정상으로 확인된 작업을 대체합니다. 이러한 대체는 maximumPercent 및 desiredCount 서비스 정의 파라미터에 따라 달라집니다. 작업이 비정상으로 표시되면 서비스 스케줄러는 먼저 대체 작업을 시작합니다. 그러면 다음과 같이 진행됩니다.

  • 대체 작업의 상태가 HEALTHY인 경우 서비스 스케줄러는 비정상 작업을 중지합니다.

  • 대체 작업의 상태가 UNHEALTHY이면, 스케줄러는 비정상 대체 작업 또는 기존의 비정상 작업을 중지하여 총 작업 수가 desiredCount와 같아지도록 합니다.

maximumPercent 파라미터로 인해 스케줄러가 대체 작업을 먼저 시작하는 것이 제한되는 경우, 스케줄러는 비정상 작업을 한 번에 하나씩 임의로 중지하여 용량을 확보한 다음 대체 작업을 시작합니다. 비정상 작업이 모두 정상 작업으로 대체될 때까지 시작 및 중지 프로세스가 계속됩니다. 비정상 작업이 모두 대체되고 정상 작업만 실행 중인 경우 총 작업 수가 desiredCount를 초과하면 총 작업 수가 desiredCount와 같아질 때까지 정상 작업을 무작위로 중지합니다. maximumPercent 및 desiredCount에 대한 자세한 정보는 Service definition parameters를 참조하세요.

중요

태스크 정의에서 컨테이너가 사용하는 포트를 변경하는 경우 업데이트된 포트와 함께 작동하도록 컨테이너 인스턴스에 대한 보안 그룹을 업데이트해야 합니다.

서비스에 대한 태스크 정의를 업데이트하는 경우, 서비스를 만들 때 지정한 컨테이너 이름 및 컨테이너 포트가 태스크 정의에서 그대로 유지되어야 합니다.

Amazon ECS는 Elastic Load Balancing 로드 밸런서 또는 Amazon ECS 컨테이너 인스턴스에 연결된 보안 그룹을 자동으로 업데이트하지 않습니다.

서비스 업데이트 방법(Amazon ECS 콘솔)

  1. https://console.aws.amazon.com/ecs/v2에서 콘솔을 엽니다.

  2. 클러스터(Clusters) 페이지에서 클러스터를 선택합니다.

  3. 클러스터 세부 정보 페이지의 서비스 섹션에서 서비스 옆의 확인란을 선택하고 업데이트를 선택합니다.

  4. 서비스에서 새 배포를 시작하도록 하려면 Force new deployment(새 배포 적용)를 선택합니다.

  5. 작업 정의에서 사용할 작업 정의 패밀리 및 개정을 선택합니다.

    중요

    콘솔은 선택한 작업 정의 패밀리 및 개정이 정의된 컴퓨팅 구성과 호환되는지 검증합니다. 경고 메시지가 나타나면 작업 정의 호환성과 컴퓨팅 구성이 모두 선택되어 있는지 확인합니다.

  6. 원하는 작업에 서비스에서 실행할 작업 수를 입력합니다.

  7. 최소 실행 작업(Min running tasks)의 경우, 배포 시 RUNNING 상태를 유지해야 하는 서비스 내 작업 수에 대한 하한을 원하는 작업 수의 백분율(가장 가까운 정수로 올림)로 입력합니다. 자세한 내용은 배포 구성을 참조하세요.

  8. 최대 실행 작업(Max running tasks)의 경우, 배포 시 RUNNING 또는 PENDING 상태가 허용되는 서비스 내 작업 수에 대한 상한을 원하는 작업 수의 백분율(가장 가까운 정수로 내림)로 입력합니다.

  9. Amazon ECS에서 배포 오류를 탐지 및 처리하는 방법을 구성하려면 배포 오류 탐지(Deployment failure detection)를 펼친 다음, 옵션을 선택합니다.

    1. 작업을 시작할 수 없을 때 배포를 중지하려면 Use the Amazon ECS deployment circuit breaker(Amazon ECS 배포 회로 차단기 사용)를 선택합니다.

      배포 회로 차단기가 배포를 실패한 상태로 설정했을 때 소프트웨어가 마지막으로 완료한 배포로 자동 롤백하도록 하려면 실패 시 롤백을 선택합니다.

    2. 애플리케이션 지표를 기반으로 배포를 중지하려면 CloudWatch 경보 사용을 선택합니다. 그런 다음, CloudWatch 경보 이름에서 경보를 선택합니다. 새 경보를 생성하려면 CloudWatch 콘솔을 이동합니다.

      CloudWatch 경보가 배포를 실패한 상태로 설정할 때 소프트웨어가 마지막으로 완료한 배포 상태로 자동 롤백하도록 하려면 실패 시 롤백을 선택합니다.

  10. 컴퓨팅 옵션을 변경하려면 컴퓨팅 구성을 확장하고 다음을 수행합니다.

    1. AWS Fargate에 대한 서비스에서 플랫폼 버전(Platform version)에 새로운 버전을 선택합니다.

    2. 용량 공급자 전략을 사용하는 서비스의 경우 용량 공급자 전략에서 다음을 수행합니다.

      • 용량 공급자를 추가하려면 더 추가를 선택합니다. 그런 다음 용량 공급자에서 용량 공급자를 선택합니다.

      • 용량 공급자를 제거하려면 용량 공급자 오른쪽의 제거를 선택합니다.

      Auto Scaling 그룹 공급자를 사용하는 서비스는 Fargate 용량 공급자를 사용하도록 업데이트할 수 없습니다. Fargate 용량 공급자를 사용하는 서비스는 Auto Scaling 그룹 공급자를 사용하도록 업데이트할 수 없습니다.

  11. (선택 사항) 서비스 Auto Scaling을 구성하려면 서비스 Auto Scaling을 확장하고 다음 파라미터를 지정합니다.

    1. 서비스 Auto Scaling을 사용하려면 서비스 Auto Scaling(Service auto scaling)을 선택합니다.

    2. 작업의 최소 개수에 서비스 Auto Scaling에서 사용할 작업 수의 하한을 입력합니다. 바람직한 수는 이 숫자 이내여야 합니다.

    3. 작업의 최대 개수에 서비스 Auto Scaling에서 사용할 작업 수의 상한을 입력합니다. 바람직한 수는 이 숫자 이내여야 합니다.

    4. 정책 유형을 선택합니다. 규모 조정 정책 유형에서 다음 옵션 중 하나를 선택합니다.

      사용할 정책 유형 수행할 작업

      대상 추적

      1. 조정 정책 유형(Scaling policy type)에서 대상 추적(Target tracking)을 선택합니다.

      2. 정책 이름(Policy name)에 정책 이름을 입력합니다.

      3. ECS 서비스 지표에서 다음 지표 중 하나를 선택합니다.

        • ECSServiceAverageCPUUtilization - 서비스의 평균 CPU 사용률입니다.

        • ECSServiceAverageMemoryUtilization - 서비스의 평균 메모리 사용률입니다.

        • ALBRequestCountPerTarget - Application Load Balancer 대상 그룹에서 대상별로 완료된 요청 수입니다.

      4. 대상 값(Target value)에 서비스가 선택된 지표에 유지하는 값을 입력합니다.

      5. 스케일 아웃 휴지 기간에 스케일 아웃 활동(작업 추가) 이후 다른 스케일 아웃 활동이 시작되기 전 경과해야 하는 시간(초)을 입력합니다.

      6. 스케일 인 휴지 기간에 스케일 인 활동(작업 제거) 이후 다른 스케일 인 활동이 시작되기 전 경과해야 하는 시간(초)을 입력합니다.

      7. 정책에서 스케일 인 활동을 수행하지 않도록 방지하려면 스케일 인 비활성화(Turn off scale-in)를 선택합니다.

      8. • (선택 사항) 늘어난 트래픽에 맞춰 조정 정책을 스케일 아웃하려고 하지만 트래픽이 감소해도 스케일 인할 필요가 없게 하려는 경우 스케일 인 끄기를 선택합니다.
      단계 조정

      1. 조정 정책 유형(Scaling policy type)에서 단계 조정(Step scaling)을 선택합니다.

      2. 정책 이름에 정책 이름을 입력합니다.

      3. [Alarm name]에 경보의 고유한 이름을 입력합니다.

      4. Amazon ECS 서비스 지표에서 경보에 사용할 서비스 지표를 선택합니다.

      5. 통계에서 경보 통계를 선택합니다.

      6. 기간에서 경보의 기간을 선택합니다.

      7. 경보 조건에서 선택한 지표를 정의된 임계값과 비교하는 방법을 선택합니다.

      8. 지표 비교 임계값 및 경보 시작을 위한 평가 기간에 경보에 사용되는 임계값과 임계값을 평가할 기간을 입력합니다.

      9. 조정 작업에서 다음을 수행합니다.

        • 작업에서 서비스에 대해 작업을 특정 원하는 수를 추가, 제거 또는 설정할지 여부를 선택합니다.

        • 작업을 추가하거나 제거하려는 경우 값에 조정 작업이 시작될 때 추가 또는 제거할 작업 수(또는 기존 작업에 대한 비율)를 입력합니다. 원하는 수 설정을 선택한 경우 작업 수를 입력합니다. 유형에서 값이 정수인지, 아니면 기존의 원하는 수에 대한 백분율 값인지 선택합니다.

        • 하한 및 상한에 단계 조정의 하한과 상한을 입력합니다. 기본적으로 추가 정책의 하한은 경보 임계값이고 상한은 양(+)의 무한대입니다. 기본적으로 제거 조정의 상한은 경보 임계값이고 하한은 음(-)의 무한대입니다.

        • (선택 사항) 조정 옵션을 추가합니다. 새 스케일링 액션 추가를 선택하고 조정 작업 단계를 반복합니다.

        • 휴지 기간에 이전 조정 활동이 적용될 때까지 대기하는 시간(초)을 입력합니다. 추가 정책의 경우 이 시간은 스케일 아웃 활동 이후 조정 정책이 스케일 인 활동을 차단하고 한 번에 스케일 아웃할 수 있는 작업 수를 제한하는 시간입니다. 제거 정책의 경우 스케일 인 활동 이후 다른 스케일 인 활동을 시작하기 전까지 경과해야 하는 시간입니다.

  12. (선택 사항) Service Connect를 사용하려면 Turn on Service Connect(Service Connect 켜기)를 선택하고 다음을 지정합니다.

    1. Service Connect configuration(Service Connect 구성)에서 클라이언트 모드를 지정합니다.

      • 서비스에서 네임스페이스의 다른 서비스에만 연결하면 되는 네트워크 클라이언트 애플리케이션을 실행하는 경우 Client side only(클라이언트 측만)를 선택합니다.

      • 서비스가 네트워크 또는 웹 서비스 애플리케이션을 실행하고 이 서비스에 대한 엔드포인트를 제공해야 하며, 네임스페이스의 다른 서비스에 연결해야 하는 경우 Client and server(클라이언트 및 서버)를 선택합니다.

    2. 기본 클러스터 네임스페이스가 아닌 네임스페이스를 사용하려면 Namespace(네임스페이스)에서 서비스 네임스페이스를 선택합니다.

  13. 작업에서 배포 시 구성과 호환되는 데이터 볼륨을 사용하는 경우 볼륨을 확장하여 볼륨을 구성할 수 있습니다.

    볼륨 이름과 볼륨 유형은 작업 정의 개정을 생성할 때 구성되며 서비스를 업데이트할 때는 변경할 수 없습니다. 볼륨 이름과 유형을 업데이트하려면 새 작업 정의 개정을 생성하고 새 개정을 사용해 서비스를 업데이트해야 합니다.

    이 볼륨 유형을 구성하는 방법 조치

    Amazon EBS

    1. EBS 볼륨 유형에서 작업에 연결할 EBS 볼륨 유형을 선택합니다.

    2. 크기(GiB)에 유효한 볼륨 크기 값을 기비바이트(GiB) 단위로 입력합니다. 최소 1GiB 및 최대 16,384GiB 볼륨 크기를 지정할 수 있습니다. 스냅샷 ID를 제공하지 않는 한, 이 값은 필수입니다.

    3. IOPS의 경우 볼륨이 제공해야 하는 최대 초당 입출력 작업(IOPS) 수를 입력합니다. 이 값은 io1, io2, gp3 볼륨 유형에서만 구성할 수 있습니다.

    4. 처리량(MiB/s)에 볼륨에서 제공해야 하는 처리량을 초당 메비바이트 단위(MiBps 또는 MiB/s)로 입력합니다. 이 값은 gp3 볼륨 유형에서만 구성 가능합니다.

    5. 스냅샷 ID에서 기존 Amazon EBS 볼륨 스냅샷을 선택하거나 스냅샷에서 볼륨을 생성하려는 경우 스냅샷의 ARN을 입력합니다. 스냅샷 ID를 선택하거나 입력하지 않고 비어 있는 새 볼륨을 생성할 수도 있습니다.

    6. 파일 시스템 유형에서 볼륨의 데이터 스토리지 및 검색에 사용할 파일 시스템 유형을 선택합니다. 운영 체제 기본값 또는 특정 파일 시스템 유형을 선택할 수 있습니다. Linux의 기본값은 XFS입니다. 스냅샷에서 생성된 볼륨의 경우 스냅샷을 생성할 때 볼륨에서 사용하던 것과 동일한 파일 시스템 유형을 지정해야 합니다. 파일 시스템 유형이 일치하지 않으면 작업이 시작되지 않습니다.

    7. 인프라 역할에서 Amazon ECS가 작업에 대한 Amazon EBS 볼륨을 관리할 수 있도록 하는 데 필요한 권한이 있는 IAM 역할을 선택합니다. AmazonECSInfrastructureRolePolicyForVolumes 관리형 정책을 역할에 연결하거나 정책을 지침으로 사용하여 특정 요구 사항에 맞는 권한을 보유한 자체 정책을 생성하고 연결할 수 있습니다. 필요한 권한에 대한 자세한 내용은 Amazon ECS 인프라 IAM 역할 섹션을 참조하세요.

    8. 암호화에서 Amazon EBS 암호화를 기본 설정으로 사용하려면 기본값을 선택합니다. 계정에 암호화 기본 제공이 구성된 경우 설정에 지정된 AWS Key Management Service(AWS KMS) 키로 볼륨이 암호화됩니다. 기본값을 선택하고 Amazon EBS 기본 암호화가 켜져 있지 않으면 볼륨이 암호화되지 않습니다.

      사용자 지정을 선택하면 볼륨 암호화에 대해 원하는 AWS KMS key를 지정할 수 있습니다.

      없음을 선택한 경우 암호화가 기본적으로 구성되지 않았거나 암호화된 스냅샷에서 볼륨을 생성하지 않으면 볼륨이 암호화되지 않습니다.

    9. 암호화에 사용자 지정을 선택한 경우 사용하려는 AWS KMS key를 지정해야 합니다. KMS 키에서 AWS KMS key를 선택하거나 키 ARN을 입력합니다. 대칭 고객 관리형 키를 사용하여 볼륨을 암호화하려는 경우 AWS KMS key 정책에 올바른 권한이 정의되었는지 확인합니다. 자세한 내용은 Data encryption for Amazon EBS volumes를 참조하세요.

    10. (선택 사항) 태그에서 작업 정의 또는 서비스의 태그를 전파하거나 자체 태그를 제공하여 Amazon EBS 볼륨에 태그를 추가할 수 있습니다.

      작업 정의에서 태그를 전파하려면 태그 전파 시작에서 작업 정의를 선택합니다. 서비스에서 태그를 전파하려면 태그 전파 시작에서 서비스를 선택합니다. 전파 안 함을 선택하거나 값을 선택하지 않으면 태그가 전파되지 않습니다.

      고유한 태그를 제공하려면 태그 추가를 선택하고 추가하는 각 태그의 키와 값을 제공합니다.

      Amazon EBS 볼륨 태그 지정에 대한 자세한 내용은 Amazon EBS 볼륨 태그 지정을 참조하세요.

  14. (선택 사항) 서비스를 식별하려면 태그(Tags) 섹션을 펼친 다음, 태그를 구성합니다.

    • [태그 추가] 태그 추가를 선택하고 다음을 수행합니다.

      • 키에서 키 이름을 입력합니다.

      • 값에 키 값을 입력합니다.

    • [태그 제거] 태그 옆에 있는 태그 제거를 선택합니다.

  15. 업데이트를 선택합니다.