

# AWS Copilot 명령줄 인터페이스를 사용하여 Amazon ECS 리소스 생성
<a name="AWS_Copilot"></a>

**AWS Copilot CLI 지원 종료 알림**  
AWS Copilot CLI는 **2026년 6월 12일**에 지원이 종료됩니다. 이 날짜 이후에는 해당 도구에 더 이상 업데이트, 보안 패치 또는 기술 지원이 제공되지 않습니다.  
2026년 6월 12일 이후 새로운 기능 또는 개선 사항 없음
보안 업데이트 또는 버그 수정 없음
기술 지원 없음
기존 배포는 계속 작동하지만 지속적인 유지 관리는 제공되지 않음
**도움이 필요하세요?** 자세한 마이그레이션 지침은 AWS 지원팀에 문의하거나 [블로그 게시물](https://aws.amazon.com/blogs/containers/announcing-the-end-of-support-for-the-aws-copilot-cli/)을 참조하세요.

AWS Copilot 명령줄 인터페이스(CLI)는 로컬 개발 환경에서 Amazon ECS를 기반으로 프로덕션 지원 컨테이너화 애플리케이션을 간단하게 구축, 릴리스, 운영할 수 있는 명령을 제공합니다. AWS Copilot CLI는 최신 애플리케이션 모범 사례를 지원하는 개발자 워크플로와 일치합니다. 코드형 인프라에서 사용자 대신 프로비저닝한 CI/CD 파이프라인을 생성하는 것까지 모두 가능합니다. 일상적인 개발 및 테스트 사이클에서 AWS Management Console 대신 AWS Copilot CLI를 사용합니다.

현재 AWS Copilot은 Linux, macOS 및 Windows 시스템을 지원합니다. 최신 버전의 AWS Copilot CLI에 대한 자세한 내용은 [릴리스](https://github.com/aws/copilot-cli/releases)를 참조하세요.

**참고**  
AWS Copilot CLI의 소스 코드는 [GitHub](https://github.com/aws/copilot-cli)에서 얻을 수 있습니다. 포함하고 싶은 변경 사항에 대해서는 문제 및 풀 요청을 제출할 것을 권장합니다. 하지만 Amazon Web Services는 현재 AWS Copilot 코드의 변경된 사본을 실행하도록 지원하지 않습니다. [Gitter](https://app.gitter.im/#/room/#aws_copilot-cli:gitter.im) 또는 [GitHub](https://github.com/aws/copilot-cli)에서 문의를 통해 AWS Copilot에 대한 문제를 보고하세요. 여기에서 문제를 신고하고, 피드백을 제공하고, 버그를 보고할 수 있습니다.  
Copilot 개발에 대한 자세한 내용은 [What's the future of Copilot?](https://github.com/aws/copilot-cli/issues/5925)을 참조하세요.

**Topics**
+ [AWS Copilot CLI 설치](copilot-install.md)
+ [AWS Copilot CLI를 사용하여 샘플 Amazon ECS 애플리케이션 배포](copilot-deploy.md)

AWS Copilot CLI에 대한 추가 문서는 [AWS Copilot 웹 사이트](https://aws.github.io/copilot-cli/docs/overview/)에서 확인할 수 있습니다.

# AWS Copilot CLI 설치
<a name="copilot-install"></a>

**AWS Copilot CLI 지원 종료 알림**  
AWS Copilot CLI는 **2026년 6월 12일**에 지원이 종료됩니다. 이 날짜 이후에는 해당 도구에 더 이상 업데이트, 보안 패치 또는 기술 지원이 제공되지 않습니다.  
2026년 6월 12일 이후 새로운 기능 또는 개선 사항 없음
보안 업데이트 또는 버그 수정 없음
기술 지원 없음
기존 배포는 계속 작동하지만 지속적인 유지 관리는 제공되지 않음
**도움이 필요하세요?** 자세한 마이그레이션 지침은 AWS 지원팀에 문의하거나 [블로그 게시물](https://aws.amazon.com/blogs/containers/announcing-the-end-of-support-for-the-aws-copilot-cli/)을 참조하세요.

Homebrew를 사용하거나 다음 단계에 따라 바이너리를 수동으로 다운로드하여 AWS Copilot CLI를 설치할 수 있습니다.

## Homebrew 사용
<a name="copilot-install-homebrew"></a>

다음 명령은 Homebrew를 사용하여 macOS 또는 Linux 시스템에 AWS Copilot CLI를 설치하는 데 사용합니다. 설치하기 전에 미리 Homebrew를 설치해야 합니다. 자세한 내용은 [Homebrew](https://brew.sh/)를 참조하세요.

```
brew install aws/tap/copilot-cli
```

## 바이너리 다운로드
<a name="copilot-install-manual"></a>

Homebrew 대신 macOS, Windows 또는 Linux 시스템에 AWS Copilot CLI를 수동으로 설치할 수 있습니다. 바이너리를 다운로드하려면 운영 체제에 따라 다음 명령을 사용하세요. macOS 및 Linux 예제에는 또한 바이너리에 실행 권한을 적용하는 명령이 포함되어 있으며 설치가 되는지 확인하는 도움말 메뉴를 나열합니다.

------
#### [ macOS ]

macOS의 경우:

```
sudo curl -Lo /usr/local/bin/copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin \
   && sudo chmod +x /usr/local/bin/copilot \
   && copilot --help
```

macOS ARM 시스템의 경우:

```
sudo curl -Lo /usr/local/bin/copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin-arm64 \
   && sudo chmod +x /usr/local/bin/copilot \
   && copilot --help
```

------
#### [ Linux ]

Linux x86 (64-bit) 시스템:

```
sudo curl -Lo /usr/local/bin/copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux \
   && sudo chmod +x /usr/local/bin/copilot \
   && copilot --help
```

Linux ARM 시스템:

```
sudo curl -Lo /usr/local/bin/copilot https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64 \
   && sudo chmod +x /usr/local/bin/copilot \
   && copilot --help
```

------
#### [ Windows ]

PowerShell을 사용하여 다음의 명령을 실행합니다.

```
New-Item -Path 'C:\copilot' -ItemType directory; `
  Invoke-WebRequest -OutFile 'C:\copilot\copilot.exe' https://github.com/aws/copilot-cli/releases/latest/download/copilot-windows.exe
```

------

### (선택 사항) PGP 서명을 사용하여 수동으로 설치한 AWS Copilot CLI 확인
<a name="ECS_Copilot_validate"></a>

AWS Copilot CLI 실행 파일은 PGP 서명을 사용하여 암호화 서명됩니다. PGP 서명은 AWS Copilot CLI 실행 파일의 유효성을 확인하는 데 사용할 수 있습니다. 다음 단계에 따라 GnuPG 도구를 사용하여 서명을 확인할 수 있습니다.

1. GnuPG를 다운로드하고 설치합니다. 자세한 내용은 [GnuPG 웹 사이트](https://www.gnupg.org)를 참조하세요.

------
#### [ macOS ]

   Homebrew를 사용하는 것이 좋습니다. 웹 사이트의 지침에 따라 Homebrew를 설치합니다. 자세한 내용은 [Homebrew](https://brew.sh/)를 참조하세요. Homebrew 설치 이후 macOS 터미널에서 다음 명령을 실행합니다.

   ```
   brew install gnupg
   ```

------
#### [ Linux ]

   원하는 Linux 패키지 관리자를 사용하여 `gpg`를 설치합니다.

------
#### [ Windows ]

   GnuPG 웹 사이트에서 Windows Simple Installer를 다운로드하고 관리자로 설치합니다. GnuPG를 설치한 후 Administrator PowerShell을 닫았다가 다시 엽니다.

    자세한 내용은 [GnuPG Download](https://www.gnupg.org/download/index.html)를 참조하세요.

------

1. GnuPG 경로가 환경 경로에 추가되었는지 확인합니다.

------
#### [ macOS ]

   ```
   echo $PATH
   ```

   출력에 GnuPG 경로가 보이지 않는 경우 다음 명령을 실행하여 경로에 추가하세요.

   ```
   PATH=$PATH:<path to GnuPG executable files>
   ```

------
#### [ Linux ]

   ```
   echo $PATH
   ```

   출력에 GnuPG 경로가 보이지 않는 경우 다음 명령을 실행하여 경로에 추가하세요.

   ```
   export PATH=$PATH:<path to GnuPG executable files>
   ```

------
#### [ Windows ]

   ```
   Write-Output $Env:PATH
   ```

   출력에 GnuPG 경로가 보이지 않는 경우 다음 명령을 실행하여 경로에 추가하세요.

   ```
   $Env:PATH += ";<path to GnuPG executable files>"
   ```

------

1. 로컬 일반 텍스트 파일을 생성합니다.

------
#### [ macOS ]

   터미널에서 다음을 입력합니다.

   ```
   touch <public_key_filename.txt>
   ```

   TextEdit로 파일을 엽니다.

------
#### [ Linux ]

   gedit와 같은 텍스트 편집기에서 텍스트 파일을 생성합니다. `public_key_filename.txt`로 저장합니다.

------
#### [ Windows ]

   메모장과 같은 텍스트 편집기에서 텍스트 파일을 생성합니다. `public_key_filename.txt`로 저장합니다.

------

1. Amazon ECS PGP 퍼블릭 키의 다음 내용을 추가하고 파일을 저장합니다.

   ```
   -----BEGIN PGP PUBLIC KEY BLOCK-----
   Version: GnuPG v2
   
   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
   =Gi5D
   -----END PGP PUBLIC KEY BLOCK-----
   ```

   참조용 Amazon ECS PGP 퍼블릭 키에 대한 세부 정보:

   ```
   Key ID: BCE9D9A42D51784F
   Type: RSA
   Size: 4096/4096
   Expires: Never
   User ID: Amazon ECS
   Key fingerprint: F34C 3DDA E729 26B0 79BE AEC6 BCE9 D9A4 2D51 784F
   ```

1. 터미널에서 다음 명령을 사용하여 Amazon ECS PGP 퍼블릭 키로 파일을 가져옵니다.

   ```
   gpg --import <public_key_filename.txt>
   ```

1. AWS Copilot CLI 서명을 다운로드합니다. 서명은 `.asc` 확장자 파일에 저장된 ASCII 분리 PGP 서명입니다. 서명 파일은 해당 실행 파일과 동일한 이름에 `.asc`가 추가되어 있습니다.

------
#### [ macOS ]

   macOS 시스템의 경우 다음 명령을 사용합니다.

   ```
   sudo curl -Lo copilot.asc https://github.com/aws/copilot-cli/releases/latest/download/copilot-darwin.asc
   ```

------
#### [ Linux ]

   Linux x86(64비트) 시스템은 다음의 명령을 실행합니다.

   ```
   sudo curl -Lo copilot.asc https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux.asc
   ```

   Linux ARM 시스템은 다음의 명령을 실행합니다.

   ```
   sudo curl -Lo copilot.asc https://github.com/aws/copilot-cli/releases/latest/download/copilot-linux-arm64.asc
   ```

------
#### [ Windows ]

   PowerShell을 사용하여 다음의 명령을 실행합니다.

   ```
   Invoke-WebRequest -OutFile 'C:\copilot\copilot.asc' https://github.com/aws/copilot-cli/releases/latest/download/copilot-windows.exe.asc
   ```

------

1. 다음 명령으로 서명을 확인합니다.
   + macOS 및 Linux 시스템의 경우:

     ```
     gpg --verify copilot.asc /usr/local/bin/copilot
     ```
   + Windows 시스템의 경우:

     ```
     gpg --verify 'C:\copilot\copilot.asc' 'C:\copilot\copilot.exe'
     ```

   예상 결과:

   ```
   gpg: Signature made Tue Apr  3 13:29:30 2018 PDT
   gpg:                using RSA key DE3CBD61ADAF8B8E
   gpg: Good signature from "Amazon ECS <ecs-security@amazon.com>" [unknown]
   gpg: WARNING: This key is not certified with a trusted signature!
   gpg:          There is no indication that the signature belongs to the owner.
   Primary key fingerprint: F34C 3DDA E729 26B0 79BE  AEC6 BCE9 D9A4 2D51 784F
        Subkey fingerprint: EB3D F841 E2C9 212A 2BD4  2232 DE3C BD61 ADAF 8B8E
   ```
**중요**  
결과에서 경고가 예상되지만 문제가 되지는 않습니다. 개인 PGP 키(보유한 경우)와 Amazon ECS PGP 키 사이에 신뢰 체인이 없기 때문에 발생한 것입니다. 자세한 내용은 [Web of trust](https://en.wikipedia.org/wiki/Web_of_trust)를 참조하세요.

1. Windows 설치의 경우 Powershell에서 다음 명령을 실행하여 AWS Copilot 디렉터리를 경로에 추가합니다.

   ```
    $Env:PATH += ";<path to Copilot executable files>"
   ```

# AWS Copilot CLI를 사용하여 샘플 Amazon ECS 애플리케이션 배포
<a name="copilot-deploy"></a>

**AWS Copilot CLI 지원 종료 알림**  
AWS Copilot CLI는 **2026년 6월 12일**에 지원이 종료됩니다. 이 날짜 이후에는 해당 도구에 더 이상 업데이트, 보안 패치 또는 기술 지원이 제공되지 않습니다.  
2026년 6월 12일 이후 새로운 기능 또는 개선 사항 없음
보안 업데이트 또는 버그 수정 없음
기술 지원 없음
기존 배포는 계속 작동하지만 지속적인 유지 관리는 제공되지 않음
**도움이 필요하세요?** 자세한 마이그레이션 지침은 AWS 지원팀에 문의하거나 [블로그 게시물](https://aws.amazon.com/blogs/containers/announcing-the-end-of-support-for-the-aws-copilot-cli/)을 참조하세요.

AWSCopilot CLI를 설치한 후 다음 단계에 따라 샘플 앱을 배포하고, 배포를 확인하고, 리소스를 정리할 수 있습니다.

## 사전 조건
<a name="copilot-cli-prerequisites"></a>

시작하기 전에 다음 사전 조건을 충족하는지 확인합니다.
+ AWS CLI를 설치하고 구성합니다. 자세한 내용은 [AWS 명령줄 인터페이스](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html)를 참조하세요.
+ `aws configure`를 실행하여 애플리케이션 및 서비스를 관리하기 위해 AWS Copilot CLI에서 사용할 기본 프로필을 설정합니다.
+ Docker를 설치 및 실행합니다. 자세한 내용은 [Docker 시작하기](https://www.docker.com/get-started)를 참조하세요.

## 단일 명령을 사용하여 샘플 Amazon ECS 애플리케이션 배포
<a name="copilot-deploy-one"></a>

1. 다음 명령을 사용하여 GitHub 리포지토리에서 복제된 샘플 웹 애플리케이션을 배포하세요. AWS Copilot `init` 및 해당 플래그에 대한 자세한 내용은 [AWS Copilot 설명서](https://aws.github.io/copilot-cli/docs/commands/init/)를 참조하세요.

   ```
   git clone https://github.com/aws-samples/aws-copilot-sample-service.git demo-app && \ 
   cd demo-app &&                               \
   copilot init --app demo                      \
     --name api                                 \
     --type 'Load Balanced Web Service'         \
     --dockerfile './Dockerfile'                \
     --port 80                                  \
     --tag  latest                              \
     --deploy
   ```

1. 배포가 완료되면 AWS Copilot CLI는 배포를 확인하는 데 사용할 수 있는 URL을 반환합니다. 다음 명령을 사용하여 앱의 상태를 확인할 수도 있습니다.
   + AWS Copilot 애플리케이션을 모두 나열합니다.

     ```
     copilot app ls
     ```
   + 애플리케이션의 환경 및 서비스에 대한 정보를 표시합니다.

     ```
     copilot app show
     ```
   + 환경에 대한 정보를 표시합니다.

     ```
     copilot env ls
     ```
   + 엔드포인트, 용량 및 관련 리소스를 포함하여 서비스에 대한 정보를 표시합니다.

     ```
     copilot svc show
     ```
   + 애플리케이션의 모든 서비스 목록입니다.

     ```
     copilot svc ls
     ```
   + 배포된 서비스의 로그를 표시합니다.

     ```
     copilot svc logs
     ```
   + 서비스 상태를 표시합니다.

     ```
     copilot svc status
     ```

1. 이 데모를 완료하면 다음 명령을 실행하여 관련 리소스를 정리하고 사용하지 않은 리소스에 대한 요금이 부과되지 않도록 하세요.

   ```
   copilot app delete
   ```