기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# CodeDeploy에서 배포 그룹 만들기
CodeDeploy 콘솔, AWS CLI, CodeDeploy APIs 또는 CloudFormation 템플릿을 사용하여 배포 그룹을 생성할 수 있습니다. CloudFormation 템플릿을 사용하여 배포 그룹을 생성하는 방법에 대한 자세한 내용은 섹션을 참조하세요[CloudFormation CodeDeploy 참조용 템플릿](reference-cloudformation-templates.md).
CodeDeploy 콘솔을 사용하여 애플리케이션을 만드는 경우 동시에 이 애플리케이션의 첫 번째 배포 그룹을 구성합니다. AWS CLI 를 사용하여 애플리케이션을 생성할 때 별도의 단계에서 첫 번째 배포 그룹을 생성합니다.
배포 그룹 만들기의 일부로 서비스 역할을 지정해야 합니다. 자세한 내용은 [2단계: CodeDeploy에 대한 서비스 역할 생성](getting-started-create-service-role.md) 단원을 참조하십시오.
**Topics**
+ [
# 인 플레이스(in-place) 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)
](deployment-groups-create-in-place.md)
+ [
# EC2/온프레미스 블루/그린 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)
](deployment-groups-create-blue-green.md)
+ [
# Amazon ECS 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)
](deployment-groups-create-ecs.md)
+ [
# Elastic Load Balancing에서 CodeDeploy Amazon EC2 배포에 대한 로드 밸런서 설정
](deployment-groups-create-load-balancer.md)
+ [
# CodeDeploy Amazon ECS 배포를 위한 로드 밸런서, 대상 그룹 및 리스너 설정
](deployment-groups-create-load-balancer-for-ecs.md)
+ [
# 배포 그룹 만들기(CLI)
](deployment-groups-create-cli.md)
# 인 플레이스(in-place) 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)
CodeDeploy 콘솔을 사용하여 인 플레이스(in-place) 배포에 사용할 수 있는 배포 그룹을 만들려면:
**주의**
다음과 같은 경우 아래 단계를 수행하지 마세요.
애플리케이션의 첫 번째 CodeDeploy 배포에 사용할 인스턴스를 아직 준비하지 않은 경우. 인스턴스를 설정하려면 [CodeDeploy용 인스턴스 작업](instances.md) 섹션의 지침을 수행한 다음 이 주제의 단계를 수행하세요.
사용자 지정 배포 구성을 사용하는 배포 그룹을 만들고 싶지만 아직 배포 구성을 만들지 못한 경우. [CodeDeploy에서 배포 구성 만들기](deployment-configurations-create.md)의 지침을 수행한 다음 이 주제의 단계를 수행하세요.
최소한 [2단계: CodeDeploy에 대한 서비스 역할 생성](getting-started-create-service-role.md)에 설명된 신뢰 및 권한으로 CodeDeploy를 신뢰하는 서비스 역할이 없는 경우. 서비스 역할을 만들고 구성하려면 [2단계: CodeDeploy에 대한 서비스 역할 생성](getting-started-create-service-role.md)의 지침을 수행한 다음 이 주제의 단계를 수행하세요.
인 플레이스(in-place) 배포에 대해 Elastic Load Balancing에서 Classic Load Balancer, Application Load Balancer 또는 Network Load Balancer를 선택하려고 하지만 아직 생성하지 않은 경우.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) CodeDeploy 콘솔을 엽니다.
**참고**
[CodeDeploy 시작하기](getting-started-codedeploy.md)에서 설정한 사용자와 동일한 사용자로 로그인합니다.
1. 탐색 창에서 **배포**를 확장하고 **애플리케이션**을 선택합니다.
1. [**Applications**] 페이지에서 배포 그룹을 만들려는 애플리케이션의 이름을 선택합니다.
1. 애플리케이션 페이지의 **배포 그룹** 탭에서 **배포 그룹 생성**을 선택합니다.
1. **Deployment group name(배포 그룹 이름)**에 배포 그룹을 설명하는 이름을 입력합니다.
**참고**
(배포 그룹 이름, 태그, Amazon EC2 Auto Scaling 그룹 이름 또는 둘 다 및 배포 구성을 비롯하여) 다른 배포 그룹에서 사용되는 것과 동일한 설정을 사용하려면 이 페이지에서 지정합니다. 새 배포 그룹과 기존 배포 그룹의 이름이 같더라도 각 배포 그룹은 개별 애플리케이션과 연결되므로 CodeDeploy에서는 이러한 배포 그룹을 개별 배포 그룹으로 취급합니다.
1. **서비스 역할**에서 대상 인스턴스에 액세스할 수 있는 권한을 CodeDeploy에 부여하는 서비스 역할을 선택합니다.
1. **배포 유형**에서 **In-place(현재 위치)**를 선택합니다.
1. **환경 구성**에서 다음을 수행합니다.
1. 애플리케이션을 Amazon EC2 Auto Scaling 그룹에 배포하려면 **Amazon EC2 Auto Scaling 그룹**을 선택한 다음 애플리케이션 리비전을 배포할 Amazon EC2 Auto Scaling 그룹의 이름을 선택합니다. 새 Amazon EC2 인스턴스가 Amazon EC2 Auto Scaling 그룹의 일부로 시작되면 CodeDeploy에서는 새 인스턴스로 개정을 자동으로 배포할 수 있습니다. 배포 그룹당 최대 10개의 Amazon EC2 Auto Scaling 그룹을 추가할 수 있습니다. 자세한 내용은 [Amazon EC2 Auto Scaling과 CodeDeploy 통합](integrations-aws-auto-scaling.md) 단원을 참조하십시오.
1.
**Amazon EC2 Auto Scaling 그룹**을 선택한 경우, 배포 그룹을 생성하거나 업데이트할 때 Auto Scaling 그룹에 종료 후크를 설치하도록 하려면 선택적으로 **Auto Scaling 그룹에 종료 후크 추가**를 선택합니다. 이 후크가 설치되면 CodeDeploy가 종료 배포를 수행합니다. 자세한 내용은 [Auto Scaling 확장 이벤트 중 종료 배포 활성화](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors-hook-enable) 단원을 참조하십시오.
1. 인스턴스에 태그를 지정하려면 **Amazon EC2 인스턴스** 또는 **온프레미스 인스턴스**를 선택합니다. **키** 및 **값** 필드에 인스턴스에 태그를 지정하는 데 사용한 키-값 쌍의 값을 입력합니다. 한 태그 그룹에서 최대 10개의 키-값 페어에 태그를 지정할 수 있습니다.
1. **값** 필드에서 와일드카드를 사용해 특정 패턴으로 태그가 지정된 모든 인스턴스를 식별할 수 있습니다(예: Amazon EC2 인스턴스, 코스트 센터 및 그룹 이름 등). 예를 들어, **키**필드에서 **이름**을 선택하고 **값** 필드에서 **GRP-\$1a**를 입력하면 CodeDeploy가 해당 패턴에 맞는 모든 인스턴스(예: **GRP-1a**, **GRP-2a**, 및 **GRP-XYZ-a**)를 식별합니다.
1. **값** 필드는 대/소문자를 구분합니다.
1. 목록에서 키-값 페어를 제거하려면 제거 아이콘을 선택합니다.
CodeDeploy에서는 지정된 각 키-값 페어 또는 Amazon EC2 Auto Scaling 그룹 이름과 일치하는 인스턴스를 찾기 때문에 일치하는 인스턴스 개수가 표시됩니다. 인스턴스에 대한 자세한 내용을 확인하려면 이 숫자를 클릭하세요.
배포된 인스턴스의 기준을 세분화하려면 [**Add tag group**]을 선택하여 태그 그룹을 만듭니다. 키-값 페어가 각각 최대 10개인 태그 그룹을 최대 세 개까지 만들 수 있습니다. 배포 그룹에서 여러 태그 그룹을 사용하는 경우 모든 태그 그룹으로 식별되는 인스턴스만 배포 그룹에 포함됩니다. 즉 인스턴스는 배포 그룹에 포함될 각 그룹의 태그 중 적어도 하나와 일치해야 합니다.
태그 그룹을 사용하여 배포 그룹을 세분화하는 방법에 대한 자세한 내용은 [CodeDeploy에서 배포 그룹에 대한 인스턴스에 태그 지정](instances-tagging.md) 단원을 참조하세요.
1. **Systems Manager를 사용한 에이전트 구성(Agent configuration with Systems Manager)**에서 배포 그룹의 인스턴스에 CodeDeploy 에이전트를 설치하고 업데이트하는 방법을 지정합니다. CodeDeploy 에이전트에 대한 자세한 내용은 [CodeDeploy 에이전트 작업](https://docs.aws.amazon.com/en_us/codedeploy/latest/userguide/codedeploy-agent.html)을 참조하세요. Systems Manager에 대한 자세한 내용은 [Systems Manager란 무엇입니까?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)를 참조하세요.
1. **안 함**: Systems Manager를 사용한 CodeDeploy 설치 구성을 건너뜁니다. 인스턴스에 배포에 사용할 에이전트가 설치되어 있어야 하므로 CodeDeploy 에이전트를 다른 방법으로 설치할 경우에만 이 옵션을 선택합니다.
1. **한 번만**: Systems Manager가 배포 그룹의 모든 인스턴스에 CodeDeploy 에이전트를 한 번 설치합니다.
1. **지금 설치 및 업데이트 예약**: Systems Manager가 상태 관리자와 연결을 생성하여, 사용자가 구성한 일정에 따라 CodeDeploy 에이전트를 설치합니다. 상태 관리자 및 연결에 대한 자세한 내용은 [상태 관리자 정보](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-state-about.html)를 참조하세요.
1. **Deployment configuration(배포 구성)**에서 인스턴스가 배포되는 속도를 제어하는 배포 구성을 선택합니다(예: 한 번에 하나씩 또는 한 번에 모두). 배포 구성에 대한 자세한 내용은 [CodeDeploy에서 배포 구성 작업](deployment-configurations.md) 단원을 참조하세요.
1. (선택 사항) **로드 밸런서**에서 **로드 밸런싱 활성화**를 선택한 후, 목록에서 CodeDeploy 배포 프로세스 중 인스턴스로 가는 트래픽을 관리할 Classic Load Balancer, Application Load Balancer 대상 그룹 및 Network Load Balancer 대상 그룹을 선택합니다. 최대 10개의 Classic Load Balancer 및 10개의 대상 그룹으로 총 20개의 항목을 선택할 수 있습니다. 배포하려는 Amazon EC2 인스턴스가 선택한 로드 밸런서(Classic Load Balancer) 또는 대상 그룹(Application Load Balancer 및 Network Load Balancer)에 등록되어 있는지 확인합니다.
배포 중에는 선택한 로드 밸런서 및 대상 그룹에서 원본 인스턴스의 등록이 취소되어 배포 중에 트래픽이 이러한 인스턴스로 라우팅되는 것이 방지됩니다. 배포가 완료되면 각 인스턴스가 선택한 *모든* Classic Load Balancer 및 대상 그룹에 다시 등록됩니다.
CodeDeploy 배포에 사용할 수 있는 로드 밸런서에 대한 자세한 내용은 [CodeDeploy와 Elastic Load Balancing 통합](integrations-aws-elastic-load-balancing.md) 단원을 참조하세요.
**주의**
이 배포 그룹에서 오토 스케일링과 Elastic Load Balancing 로드 밸런서를 모두 구성하고 [로드 밸런서를 오토 스케일링에 연결](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html)하려는 경우 이 배포 그룹에서 CodeDeploy 배포를 생성하기 *전에* 이 연결을 완료하는 것이 좋습니다. 배포를 생성한 후 연결을 완료하려고 하면 예기치 않게 로드 밸런서에서 모든 인스턴스의 등록이 취소될 수 있습니다.
1. (선택 사항) **고급**을 확장하고 배포에 포함하려는 모든 옵션(예: Amazon SNS 알림 트리거, Amazon CloudWatch 경보, Auto Scaling 옵션 또는 자동 롤백)을 구성합니다.
자세한 내용은 [배포 그룹에 대한 고급 옵션 구성](deployment-groups-configure-advanced-options.md) 단원을 참조하십시오.
1. [**Create deployment group**]을 선택합니다.
# EC2/온프레미스 블루/그린 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)
CodeDeploy 콘솔을 사용하여 블루/그린 배포에 사용할 수 있는 배포 그룹을 만들려면:
**주의**
다음과 같은 경우 아래 단계를 수행하지 마세요.
Blue/Green 배포 프로세스 중 대체하려는 인스턴스에 CodeDeploy 에이전트가 설치되어 있지 않은 경우. 인스턴스를 설정하려면 [CodeDeploy용 인스턴스 작업](instances.md) 섹션의 지침을 수행한 다음 이 주제의 단계를 수행하세요.
사용자 지정 배포 구성을 사용하는 애플리케이션을 만들고 싶지만 아직 배포 구성을 만들지 못한 경우. [CodeDeploy에서 배포 구성 만들기](deployment-configurations-create.md)의 지침을 수행한 다음 이 주제의 단계를 수행하세요.
최소한 [2단계: CodeDeploy에 대한 서비스 역할 생성](getting-started-create-service-role.md)에 설명된 신뢰 및 권한으로 CodeDeploy를 신뢰하는 서비스 역할이 없는 경우. 서비스 역할을 만들고 구성하려면 [2단계: CodeDeploy에 대한 서비스 역할 생성](getting-started-create-service-role.md)의 지침을 수행한 다음 이 주제의 단계를 수행하세요.
대체 환경에서 인스턴스를 등록하기 위해 Elastic Load Balancing에서 Classic Load Balancer 또는 Application Load Balancer를 생성하지 않은 경우. 자세한 내용은 [Elastic Load Balancing에서 CodeDeploy Amazon EC2 배포에 대한 로드 밸런서 설정](deployment-groups-create-load-balancer.md) 단원을 참조하십시오.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) CodeDeploy 콘솔을 엽니다.
**참고**
[CodeDeploy 시작하기](getting-started-codedeploy.md)에서 설정한 사용자와 동일한 사용자로 로그인합니다.
1. 탐색 창에서 **배포**를 확장하고 **애플리케이션**을 선택합니다.
1. [**Applications**] 페이지에서 배포 그룹을 만들려는 애플리케이션의 이름을 선택합니다.
1. 애플리케이션 페이지의 **배포 그룹** 탭에서 **배포 그룹 생성**을 선택합니다.
1. **Deployment group name(배포 그룹 이름)**에 배포 그룹을 설명하는 이름을 입력합니다.
**참고**
(배포 그룹 이름, 태그, Amazon EC2 Auto Scaling 그룹 이름 및 배포 구성을 비롯하여) 다른 배포 그룹에서 사용되는 것과 동일한 설정을 사용하려면 이 페이지에서 해당 설정을 선택합니다. 새 배포 그룹과 기존 배포 그룹의 이름이 같더라도 각 배포 그룹은 개별 애플리케이션과 연결되므로 CodeDeploy에서는 이러한 배포 그룹을 개별 배포 그룹으로 취급합니다.
1. **서비스 역할**에서 대상 인스턴스에 액세스할 수 있는 권한을 CodeDeploy에 부여하는 서비스 역할을 선택합니다.
1. **배포 유형**에서 **Blue/Green(블루/그린)**을 선택합니다.
1. **환경 구성**에서 다음을 수행합니다.
+ 교체 환경에 인스턴스를 제공하는 데 사용할 방법을 선택합니다. 다음과 같은 옵션이 있습니다.
+ **Amazon EC2 Auto Scaling 그룹 자동 복사**: CodeDeploy 그룹은 지정된 그룹을 복사하여 Amazon EC2 Auto Scaling 그룹을 생성합니다.
+ [**Manually provision instances**]: 배포를 만들 때까지 대체 환경에 필요한 인스턴스를 지정할 수 없습니다. 배포를 시작하려면 먼저 인스턴스를 만들어야 합니다. 대신, 여기서 대체할 인스턴스를 지정합니다.
+ **Amazon EC2 Auto Scaling 그룹 자동 복사**를 선택한 경우, 선택적으로 **Auto Scaling 그룹에 종료 후크 추가**를 선택하여 배포 그룹을 생성하거나 업데이트할 때 CodeDeploy가 Auto Scaling 그룹에 종료 후크를 설치하도록 합니다. 이 후크가 설치되면 CodeDeploy가 종료 배포를 수행합니다. 자세한 내용은 [Auto Scaling 확장 이벤트 중 종료 배포 활성화](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors-hook-enable) 단원을 참조하십시오.
1. **Systems Manager를 사용한 에이전트 구성(Agent configuration with Systems Manager)**에서 배포 그룹의 인스턴스에 CodeDeploy 에이전트를 설치하고 업데이트하는 방법을 지정합니다. CodeDeploy 에이전트에 대한 자세한 내용은 [CodeDeploy 에이전트 작업](https://docs.aws.amazon.com/en_us/codedeploy/latest/userguide/codedeploy-agent.html)을 참조하세요. Systems Manager에 대한 자세한 내용은 [Systems Manager란 무엇입니까?](https://docs.aws.amazon.com/systems-manager/latest/userguide/what-is-systems-manager.html)를 참조하세요.
1. **안 함**: Systems Manager를 사용한 CodeDeploy 설치 구성을 건너뜁니다. 인스턴스에 배포에 사용할 에이전트가 설치되어 있어야 하므로 CodeDeploy 에이전트를 다른 방법으로 설치할 경우에만 이 옵션을 선택합니다.
1. **한 번만**: Systems Manager가 배포 그룹의 모든 인스턴스에 CodeDeploy 에이전트를 한 번 설치합니다.
1. **지금 설치 및 업데이트 예약**: Systems Manager가 상태 관리자와 연결을 생성하여, 사용자가 구성한 일정에 따라 CodeDeploy 에이전트를 설치합니다. 상태 관리자 및 연결에 대한 자세한 내용은 [상태 관리자 정보](https://docs.aws.amazon.com/systems-manager/latest/userguide/sysman-state-about.html)를 참조하세요.
1. 8단계에서 선택한 항목에 따라 다음 중 하나를 수행하세요.
+ **Amazon EC2 Auto Scaling 그룹 자동 복사**를 선택한 경우: **Amazon EC2 Auto Scaling 그룹**에서 대체 환경의 인스턴스에 대해 생성한 Amazon EC2 Auto Scaling 그룹의 템플릿으로 사용할 Amazon EC2 Auto Scaling 그룹의 이름을 선택하거나 입력합니다. 선택한 Amazon EC2 Auto Scaling 그룹의 현재 정상 인스턴스 개수가 대체 환경에서 생성됩니다.
+ **인스턴스 수동 프로비저닝**을 선택한 경우: **Amazon EC2 Auto Scaling 그룹**이나 **Amazon EC2 Auto Scaling 인스턴스** 또는 둘 다를 선택하여 이 배포 그룹에 추가할 인스턴스를 지정합니다. 원본 환경의 인스턴스(즉, 대체할 인스턴스 또는 현재 애플리케이션 개정을 실행 중인 인스턴스)를 식별할 Amazon EC2 Auto Scaling 태그 값 또는 Amazon EC2 Auto Scaling 그룹 이름을 입력합니다.
1. **로드 밸런서**에서 **로드 밸런싱 활성화**를 선택한 후 목록에서 대체 Amazon EC2 인스턴스를 등록할 Classic Load Balancer, Application Load Balancer 대상 그룹 및 Network Load Balancer 대상 그룹을 선택합니다. 각 대체 인스턴스는 선택한 *모든* Classic Load Balancer 및 대상 그룹에 등록됩니다. 최대 10개의 Classic Load Balancer 및 10개의 대상 그룹으로 총 20개의 항목을 선택할 수 있습니다.
선택한 **트래픽 재라우팅** 및 **배포 구성** 설정에 따라 트래픽이 원본 인스턴스에서 대체 인스턴스로 다시 라우팅됩니다.
CodeDeploy 배포에 사용할 수 있는 로드 밸런서에 대한 자세한 내용은 [CodeDeploy와 Elastic Load Balancing 통합](integrations-aws-elastic-load-balancing.md) 단원을 참조하세요.
**주의**
이 배포 그룹에서 오토 스케일링과 Elastic Load Balancing 로드 밸런서를 모두 구성하고 [로드 밸런서를 오토 스케일링에 연결](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html)하려는 경우 이 배포 그룹에서 CodeDeploy 배포를 생성하기 *전에* 이 연결을 완료하는 것이 좋습니다. 배포를 생성한 후 연결을 완료하려고 하면 예기치 않게 로드 밸런서에서 모든 인스턴스의 등록이 취소될 수 있습니다.
1. [**Deployment settings**]에서 대체 환경으로 트래픽을 다시 라우팅하기 위한 기본 옵션(배포에 사용할 배포 구성임)과 배포 후 원본 환경의 인스턴스 처리 방법에 대한 기본 옵션을 검토합니다.
설정을 변경하려면 다음 단계로 진행합니다. 그렇지 않으면 14단계로 건너뛰세요.
1. 블루/그린 배포에 대한 배포 설정을 변경하려면 다음 설정을 선택합니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/codedeploy/latest/userguide/deployment-groups-create-blue-green.html)
1. (선택 사항) **고급**에서 배포에 포함하려는 모든 옵션(예: Amazon SNS 알림 트리거, Auto Scaling 옵션, Amazon CloudWatch 경보 또는 자동 롤백)을 구성합니다.
배포 그룹에서 고급 옵션 지정에 대한 자세한 내용은 [배포 그룹에 대한 고급 옵션 구성](deployment-groups-configure-advanced-options.md) 단원을 참조하세요.
1. [**Create deployment group**]을 선택합니다.
# Amazon ECS 배포에 사용할 수 있는 배포 그룹 만들기(콘솔)
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) CodeDeploy 콘솔을 엽니다.
**참고**
[CodeDeploy 시작하기](getting-started-codedeploy.md)에서 설정한 사용자와 동일한 사용자로 로그인합니다.
1. 탐색 창에서 **배포**를 확장하고 **애플리케이션**을 선택합니다.
1. **Applications table(애플리케이션 테이블)**에서 편집하려는 배포 그룹과 연결된 애플리케이션의 이름을 선택합니다.
1. 애플리케이션 페이지의 **배포 그룹**에서 편집하려는 배포 그룹의 이름을 선택합니다.
1. 애플리케이션 페이지의 **배포 그룹** 탭에서 **배포 그룹 생성**을 선택합니다. Amazon ECS 배포에 대한 배포 그룹을 만드는 데 필요한 항목에 대한 자세한 정보는 [Amazon ECS 배포를 시작하기 전](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs) 단원을 참조하세요.
1. **Deployment group name(배포 그룹 이름)**에 배포 그룹을 설명하는 이름을 입력합니다.
**참고**
(배포 그룹 이름 및 배포 구성을 포함하여) 다른 배포 그룹에서 사용되는 것과 동일한 설정을 사용하려면 이 페이지에서 해당 설정을 선택합니다. 새 그룹과 기존 그룹의 이름이 같더라도 각 배포 그룹은 개별 애플리케이션과 연결되므로 CodeDeploy는 이러한 배포 그룹을 개별 배포 그룹으로 취급합니다.
1. **서비스 역할**에서 Amazon ECS에 액세스할 수 있는 권한을 CodeDeploy에 부여하는 서비스 역할을 선택합니다. 자세한 내용은 [2단계: CodeDeploy에 대한 서비스 역할 생성](getting-started-create-service-role.md) 단원을 참조하십시오.
1. **로드밸런서 이름**에서 Amazon ECS 서비스에 트래픽을 공급하는 로드밸런서의 이름을 선택합니다.
1. **프로덕션 리스너 포트**에서 해당 Amazon ECS 서비스에 서비스 프로덕션 트래픽을 공급하는 리스너의 프로토콜과 포트를 선택합니다.
1. (선택 사항) **테스트 리스너 포트**에서 배포 중 해당 Amazon ECS 서비스의 대체 작업 세트에 트래픽을 공급하는 테스트 리스너의 프로토콜과 포트를 선택합니다. `AfterAllowTestTraffic` 후크 중 실행하는 AppSpec 파일의 Lambda 함수를 한 개 이상 지정할 수 있습니다. 이 함수는 확인 테스트를 실행할 수 있습니다. 확인 테스트가 실패하면 배포 롤백이 트리거됩니다. 확인 테스트가 성공하면 배포 수명 주기의 다음 후크인 `BeforeAllowTraffic`이 트리거됩니다. 테스트 리스너 포트를 지정하지 않으면 `AfterAllowTestTraffic` 후크 중 아무것도 수행되지 않습니다. 자세한 내용은 [Amazon ECS 배포를 위한 AppSpec 'hooks' 섹션](reference-appspec-file-structure-hooks.md#appspec-hooks-ecs) 단원을 참조하십시오.
1. **대상 그룹 1 이름**과 **대상 그룹 2 이름**에서 배포 중 트래픽을 라우팅하는 데 사용되는 대상 그룹을 선택합니다. CodeDeploy는 한 대상 그룹을 Amazon ECS 서비스의 기존 작업 세트에 바인딩하고 다른 대상 그룹을 대체 작업 세트에 바인딩합니다. 자세한 내용은 [Application Load Balancer의 대상 그룹 지정](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/load-balancer-target-groups.html)을 참조하세요.
1. **즉시 트래픽 다시 라우팅** 또는 **트래픽을 언제 다시 라우팅할지 지정**을 선택하여 업데이트된 Amazon ECS 서비스에 트래픽을 언제 다시 라우팅할지를 지정합니다.
**Reroute traffic immediately(즉시 트래픽 다시 라우팅)**를 선택한 경우 대체 작업 세트가 프로비저닝된 후 배포가 트래픽을 자동으로 다시 라우팅합니다.
**Specify when to reroute traffic(트래픽을 언제 다시 라우팅할지 지정)**을 선택한 경우 대체 작업 세트가 성공적으로 프로비저닝된 후 대기할 일, 시간 및 분을 선택합니다. 이 대기 시간 동안 AppSpec 파일에 지정된 Lambda 함수의 유효성 테스트가 실행됩니다. 트래픽이 다시 라우팅되기 전에 대기 시간이 만료되면 배포 상태가 `Stopped`로 변경됩니다.
1. **기존 개정 종료**에서 배포 성공 후 얼마 후에 Amazon ECS 서비스의 기존 작업 세트가 종료될지를 일, 시간, 분으로 선택합니다.
1. (선택 사항) **고급**에서 배포에 포함하려는 모든 옵션(예: Amazon SNS 알림 트리거, Amazon CloudWatch 경보 또는 자동 롤백)을 구성합니다.
자세한 내용은 [배포 그룹에 대한 고급 옵션 구성](deployment-groups-configure-advanced-options.md) 단원을 참조하십시오.
# Elastic Load Balancing에서 CodeDeploy Amazon EC2 배포에 대한 로드 밸런서 설정
배포 그룹에서 선택적 로드 밸런서를 지정하려는 블루/그린 배포 또는 인 플레이스 배포를 실행하려면 먼저 Elastic Load Balancing에 최소 하나의 Classic Load Balancer, Application Load Balancer, 또는 Network Load Balancer를 만들어야 합니다. 블루/그린 배포의 경우 해당 로드 밸런서를 사용하여 대체 환경을 구성하는 인스턴스를 등록합니다. 원본 환경의 인스턴스는 동일한 로드 밸런서에 선택적으로 등록할 수 있습니다. 인플레이스 배포의 경우 CodeDeploy에서 작업 중인 인스턴스를 등록 취소하고 작업이 완료되면 다시 등록하는 데 로드 밸런서가 사용됩니다.
CodeDeploy는 여러 로드 밸런서를 사용하여 Amazon EC2 인스턴스에 대한 블루/그린 및 인플레이스 배포를 지원합니다. 예를 들어, 200개의 Amazon EC2 인스턴스가 있고 그 중 100개는 2개 Classic Load Balancer에 등록되어 있고, 나머지 100개는 2개 Application Load Balancer의 4개 대상 그룹에 등록되어 있다고 가정해 보겠습니다. 이 시나리오에서 CodeDeploy를 사용하면 인스턴스가 2개 Classic Load Balancer, 2개 Application Load Balancer 및 4개 대상 그룹에 분산되어 있더라도 200개 인스턴스 모두에 블루/그린 및 인플레이스 배포를 수행할 수 있습니다.
CodeDeploy는 최대 10개의 Classic Load Balancer 및 10개의 대상 그룹으로 총 20개의 항목을 지원합니다.
하나 이상의 Classic Load Balancer를 구성하려면 *Classic Load Balancer 사용 설명서*의 [자습서: Classic Load Balancer](https://docs.aws.amazon.com/elasticloadbalancing/latest/classic/elb-getting-started.html)의 지침을 따릅니다. 다음 사항에 유의하세요.
+ **2단계: 로드 밸런서 정의**의 **내부에서 LB 만들기**에서 인스턴스를 생성할 때 선택한 바로 그 VPC를 선택합니다.
+ **5단계: 로드 밸런서에 EC2 인스턴스 등록**에서 배포 그룹의 현재 인스턴스(인 플레이스(in-place) 배포) 또는 원본 환경에서 지정한 인스턴스(블루/그린 배포)를 선택합니다.
+ **7단계: 로드 밸런서 생성 및 확인**에서 로드 밸런서의 DNS 주소를 기록해 둡니다.
예를 들어 로드 밸런서의 이름을 `my-load-balancer`로 지정하면 DNS 주소는 `my-load-balancer-1234567890.us-east-2.elb.amazonaws.com`과 같은 형식으로 나타납니다.
하나 이상의 Application Load Balancer를 구성하려면 다음 주제 중 하나의 지침을 따릅니다.
+ [Application Load Balancer 생성](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/create-application-load-balancer.html)
+ [자습서:를 사용하여 Application Load Balancer 생성 AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/application/tutorial-application-load-balancer-cli.html)
하나 이상의 Network Load Balancer를 구성하려면 다음 주제 중 하나의 지침을 따릅니다.
+ [Network Load Balancer 생성](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/create-network-load-balancer.html)
+ [자습서:를 사용하여 Network Load Balancer 생성 AWS CLI](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/network-load-balancer-cli.html)
# CodeDeploy Amazon ECS 배포를 위한 로드 밸런서, 대상 그룹 및 리스너 설정
Amazon ECS 컴퓨팅 플랫폼을 사용하여 배포를 실행하려면 먼저 Application Load Balancer 또는 Network Load Balancer, 대상 그룹 두 개, 리스너 한 개 또는 두 개를 만들어야 합니다. 이 주제에서는 Application Load Balancer를 생성하는 방법을 보여줍니다. 자세한 내용은 [Amazon ECS 배포를 시작하기 전](deployment-steps-ecs.md#deployment-steps-prerequisites-ecs) 단원을 참조하십시오.
대상 그룹 중 하나는 트래픽을 Amazon ECS 애플리케이션의 원래 작업 세트로 보냅니다. 다른 대상 그룹은 트래픽을 대체 작업 세트로 보냅니다. 배포 중에 CodeDeploy는 대체 작업 세트를 만들고 원래 작업 세트에서 새 작업 세트로 트래픽을 다시 라우팅합니다. CodeDeploy는 각 작업 세트에 사용되는 대상 그룹을 결정합니다.
리스너는 로드 밸런서가 대상 그룹으로 트래픽을 보내기 위해 사용합니다. 프로덕션 리스너 한 개는 필수입니다. 확인 테스트를 실행하는 동안 대체 작업 세트로 트래픽을 보내는 선택적 테스트 리스너를 지정할 수 있습니다.
로드밸런서는 다른 가용 영역에 두 개의 퍼블릭 서브넷이 있는 VPC를 사용해야 합니다. 다음 단계에서는 기본 VPC를 확인하고, Amazon EC2 Application Load Balancer를 생성한 다음, 로드밸런서를 위한 대상 그룹을 두 개 생성합니다. 자세한 내용은 [네트워크 로드밸런서의 대상 그룹 지정](https://docs.aws.amazon.com/elasticloadbalancing/latest/network/load-balancer-target-groups.html)을 참조하세요.
## 기본 VPC, 퍼블릭 서브넷 및 보안 그룹 확인
이 주제에서는 Amazon EC2,Application Load Balancer, 대상 그룹 두 개, Amazon ECS 배포 중 사용할 수 있는 포트 두 개를 생성하는 방법을 보여 줍니다. 포트 중 하나는 선택 사항이며 배포 중 검증 테스트를 위해 테스트 포트로 트래픽을 보내는 경우에만 필요합니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/vpc/](https://console.aws.amazon.com/vpc/) Amazon VPC 콘솔을 엽니다.
1. 사용할 기본 VPC를 확인합니다. 탐색 창에서 **Your VPCs**를 선택합니다. **기본 VPC** 열에서 **예**로 표시된 VPC를 확인합니다. 이 VPC가 기본 VPC입니다. 이 VPC에는 사용하는 기본 서브넷이 포함됩니다.
1. **서브넷**을 선택합니다. **기본 서브넷** 열에 **예**로 표시되는 서브넷 두 개의 서브넷 ID를 기록해 둡니다. 로드 밸런서를 생성할 때 이러한 ID를 사용합니다
1. 각 서브넷을 선택한 다음 **설명** 탭을 선택합니다. 사용할 서브넷이 다른 가용 영역에 있는지 확인합니다.
1. 서브넷을 선택한 후 **라우팅 테이블** 탭을 선택합니다. 사용할 각 서브넷이 퍼블릭 서브넷인지 확인하려면, 인터넷 게이트웨이에 대한 링크가 있는 행이 라우팅 테이블에 포함되어 있는지 확인합니다.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) Amazon EC2 콘솔을 엽니다.
1. 탐색 창에서 **보안 그룹**을 선택합니다.
1. 사용할 보안 그룹이 사용 가능한지 확인하고 그룹 ID(예: **sg-abcd1234**)를 기록해 둡니다. 로드 밸런서를 생성할 때 이 정보를 사용합니다
## Amazon EC2 Application Load Balancer, 두 개의 대상 그룹 및 리스너 생성(콘솔)
Amazon EC2 콘솔을 사용하여 Amazon EC2 Application Load Balancer를 생성하려면 다음과 같이 하세요.
1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/) Amazon EC2 콘솔을 엽니다.
1. 탐색 창에서 **로드 밸런서**를 클릭합니다.
1. **로드 밸런서 생성**을 선택합니다.
1. **Application Load Balancer**를 선택하고 **생성**을 선택합니다.
1. **이름**에 로드밸런서의 이름을 입력합니다.
1. **체계**에서 **인터넷 연결**을 선택합니다.
1. **IP 주소 유형**에서 **ipv4**를 선택합니다.
1. (선택 사항) 로드 밸런스를 위한 두 번째 리스너 포트를 구성합니다. 이 포트에 서비스되는 테스트 트래픽을 사용하여 배포 검증 테스트를 실행할 수 있습니다.
1. **로드 밸런서 프로토콜**에서 **리스너 추가**를 선택합니다.
1. 두 번째 리스너의 **로드밸런서 프로토콜**에서 **HTTP**를 선택합니다.
1. **로드 밸런서 포트**에 **8080**을 입력합니다.
1. **가용 영역**의 **VPC**에서 기본 VPC를 선택한 후 사용할 기본 서브넷 두 개를 선택합니다.
1. **다음: 보안 설정 구성**을 선택합니다.
1. **다음: 보안 그룹 구성(Next: Configure Security Groups)**을 선택합니다.
1. **기존 보안 그룹 선택**을 선택하고, 기본 보안 그룹을 선택한 다음, 해당 ID를 기록해 둡니다.
1. **다음: 라우팅 구성(Next: Configure Routing)**을 선택합니다.
1. **대상 그룹**에서 **새 대상 그룹**을 선택하고 첫 번째 대상 그룹을 구성합니다.
1. **이름**에 대상 그룹 이름(예: **target-group-1**)을 입력합니다.
1. **대상 형식**에서 **IP**을 선택합니다.
1. **프로토콜**에서 **HTTP**를 선택합니다. **포트**에 **80**을 입력합니다.
1. **다음: 대상 등록(Next: Register Targets)**을 선택합니다.
1. **다음: 검토**를 선택한 후 **역할 생성**을 선택합니다.
**로드밸런서에 대한 두 번째 대상 그룹을 생성하려면**
1. 로드밸런서가 프로비저닝된 후 Amazon EC2 콘솔을 엽니다. 탐색 창에서 **대상 그룹**을 선택합니다.
1. **대상 그룹 생성**을 선택합니다.
1. **이름**에 대상 그룹 이름(예: **target-group-2**)을 입력합니다.
1. **대상 형식**에서 **IP**을 선택합니다.
1. **프로토콜**에서 **HTTP**를 선택합니다. **포트**에 **80**을 입력합니다.
1. **VPC**에서 기본 VPC를 선택합니다.
1. **생성(Create)**을 선택합니다.
**참고**
Amazon ECS 배포를 실행하려면 로드밸런서에 대해 두 개의 대상 그룹을 생성해야 합니다. Amazon ECS 서비스를 생성할 때 대상 그룹 중 하나의 ARN을 사용합니다. 자세한 내용은 *Amazon ECS 사용 설명서*의 [4단계: Amazon ECS 서비스 생성](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/create-blue-green.html#create-blue-green-taskdef)을 참조하세요.
## Amazon EC2 Application Load Balancer, 두 개의 대상 그룹 및 리스너 생성(CLI)
AWS CLI을(를) 이용하여 Application Load Balancer 생성
1. [create-load-balancer](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-load-balancer.html) 명령을 사용하여 Application Load Balancer를 생성합니다. 동일한 가용 영역에 속하지 않은 서브넷 2개와 보안 그룹 하나를 지정합니다.
```
aws elbv2 create-load-balancer --name bluegreen-alb \
--subnets subnet-abcd1234 subnet-abcd5678 --security-groups sg-abcd1234 --region us-east-1
```
출력에는 로드 밸런서의 Amazon 리소스 이름(ARN)이 다음 형식으로 포함됩니다.
```
arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642
```
1. [create-target-group](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-target-group.html) 명령을 사용하여 첫 번째 대상 그룹을 만듭니다. CodeDeploy는 이 대상 그룹의 트래픽을 서비스에 있는 원래 또는 대체 작업 세트로 라우팅합니다.
```
aws elbv2 create-target-group --name bluegreentarget1 --protocol HTTP --port 80 \
--target-type ip --vpc-id vpc-abcd1234 --region us-east-1
```
출력에는 첫 번째 대상 그룹의 ARN이 다음 형식으로 포함됩니다.
```
arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4
```
1. [create-target-group](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-target-group.html) 명령을 사용하여 두 번째 대상 그룹을 만듭니다. CodeDeploy는 대상 그룹의 트래픽을 첫 번째 대상 그룹에서 서비스되지 않는 작업 세트로 라우팅합니다. 예를 들어, 첫 번째 대상 그룹이 원래 작업 세트로 트래픽을 라우팅하는 경우 이 대상 그룹은 대체 작업 세트로 트래픽을 라우팅합니다.
```
aws elbv2 create-target-group --name bluegreentarget2 --protocol HTTP --port 80 \
--target-type ip --vpc-id vpc-abcd1234 --region us-east-1
```
출력에는 두 번째 대상 그룹의 ARN이 다음 형식으로 포함됩니다.
```
arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/209a844cd01825a4
```
1. [create-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-listener.html) 명령을 사용하여 프로덕션 트래픽을 포트 80에 전달하는 기본 규칙이 있는 리스너를 생성합니다.
```
aws elbv2 create-listener --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
--protocol HTTP --port 80 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget1/209a844cd01825a4 --region us-east-1
```
출력에는 리스너의 ARN이 다음 형식으로 포함됩니다.
```
arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4
```
1. (선택 사항) [create-listener](https://docs.aws.amazon.com/cli/latest/reference/elbv2/create-listener.html) 명령을 사용하여 테스트 트래픽을 포트 8080에 전달하는 기본 규칙이 있는 두 번째 리스너를 생성합니다. 이 포트에 서비스되는 테스트 트래픽을 사용하여 배포 검증 테스트를 실행할 수 있습니다.
```
aws elbv2 create-listener --load-balancer-arn arn:aws:elasticloadbalancing:region:aws_account_id:loadbalancer/app/bluegreen-alb/e5ba62739c16e642 \
--protocol HTTP --port 8080 \
--default-actions Type=forward,TargetGroupArn=arn:aws:elasticloadbalancing:region:aws_account_id:targetgroup/bluegreentarget2/209a844cd01825a4 --region us-east-1
```
출력에는 리스너의 ARN이 다음 형식으로 포함됩니다.
```
arn:aws:elasticloadbalancing:region:aws_account_id:listener/app/bluegreen-alb/e5ba62739c16e642/665750bec1b03bd4
```
# 배포 그룹 만들기(CLI)
AWS CLI 를 사용하여 배포 그룹을 생성하려면 [create-deployment-group](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment-group.html) 명령을 호출하여 다음을 지정합니다.
+ 애플리케이션 이름. 애플리케이션 이름 목록을 보려면 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 명령을 호출합니다.
+ 배포 그룹의 이름입니다. 지정된 애플리케이션에 대해 이 이름의 배포 그룹이 생성됩니다. 배포 그룹은 애플리케이션 하나와만 연결할 수 있습니다.
+ 배포 그룹에 포함되는 인스턴스를 식별하는 태그, 태그 그룹 또는 Amazon EC2 Auto Scaling 그룹 이름에 대한 정보.
+ 다른 AWS 서비스와 상호 작용할 때 CodeDeploy가 AWS 계정을 대신하여 작업하도록 허용하는 서비스 역할의 Amazon 리소스 이름(ARN) 식별자입니다. 서비스 역할 ARN을 확인하려면 [서비스 역할 ARN 확인(CLI)](getting-started-create-service-role.md#getting-started-get-service-role-cli) 단원을 참조하세요. 서비스 역할에 대한 자세한 내용은 *IAM 사용 설명서*의 [역할 용어 및 개념](https://docs.aws.amazon.com/IAM/latest/UserGuide/roles-toplevel.html#roles-about-termsandconcepts)을 참조하세요.
+ 배포 그룹과 연결할 배포 유형(인 플레이스(in-place) 또는 블루/그린)에 대한 정보.
+ (선택 사항) 기존 배포 구성의 이름. 배포 구성의 목록을 보려면 [CodeDeploy의 배포 구성 세부 정보 보기](deployment-configurations-view-details.md) 단원을 참조하세요. 지정하지 않은 경우 CodeDeploy에서는 기본 배포 구성을 사용합니다.
+ (선택 사항) 배포 및 인스턴스 이벤트에 대한 알림을 Amazon Simple Notification Service 주제 구독자에게 푸시하는 트리거를 만드는 명령. 자세한 내용은 [Amazon SNS 이벤트 알림으로 배포 모니터링](monitoring-sns-event-notifications.md) 단원을 참조하십시오.
+ (선택 사항) 경보에 지정된 지표가 정의된 임계값을 초과하거나 해당 임계값 미만인 경우 활성화되는 기존 CloudWatch 경보를 배포 그룹에 추가하는 명령.
+ (선택 사항) 배포에 실패하거나 CloudWatch 경보가 활성화된 경우 알려진 최신 정상 개정으로 롤백하는 배포에 대한 명령.
+ (선택 사항) Auto Scaling 스케일 인 이벤트 중에 수명 주기 이벤트 후크를 생성하기 위한 배포 명령입니다. 자세한 내용은 [Amazon EC2 Auto Scaling에서 CodeDeploy를 사용하는 방식](integrations-aws-auto-scaling.md#integrations-aws-auto-scaling-behaviors) 단원을 참조하십시오.
+ 인 플레이스(in-place) 배포의 경우:
+ (선택 사항) 배포 프로세스 중 인스턴스로 가는 트래픽을 관리하는 Elastic Load Balancing의 Classic Load Balancer, Application Load Balancer 또는 Network Load Balancer의 이름.
+ 블루/그린 배포의 경우:
+ 블루/그린 배포 프로세스의 구성:
+ 대체 환경의 새 인스턴스를 프로비저닝하는 방법
+ 트래픽을 대체 환경으로 즉시 다시 라우팅할지, 아니면 지정된 시간 동안 대기한 후 트래픽을 수동으로 다시 라우팅할지 여부
+ 원본 환경의 인스턴스를 종료해야 할지 여부
+ 대체 환경에서 인스턴스를 등록하는 데 사용하는 Elastic Load Balancing의 Classic Load Balancer, Application Load Balancer 또는 Network Load Balancer의 이름.
**주의**
배포 그룹에서 오토 스케일링과 Elastic Load Balancing 로드 밸런서를 모두 구성하고 [로드 밸런서를 오토 스케일링에 연결](https://docs.aws.amazon.com/autoscaling/ec2/userguide/attach-load-balancer-asg.html)하려는 경우 이 배포 그룹에서 CodeDeploy 배포를 생성하기 *전에* 이 연결을 완료하는 것이 좋습니다. 배포를 생성한 후 연결을 완료하려고 하면 예기치 않게 로드 밸런서에서 모든 인스턴스의 등록이 취소될 수 있습니다.