Amazon EC2 Auto CodeDeploy Scaling과의 통합

CodeDeploy 사용자가 정의한 조건에 따라 Amazon EC2 인스턴스를 자동으로 시작하는 AWS 서비스인 Amazon EC2 Auto Scaling을 지원합니다. 이러한 조건에는 지정된 시간 간격에서 CPU 사용률, 디스크 읽기 또는 쓰기, 인바운드 또는 아웃바운드 네트워크 트래픽에 대해 초과되는 제한이 포함될 수 있습니다. Amazon EC2 Auto Scaling은 더 이상 필요하지 않은 경우 해당 인스턴스를 종료합니다. 자세한 내용은 Amazon EC2 Auto Scaling 사용 설명서의 Amazon EC2 Auto Scaling이란?을 참조하세요.

Amazon EC2 Auto Scaling CodeDeploy 그룹의 일부로 새 Amazon EC2 인스턴스를 시작하면 수정 버전을 새 인스턴스에 자동으로 배포할 수 있습니다. Elastic Load Balancing 로드 밸런서에 CodeDeploy 등록된 Amazon EC2 Auto Scaling 인스턴스를 사용하여 배포를 조정할 수도 있습니다. 자세한 내용은 Integrating CodeDeploy with Elastic Load Balancing 및 CodeDeploy Amazon EC2 배포를 위한 Elastic Load Balancing에서 로드 밸런서를 설정합니다. 섹션을 참조하세요.

참고

여러 배포 그룹과 단일 Amazon EC2 Auto Scaling 그룹을 연결하는 경우 문제가 발생할 수 있습니다. 한 개의 배포에 실패하면 예를 들어, 인스턴스가 종료되기 시작하지만 실행 중인 다른 배포는 시간 초과까지 한 시간 가량 걸릴 수 있습니다. 자세한 내용은 내부: 단일 Amazon EC2 Auto Scaling 그룹으로 여러 배포 그룹 연결 피하기 CodeDeploy 및 Amazon EC2 Auto Scaling 통합을 참조하십시오.

Amazon EC2 Auto Scaling 그룹에 CodeDeploy 애플리케이션 배포

Amazon EC2 Auto Scaling 그룹에 CodeDeploy 애플리케이션 수정 버전을 배포하려면:

1. Amazon EC2 Auto Scaling 그룹이 Amazon S3와 연동할 수 있도록 허용하는 IAM 인스턴스 프로파일을 만들거나 찾습니다. 자세한 정보는 4단계: Amazon EC2 인스턴스에 대한 IAM 인스턴스 프로파일 만들기을 참조하세요.

   참고

   GitHub 리포지토리의 수정 버전을 Amazon EC2 Auto Scaling 그룹에 CodeDeploy 배포하는 데에도 사용할 수 있습니다. Amazon EC2 인스턴스에는 여전히 IAM 인스턴스 프로필이 필요하지만 리포지토리에서 프로필을 배포하기 위한 추가 권한은 필요하지 않습니다. GitHub

2. 시작 구성이나 템플릿에서 IAM 인스턴스 프로파일을 지정하여 Amazon EC2 Auto Scaling 그룹을 생성하거나 사용합니다. 자세한 내용은 Amazon EC2 인스턴스에서 실행되는 애플리케이션의 IAM 역할을 참조하세요.

3. Amazon EC2 Auto CodeDeploy Scaling 그룹을 포함하는 배포 그룹을 생성할 수 있는 서비스 역할을 생성하거나 찾습니다.

4. Amazon EC2 Auto Scaling 그룹 이름 CodeDeploy, 서비스 역할 및 기타 몇 가지 옵션을 지정하여 배포 그룹을 생성합니다. 자세한 내용은 인 플레이스(in-place) 배포에 사용할 수 있는 배포 그룹 만들기(콘솔) 또는 인 플레이스(in-place) 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)을 참조하세요.

5. Amazon EC2 Auto Scaling 그룹이 포함된 배포 그룹에 수정 버전을 배포하는 데 사용합니다 CodeDeploy .

자세한 정보는 자습서: Auto Scaling 그룹에 애플리케이션을 배포하는 데 사용합니다 CodeDeploy .을 참조하세요.

Auto Scaling 확장 이벤트 중 종료 배포 활성화

종료 배포는 Auto Scaling 확장 이벤트가 발생할 때 자동으로 활성화되는 CodeDeploy 배포 유형입니다. CodeDeploy Auto Scaling 서비스가 인스턴스를 종료하기 직전에 종료 배포를 수행합니다. 종료 배포 중에는 아무것도 배포하지 CodeDeploy 않습니다. 대신 수명 주기 이벤트를 생성하며, 이를 자체 스크립트에 연결하여 사용자 지정 종료 기능을 활성화할 수 있습니다. 예를 들어, 인스턴스가 종료되기 전에 애플리케이션을 정상적으로 종료하는 스크립트에 ApplicationStop 수명 주기 이벤트를 연결할 수 있습니다.

종료 배포 중에 CodeDeploy 생성되는 라이프사이클 이벤트 목록은 을 참조하십시오수명 주기 이벤트 후크 가용성.

어떤 이유로든 종료 CodeDeploy 배포가 실패하는 경우 인스턴스 종료를 계속할 수 있습니다. 즉, 수명 주기 이벤트의 전체 세트 (또는 일부) 를 완료하지 CodeDeploy 않았더라도 인스턴스가 종료됩니다.

종료 배포를 활성화하지 않은 경우, Auto Scaling 서비스는 스케일 인 이벤트가 발생할 때 여전히 Amazon EC2 인스턴스를 CodeDeploy 종료하지만 수명 주기 이벤트를 생성하지는 않습니다.

참고

종료 배포의 활성화 여부에 관계없이, 배포가 진행 중인 동안 Auto Scaling 서비스가 Amazon EC2 인스턴스를 종료하면 Auto Scaling에서 생성되는 수명 주기 이벤트와 서비스 간에 경쟁 조건이 발생할 수 있습니다. CodeDeploy CodeDeploy 예를 들어, Terminating 수명 주기 이벤트 (Auto Scaling 서비스에서 생성) 가 ApplicationStart 이벤트 ( CodeDeploy 배포에서 생성됨) 를 재정의할 수 있습니다. 이 시나리오에서는 Amazon EC2 인스턴스 종료 또는 배포에 장애가 발생할 수 있습니다. CodeDeploy

종료 CodeDeploy 배포를 수행할 수 있도록 하려면

• 배포 그룹을 생성하거나 업데이트할 때 Auto Scaling 그룹에 종료 후크 추가 확인란을 선택합니다. 자세한 내용은 인 플레이스(in-place) 배포에 사용할 수 있는 배포 그룹 만들기(콘솔) 또는 EC2/온프레미스 블루/그린 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)을 참조하세요.

  이 확인란을 활성화하면 CodeDeploy CodeDeploy 배포 그룹을 만들거나 업데이트할 때 지정하는 Auto Scaling 그룹에 Auto Scaling 수명 주기 후크가 설치됩니다. 이 후크를 종료 후크라고 하며 종료 배포를 활성화합니다.

종료 후크가 설치되면 다음과 같이 스케일 인(종료) 이벤트가 전개됩니다.

1. Auto Scaling 서비스(또는 간단히 자동 확장)는 스케일 인 이벤트가 발생해야 한다고 판단하고 EC2 인스턴스를 종료하기 위해 EC2 서비스에 연락합니다.

2. EC2 서비스가 EC2 인스턴스를 종료하기 시작합니다. 인스턴스는 Terminating 상태가 되고 그 다음엔 Terminating:Wait 상태가 됩니다.

3. 도중에 Terminating:Wait Auto Scaling은 에서 설치한 종료 후크를 포함하여 Auto Scaling 그룹에 연결된 모든 라이프사이클 후크를 실행합니다 CodeDeploy.

4. 종료 후크는 폴링된 Amazon SQS 대기열에 알림을 보냅니다. CodeDeploy

5. 알림을 받으면 메시지를 CodeDeploy 파싱하고 일부 검증을 수행한 다음 종료 배포를 수행합니다.

6. 종료 배포가 실행되는 동안 5분마다 Auto Scaling에 하트비트를 CodeDeploy 전송하여 인스턴스가 아직 작업 중임을 알립니다.

7. 지금까지 EC2 인스턴스는 여전히 Terminating:Wait 상태(또는 Auto Scaling group 워밍 풀을 활성화한 경우 Warmed:Pending:Wait 상태일 수 있음)에 있습니다.

8. 배포가 완료되면 종료 배포의 성공 여부에 관계없이 Auto CONTINUE Scaling에 EC2 종료 프로세스를 알립니다. CodeDeploy

Amazon EC2 Auto Scaling과 함께 작동하는 방식 CodeDeploy

Auto Scaling 그룹을 포함하도록 CodeDeploy 배포 그룹을 만들거나 업데이트하면 CodeDeploy 서비스 역할을 사용하여 Auto Scaling 그룹에 CodeDeploy 액세스한 다음 Auto Scaling 수명 주기 후크를 Auto Scaling 그룹에 설치합니다.

참고

Auto Scaling 라이프사이클 후크는 이 가이드에서 생성하고 설명하는 라이프사이클 이벤트 (라이프사이클 이벤트 후크라고도 함) CodeDeploy 와 다릅니다. AppSpec '후크' 섹션

CodeDeploy 설치되는 Auto Scaling 라이프사이클 후크는 다음과 같습니다.

• 시작 후크 — 이 후크는 Auto Scale-out 이벤트가 진행 중이며 시작 배포를 CodeDeploy 시작해야 함을 알립니다 CodeDeploy .

  론치 배포 시: CodeDeploy

  • 애플리케이션의 개정 버전을 스케일 아웃 인스턴스에 배포합니다.

  • 배포 진행 상황을 나타내는 수명 주기 이벤트를 생성합니다. 이러한 수명 주기 이벤트를 자체 스크립트에 연결하여 사용자 지정 시작 기능을 활성화할 수 있습니다. 자세한 내용은 수명 주기 이벤트 후크 가용성 표를 참조하세요.

  시작 후크 및 관련 시작 배포는 항상 활성화되어 있으며 끌 수 없습니다.

• 종료 후크 — 이 선택적 후크는 Auto Scaling 확장 이벤트가 진행 중이며 종료 배포를 CodeDeploy 시작해야 함을 알립니다 CodeDeploy .

  종료 배포 중에 수명 주기 이벤트를 CodeDeploy 생성하여 인스턴스 종료 진행 상황을 표시합니다. 자세한 정보는 Auto Scaling 확장 이벤트 중 종료 배포 활성화을 참조하세요.

주제

• 라이프사이클 후크를 CodeDeploy 설치한 후에는 어떻게 사용되나요?
• Amazon EC2 Auto Scaling 그룹의 CodeDeploy 이름은 어떻게 지정됩니까?
• 사용자 지정 수명 주기 후크의 실행 순서
• 배포 중 이벤트 확장
• 배포 중에 스케일 인 이벤트
• AWS CloudFormation cfn-init 스크립트의 이벤트 순서

라이프사이클 후크를 CodeDeploy 설치한 후에는 어떻게 사용되나요?

시작 및 종료 라이프사이클 후크가 설치되면 Auto Scaling 그룹 스케일 아웃 및 스케일 인 이벤트 CodeDeploy 중에 각각 사용됩니다.

스케일 아웃(시작) 이벤트는 다음과 같이 전개됩니다.

1. Auto Scaling 서비스(또는 단순히 Auto Scaling)가 확장 이벤트가 발생해야 한다고 판단하면 EC2 서비스에 연결하여 새 EC2 인스턴스를 시작합니다.

2. EC2 서비스는 새 EC2 인스턴스를 시작합니다. 인스턴스는 Pending 상태가 되고 그 다음엔 Pending:Wait 상태가 됩니다.

3. 도중에 Pending:Wait Auto Scaling은 에서 설치한 시작 후크를 포함하여 Auto Scaling 그룹에 연결된 모든 라이프사이클 후크를 실행합니다 CodeDeploy.

4. 시작 후크는 폴링된 Amazon SQS 대기열에 알림을 보냅니다. CodeDeploy

5. 알림을 받으면 메시지를 CodeDeploy 파싱하고 일부 검증을 수행한 다음 시작 배포를 시작합니다.

6. 시작 배포가 실행되는 동안 5분마다 Auto Scaling에 하트비트를 CodeDeploy 전송하여 인스턴스가 아직 작업 중임을 알립니다.

7. 지금까지 EC2 인스턴스는 여전히 Pending:Wait 상태입니다.

8. 배포가 완료되면 배포의 성공 CONTINUE 또는 ABANDON 실패 여부에 따라 Auto Scaling에 EC2 시작 프로세스 중 하나를 실행하도록 CodeDeploy 지시합니다.

   • CodeDeploy 표시가 CONTINUE 나타나면 Auto Scaling은 다른 후크가 완료될 때까지 기다리거나 인스턴스를 Pending:Proceed 및 InService 상태로 전환하여 시작 프로세스를 계속합니다.

   • 이 CodeDeploy ABANDON 표시되면 Auto Scaling은 EC2 인스턴스를 종료하고 필요한 경우 Auto Scaling의 원하는 용량 설정에 정의된 대로 원하는 인스턴스 수를 충족하기 위해 시작 절차를 다시 시작합니다.

스케일 인(종료) 이벤트는 다음과 같이 전개됩니다.

Auto Scaling 확장 이벤트 중 종료 배포 활성화를 참조하세요.

Amazon EC2 Auto Scaling 그룹의 CodeDeploy 이름은 어떻게 지정됩니까?

EC2/온프레미스 컴퓨팅 플랫폼을 기반으로 한 블루/그린 배포 과정에서는 인스턴스를 대체(그린) 환경에 추가하는 옵션이 두 가지입니다.

• 이미 존재하거나, 혹은 수동으로 생성한 인스턴스를 사용합니다.

• 지정한 Amazon EC2 Auto Scaling 그룹의 설정을 사용하여 새 Amazon EC2 Auto Scaling 그룹에서 인스턴스를 정의하고 생성합니다.

두 번째 옵션을 선택하는 경우 새 Amazon EC2 Auto Scaling 그룹을 대신 CodeDeploy 프로비저닝하십시오. 그룹 이름을 지정할 때 사용하는 규칙은 다음과 같습니다.

CodeDeploy_deployment_group_name_deployment_id

예를 들어 ID가 10인 배포를 통해 alpha-deployments라는 이름의 배포 그룹을 배포하는 경우 프로비저닝되는 Amazon EC2 Auto Scaling 그룹은 CodeDeploy_alpha-deployments_10이라는 이름으로 지정됩니다. 자세한 내용은 EC2/온프레미스 블루/그린 배포에 사용할 수 있는 배포 그룹 만들기(콘솔) 및 GreenFleetProvisioningOption 섹션을 참조하세요.

사용자 지정 수명 주기 후크의 실행 순서

배포할 Amazon EC2 Auto Scaling 그룹에 자체 수명 주기 후크를 추가할 수 있습니다. CodeDeploy 하지만 이러한 사용자 지정 수명 주기 후크 이벤트가 실행되는 순서는 CodeDeploy 기본 배포 수명 주기 이벤트와 관련하여 미리 결정할 수 없습니다. 예를 들어, Amazon EC2 Auto Scaling 그룹에 이름이 지정된 ReadyForSoftwareInstall 사용자 지정 수명 주기 후크를 추가하는 경우 첫 번째 CodeDeploy 기본 배포 수명 주기 이벤트 이전에 실행될지 아니면 마지막 이후에 실행될지 미리 알 수 없습니다.

사용자 지정 수명 주기 후크를 Amazon EC2 Auto Scaling 그룹에 추가하는 방법을 알아보려면 Amazon EC2 Auto Scaling 사용 설명서의 수명 주기 후크 추가를 참조하세요.

배포 중 이벤트 확장

배포가 진행되는 동안 Auto Scaling 스케일 아웃 이벤트가 발생하면 새 인스턴스는 최신 애플리케이션 개정 버전이 아닌 이전에 배포된 애플리케이션 개정 버전으로 업데이트됩니다. 배포에 성공하면 이전 인스턴스와 새로 확장된 인스턴스가 다른 애플리케이션 개정을 호스팅합니다. 이전 버전의 인스턴스를 최신 버전으로 업데이트하려면 첫 번째 배포 직후 후속 배포를 CodeDeploy 자동으로 시작하여 오래된 인스턴스를 업데이트합니다. 오래된 EC2 인스턴스가 이전 버전으로 유지되도록 이 기본 동작을 변경하려면 Automatic updates to outdated instances 섹션을 참조하세요.

배포가 진행되는 동안 Amazon EC2 Auto Scaling 스케일 아웃 프로세스를 일시 중단하려면 로드 밸런싱에 사용되는 common_functions.sh 스크립트의 설정을 통해 이 작업을 수행할 수 있습니다. CodeDeploy HANDLE_PROCS=true이면 배포 프로세스 중 다음 Auto Scaling 이벤트가 자동으로 일시 중단됩니다.

• AZRebalance

• AlarmNotification

• ScheduledActions

• ReplaceUnhealthy

중요

CodeDeployDefault에만 해당됩니다. OneAtATime 배포 구성은 이 기능을 지원합니다.

Amazon EC2 Auto HANDLE_PROCS=true Scaling을 사용할 때 배포 문제를 방지하기 위해 사용하는 방법에 대한 자세한 내용은 on에서의 AutoScaling aws-codedeploy-samples프로세스 처리에 대한 중요 공지를 참조하십시오. GitHub

배포 중에 스케일 인 이벤트

Auto Scaling 그룹에서 CodeDeploy 배포가 진행되는 동안 Auto Scaling 그룹이 확장을 시작하면 종료 프로세스 (종료 배포 수명 주기 이벤트 포함) 와 CodeDeploy 종료 인스턴스의 다른 CodeDeploy 수명 주기 이벤트 간에 경쟁 상태가 발생할 수 있습니다. 모든 CodeDeploy 수명 주기 이벤트가 완료되기 전에 인스턴스가 종료되면 해당 특정 인스턴스에서의 배포가 실패할 수 있습니다. 또한 CodeDeploy 배포 구성에서 최소 정상 호스트 수 설정을 어떻게 설정했는지에 따라 전체 배포가 실패할 수도 있고 실패하지 않을 수도 있습니다.

AWS CloudFormation cfn-init 스크립트의 이벤트 순서

새로 프로비저닝된 Linux 기반 인스턴스에서 cfn-init(또는 cloud-init)를 사용하여 스크립트를 실행하는 경우 인스턴스 시작 후 발생하는 이벤트 순서를 엄격하게 제어하지 않으면 배포에 실패할 수 있습니다.

순서는 다음과 같아야 합니다.

1. 새로 프로비저닝된 인스턴스가 시작합니다.

2. 모든 cfn-init 부트스트래핑 스크립트가 완료될 때까지 실행됩니다.

3. 에이전트가 시작됩니다. CodeDeploy

4. 최신 애플리케이션 개정이 인스턴스에 배포됩니다.

이벤트 순서를 세심하게 제어하지 않는 경우 CodeDeploy 에이전트는 모든 스크립트 실행이 끝나기 전에 배포를 시작할 수 있습니다.

이벤트 순서를 제어하려면 다음 모범 사례 중 하나를 사용합니다.

• 스크립트를 통해 CodeDeploy 에이전트를 설치하고 다른 모든 cfn-init 스크립트 뒤에 배치합니다.

• CodeDeploy 에이전트를 사용자 지정 AMI에 포함시키고 cfn-init 스크립트를 사용하여 시작하여 다른 모든 스크립트 뒤에 배치합니다.

cfn-init 사용에 대한 자세한 내용은 AWS CloudFormation 사용 설명서의 cfn-init를 참조하세요.

Amazon EC2 Auto CodeDeploy Scaling과 함께 사용자 지정 AMI 사용

새 Amazon EC2 인스턴스를 Amazon EC2 Auto Scaling 그룹에서 시작하는 경우 사용할 기본 AMI를 지정하는 데 다음 두 가지 옵션이 있습니다.

• CodeDeploy 에이전트가 이미 설치된 기본 사용자 지정 AMI를 지정할 수 있습니다. 에이전트가 이미 설치되어 있으므로 이 옵션은 다른 옵션보다 훨씬 빨리 새 Amazon EC2 인스턴스를 시작합니다. 하지만 이 옵션을 사용하면 특히 에이전트가 최신 버전이 아닌 경우 CodeDeploy Amazon EC2 인스턴스의 초기 배포가 실패할 가능성이 커집니다. 이 옵션을 선택하는 경우 기본 사용자 지정 AMI에서 CodeDeploy 에이전트를 정기적으로 업데이트하는 것이 좋습니다.

• CodeDeploy 에이전트가 설치되지 않은 기본 AMI를 지정하고 Amazon EC2 Auto Scaling 그룹에서 새 인스턴스를 시작할 때마다 에이전트를 설치하도록 할 수 있습니다. 이 옵션은 다른 옵션보다 새 Amazon EC2 인스턴스의 시작 속도가 훨씬 느리긴 하지만 초기 인스턴스 배포에 성공할 가능성이 더 큽니다. 이 옵션은 최신 버전의 CodeDeploy 에이전트를 사용합니다.