기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# EC2/온프레미스 컴퓨팅 플랫폼의 배포 생성(CLI)
<a name="deployments-create-cli"></a>

 AWS CLI 를 사용하여 EC2/온프레미스 컴퓨팅 플랫폼에 개정 버전을 배포하려면:

1. 인스턴스를 준비하고, 애플리케이션을 생성하고, 개정을 푸시한 후 다음 중 하나를 수행합니다.
   + Amazon S3 버킷에 있는 개정을 배포하려면 지금 2단계로 진행합니다.
   + GitHub 리포지토리에 있는 개정을 배포하려면 먼저 [CodeDeploy 애플리케이션을 GitHub 리포지토리에 연결](deployments-create-cli-github.md)의 단계를 완료한 후 2단계로 진행합니다.

1. [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) 명령을 호출하여 다음을 지정합니다.
   + `--application-name`: 애플리케이션 이름. 애플리케이션 이름 목록을 보려면 [list-applications](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-applications.html) 명령을 호출합니다.
   + `--deployment-group-name`: Amazon EC2 배포 그룹 이름. 배포 그룹 이름 목록을 보려면 [list-deployment-groups](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-groups.html) 명령을 호출합니다.
   + `--revision`: 배포할 개정에 대한 정보:

     Amazon S3에 저장된 개정 버전의 경우:
     + `s3Location`: 개정이 포함되어 있는 Amazon S3 버킷 이름.
     + `s3Location --> key`: 업로드된 개정의 이름.
     + `s3Location --> bundleType`: 업로드된 개정의 파일 유형.
**참고**  
tar 및 압축된 tar 아카이브 파일 형식(.tar 및 .tar.gz)은 Windows Server 인스턴스에서 지원되지 않습니다.
     + `s3Location --> version`: (선택 사항) 개정 버전의 Amazon S3 버전 식별자. (버전 식별자를 지정하지 않으면 CodeDeploy에서는 가장 최근 버전을 사용합니다.)
     + `s3Location --> eTag`: (선택 사항) 개정의 ETag. (ETag를 지정하지 않으면 CodeDeploy가 객체 검증을 건너뜁니다.)

     GitHub에 저장된 개정의 경우:
     + `gitHubLocation --> repository`: 개정이 포함되어 있는 리포지토리의 GitHub 사용자 또는 그룹 이름, 슬래시(`/`), 리포지토리 이름(해당 순으로 입력)
     + `gitHubLocation --> commitId`: 개정의 커밋 ID
   + `--deployment-config-name`: (선택 사항) 사용할 배포 구성의 이름. 배포 구성 목록을 보려면 [list-deployment-configs](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-deployment-configs.html) 명령을 호출합니다. (지정하지 않은 경우 CodeDeploy에서는 특정 기본 배포 구성을 사용합니다.)
   + `--ignore-application-stop-failures | --no-ignore-application-stop-failures`: (선택 사항) `ApplicationStop` 배포 수명 주기 이벤트가 실패할 경우 인스턴스에 대한 배포가 `BeforeInstall` 배포 수명 주기 이벤트로 계속되도록 할지 여부.
   + `--description`: (선택 사항) 배포의 설명
   + `--file-exists-behavior`: (선택 사항) 배포 프로세스의 일부로 CodeDeploy 에이전트는 가장 최근 배포에 의해 설치된 모든 파일을 각 인스턴스에서 제거합니다. 이전 배포의 일부가 아닌 파일이 대상 배포 위치에 표시될 때 수행할 작업을 선택합니다.
   + `--target-instances`: 블루/그린 배포의 경우, 블루/그린 배포에서 대체 환경에 속하는 인스턴스에 대한 정보(하나 이상의 Amazon EC2 Auto Scaling 그룹 이름 또는 Amazon EC2 인스턴스를 식별하는 데 사용되는 태그 필터 키, 유형, 값 등)

**참고**  
다음 구문을 **create-deployment** 호출의 일환으로 사용해 Amazon S3에 있는 개정에 대한 정보를 명령줄에 직접 지정하세요. (`version` 및 `eTag`는 선택 사항입니다.)  

```
--s3-location bucket=string,key=string,bundleType=tar|tgz|zip,version=string,eTag=string
```
다음 구문을 **create-deployment** 호출의 일환으로 사용해 GitHub에 있는 개정에 대한 정보를 명령줄에 직접 지정하세요.  

```
--github-location repository=string,commitId=string
```
이미 푸시된 개정에 대한 정보를 확인하려면 [list-application-revisions](https://docs.aws.amazon.com/cli/latest/reference/deploy/list-application-revisions.html) 명령을 호출하세요.

배포 상태를 추적하려면 [CodeDeploy 배포 세부 정보 보기](deployments-view-details.md) 단원을 참조하세요.

## create-deployment 명령 참조
<a name="deployments-create-cli-reference"></a>

아래는 `create-deployment` 명령의 명령 구조 및 옵션입니다. 자세한 내용은 *AWS CLI 명령 참조*의 [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html) 참조를 참조합니다.

```
create-deployment
--application-name <value>
[--deployment-group-name <value>]
[--revision <value>]
[--deployment-config-name <value>]
[--description <value>]
[--ignore-application-stop-failures | --no-ignore-application-stop-failures]
[--target-instances <value>]
[--auto-rollback-configuration <value>]
[--update-outdated-instances-only | --no-update-outdated-instances-only]
[--file-exists-behavior <value>]
[--s3-location <value>]
[--github-location <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]
```

# CodeDeploy 애플리케이션을 GitHub 리포지토리에 연결
<a name="deployments-create-cli-github"></a>

를 사용하여 GitHub 리포지토리에서 애플리케이션을 처음 배포하려면 먼저 CodeDeploy에 GitHub 계정을 대신하여 GitHub와 상호 작용할 수 있는 권한을 부여 AWS CLI해야 합니다. 이 단계는 CodeDeploy 콘솔을 사용하는 애플리케이션 각각에 대해 한 번씩 완료해야 합니다.

1. 에 로그인 AWS Management Console 하고 [https://console.aws.amazon.com/codedeploy](https://console.aws.amazon.com/codedeploy) CodeDeploy 콘솔을 엽니다.
**참고**  
[CodeDeploy 시작하기](getting-started-codedeploy.md)에서 설정한 사용자와 동일한 사용자로 로그인합니다.

1. [**Applications**]를 선택합니다.

1. [**Application**]에서 GitHub 사용자 계정에 연결할 애플리케이션을 선택하고 [**Deploy application**]을 선택합니다.
**참고**  
배포를 만들고 있지 않습니다. 이는 현재 GitHub 사용자 계정을 대신하여 CodeDeploy에 GitHub와 상호 작용할 권한을 부여하는 유일한 방법입니다.

1. [**Repository type**] 옆의 [**My application revision is stored in GitHub**]를 선택합니다.

1. **GitHub에 연결**을 선택합니다.
**참고**  
**다른 GitHub 계정에 연결** 링크가 보이는 경우:  
애플리케이션에 대해 다른 GitHub 계정을 대신하여 GitHub와 상호 작용할 권한을 CodeDeploy에 이미 부여했을 수 있습니다.  
CodeDeploy에 연결된 모든 애플리케이션에 대해 로그인한 GitHub 계정을 대신하여 GitHub와 상호 작용할 CodeDeploy의 권한을 취소했을 수 있습니다.  
자세한 내용은 [CodeDeploy에서 애플리케이션으로 GitHub 인증](integrations-partners-github.md#behaviors-authentication) 단원을 참조하십시오.

1. GitHub에 아직 로그인하지 않은 경우, [**Sign in**] 페이지의 지침을 따릅니다.

1. [**Authorize application**] 페이지에서 [**Authorize application**]을 선택합니다.

1. 이제 CodeDeploy에 권한이 있으므로 **취소**를 선택한 후 [EC2/온프레미스 컴퓨팅 플랫폼의 배포 생성(CLI)](deployments-create-cli.md)의 단계를 계속 진행합니다.