AWS Copilot CLI 설치하기

AWS Copilot CLI를 Homebrew로 설치하거나 바이너리를 직접 다운로드하는 방법을 알려드려요. 이 도구를 설치하면 Amazon ECS에서 컨테이너 애플리케이션을 더 쉽게 배포할 수 있어요.

출처: 문서

본문

AWS Copilot CLI 지원 종료 안내 AWS Copilot CLI는 2026년 6월 12일에 지원이 종료됩니다. 이 날짜 이후에는 이 도구에 업데이트, 보안 패치, 기술 지원이 더 이상 제공되지 않습니다.

2026년 6월 12일 이후 새로운 기능이나 개선 사항 없음
보안 업데이트나 버그 수정 없음
기술 지원 없음
기존 배포는 계속 동작하지만, 지속적인 유지 관리 없이 유지됩니다.
도움이 필요하면 AWS Support에 문의하거나 자세한 마이그레이션 안내를 위해 블로그 포스트를 방문하세요.

AWS Copilot CLI는 Homebrew를 사용하거나 바이너리를 수동으로 다운로드해 설치할 수 있습니다.

Homebrew 사용하기

다음 명령은 Homebrew를 사용해 macOS나 Linux 시스템에 AWS Copilot CLI를 설치합니다. 설치 전에 Homebrew가 설치되어 있어야 합니다. 자세한 내용은 Homebrew를 참고하세요.

brew install aws/tap/copilot-cli

바이너리 다운로드

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비트) 시스템의 경우:

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 검증하기

AWS Copilot CLI 실행 파일은 PGP 서명으로 암호화되어 서명됩니다. PGP 서명을 사용해 AWS Copilot CLI 실행 파일의 유효성을 검증할 수 있습니다. 다음 단계에 따라 GnuPG 도구로 서명을 검증하세요.

GnuPG를 다운로드하고 설치하세요. 자세한 내용은 GnuPG 웹사이트를 참고하세요.
- macOS: Homebrew를 사용하는 것을 권장합니다. Homebrew 설치 후 다음 명령을 사용하세요.
```
brew install gnupg
```
- Linux: 사용하는 Linux 배포판의 패키지 관리자로 gpg를 설치하세요.
- Windows: GnuPG 웹사이트에서 Windows 간편 설치 프로그램을 다운로드해 관리자 권한으로 설치하세요. GnuPG 설치 후 관리자 PowerShell을 닫고 다시 여세요.
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>"
```
로컬에 일반 텍스트 파일을 만드세요.
- macOS: 터미널에 다음을 입력하세요.
```
touch <public_key_filename.txt>
```
  TextEdit로 파일을 여세요.
- Linux: gedit 같은 텍스트 편집기에서 텍스트 파일을 만들고 public_key_filename.txt로 저장하세요.
- Windows: 메모장 같은 텍스트 편집기에서 텍스트 파일을 만들고 public_key_filename.txt로 저장하세요.
Amazon ECS PGP 공개 키의 다음 내용을 추가하고 파일을 저장하세요.

참고용 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

다음 명령으로 Amazon ECS PGP 공개 키가 담긴 파일을 터미널에서 가져오세요.

gpg --import <public_key_filename.txt>

AWS Copilot CLI 서명을 다운로드하세요. 서명은 .asc 확장자를 가진 ASCII detached 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
```

다음 명령으로 서명을 검증하세요.

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 <[email protected]>" [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를 참고하세요.

Windows 설치의 경우, PowerShell에서 다음 명령을 실행해 AWS Copilot 디렉터리를 경로에 추가하세요.

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

AWS Copilot CLI 설치하기