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

클래식 콘솔을 사용하여 서비스 업데이트

중요

Amazon ECS는 서비스 업데이트를 위한 새로운 콘솔 환경을 제공해 왔습니다. 자세한 정보는 새 콘솔을 사용하여 서비스 업데이트을 참조하세요.

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

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

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

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

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

서비스가 EC2 시작 유형을 사용하는 블루/그린(CODE_DEPLOY) 배포 유형 및 태스크를 사용하는 경우, 최소 정상 상태 백분율(minimum healthy percent)최대 백분율(maximum percent) 값은 기본값으로 설정됩니다. 이러한 기본값들은 컨테이너 인스턴스가 DRAINING 상태에 있을 때 RUNNING 상태로 유지되는 서비스의 작업 수에 대한 상한 및 하한을 정의하는 용도로만 사용됩니다. 서비스의 작업이 Fargate 시작 유형을 사용할 경우, 최소 정상 상태 백분율 및 최대 백분율 값은 사용되지 않습니다. 이들 값은 현재 서비스를 설명할 때 표시됩니다.

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

중요

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

AWS CLI 또는 SDK를 사용하여 로드 밸런서 구성을 수정할 수 있습니다. 구성을 변경하는 방법에 대한 자세한 정보는 Amazon Elastic Container Service API Reference(Amazon Elastic Container Service API 레퍼런스)의 UpdateService를 참조하세요.

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

서비스 로드 밸런서 구성에 연결된 컨테이너 이름 또는 컨테이너 포트를 변경하려면 새 서비스를 만들어야 합니다.

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

실행 서비스를 업데이트하려면

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

  2. 탐색 모음에서 클러스터가 위치한 리전을 선택합니다.

  3. 탐색 창에서 클러스터(Clusters)를 선택합니다.

  4. 클러스터 페이지에서 서비스가 상주하는 클러스터의 이름을 선택합니다.

  5. 클러스터: 이름 페이지에서 서비스(Services)를 선택합니다.

  6. 업데이트할 서비스의 왼쪽에서 확인란을 선택하고 업데이트(Update)를 선택합니다.

  7. 서비스 구성 페이지에 해당 서비스 정보가 미리 채워집니다. 태스크 정의, 용량 공급자 전략, 플랫폼 버전, 배포 구성, 원하는 작업 수(또는 이들의 조합)를 변경합니다. 서비스에서 새 배포를 시작하여 새 구성을 사용하는 모든 태스크를 중지했다가 다시 실행하도록 하려면 새 배포 적용(Force new deployment)을 선택합니다. 서비스 구성 변경을 마치면 다음 단계(Next step)를 선택합니다.

    참고

    오토 스케일링 용량 공급자를 사용하는 서비스는 Fargate 용량 공급자를 사용하도록 업데이트할 수 없고 그 반대도 불가능합니다.

    Linux 플랫폼 버전을 사용하는 서비스는 Windows 플랫폼 버전을 사용하도록 업데이트할 수 없으며 그 반대의 경우도 마찬가지입니다.

  8. 배포 구성(Configure deployments) 페이지에서 서비스가 블루/그린 배포 유형을 사용하는 경우, 서비스 배포의 구성 요소가 미리 채워집니다. 다음 설정을 확인합니다.

    1. 애플리케이션 이름(Application name)의 경우, 서비스가 포함된 CodeDeploy 애플리케이션을 선택합니다.

    2. 배포 그룹 이름(Deployment group name)의 경우, 서비스가 속한 CodeDeploy 배포 그룹을 선택합니다.

    3. 서비스 배포의 새 개정판의 일부로서 실행할 배포 수명 주기 이벤트 후크 및 관련 Lambda 함수를 선택합니다. 다음과 같은 수명 주기 후크를 사용할 수 있습니다.

      • BeforeInstall – 배포 수명 주기 이벤트 후크를 사용하여 교체 작업 세트가 생성되기 전에 Lambda 함수를 호출합니다. 이 수명 주기 이벤트에서 Lambda 함수의 결과는 롤백을 시작하지 않습니다.

      • AfterInstall – 배포 수명 주기 이벤트 후크를 사용하여 교체 작업 세트가 생성된 후에 Lambda 함수를 호출합니다. 이 수명 주기 이벤트에서 Lambda 함수의 결과는 롤백을 시작하지 않습니다.

      • BeforeAllowTraffic – 배포 수명 주기 이벤트 후크를 사용하여 프로덕션 트래픽이 교체 작업 세트로 다시 라우팅되기 전에 Lambda 함수를 호출합니다. 이 수명 주기 이벤트에서 Lambda 함수의 결과는 롤백을 시작하지 않습니다.

      • AfterAllowTraffic – 배포 수명 주기 이벤트 후크를 사용하여 프로덕션 트래픽이 교체 작업 세트로 다시 라우팅된 후에 Lambda 함수를 호출합니다. 이 수명 주기 이벤트에서 Lambda 함수의 결과는 롤백을 시작하지 않습니다.

      자세한 정보는 AWS CodeDeploy 사용 설명서AppSpec '후크' 섹션을 참조하세요.

  9. 다음 단계(Next step)를 선택합니다.

  10. 네트워크 구성 페이지에 해당 네트워크 정보가 미리 채워집니다. 로드 밸런싱(Load balancing) 섹션에서 서비스가 블루/그린 배포 유형을 사용하는 경우, 대상 그룹과 연결할 리스너를 선택합니다. 상태 확인 유예 기간을 변경하고(필요한 경우) 다음 단계(Next step)를 선택합니다.

  11. (선택 사항) 서비스 자동 크기 조정을 사용하여 CloudWatch 경보에 대응해 자동으로 서비스를 확장/축소할 수 있습니다.

    1. 구성 옵션(Optional configurations)에서 서비스 자동 크기 조정 구성(Configure Service Auto Scaling)을 선택합니다.

    2. 5단계: 서비스 자동 크기 조정을 사용하도록 서비스 구성 항목으로 이동합니다.

    3. 해당 섹션의 단계를 모두 수행한 후 돌아옵니다.

  12. 서비스 업데이트(Update Service)를 선택하여 서비스 업데이트를 마칩니다.