기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다. # Docker AWS CLI및 컨테이너용 Lightsail 제어 플러그인 설치 Amazon Lightsail 콘솔을 사용하여 Lightsail 컨테이너 서비스를 생성하고, Amazon ECR Public Gallery와 같은 온라인 퍼블릭 레지스트리의 컨테이너 이미지를 사용하여 배포를 생성할 수 있습니다. 사용자의 자체 컨테이너 이미지를 생성하고 컨테이너 서비스에 푸시하려면, 컨테이너 이미지를 생성하려는 동일한 컴퓨터에 다음과 같은 추가 소프트웨어를 설치해야 합니다. + **Docker** - Lightsail 컨테이너 서비스에서 사용할 수 있는 자체 컨테이너 이미지를 실행, 테스트 및 생성합니다. + **AWS Command Line Interface (AWS CLI)** - 생성한 컨테이너 이미지의 파라미터를 지정한 다음 Lightsail 컨테이너 서비스로 푸시합니다. 버전 2.1.1 이상은 Lightsail Control 플러그 인과 함께 사용할 수 있습니다. + **Lightsail 제어(lightsailctl) 플러그인** -가 로컬 시스템에 있는 컨테이너 이미지에 액세스할 수 AWS CLI 있도록 합니다. 이 가이드의 다음 섹션에서는 이러한 소프트웨어 패키지를 다운로드할 수 있는 위치와 설치 방법을 안내합니다. 컨테이너 서비스에 대한 자세한 내용은 [컨테이너 서비스](amazon-lightsail-container-services.md)를 참조하세요. **목차** + [Docker 설치](#install-software-docker) + [설치 AWS CLI](#install-software-aws-cli) + [Lightsail Control 플러그 인 설치](#install-software-lightsailctl) + [Windows에 lightsailctl 플러그인 설치](#install-lightsailctl-on-windows) + [macOS에 lightsailctl 플러그인 설치](#install-lightsailctl-on-macos) + [Linux에 lightsailctl 플러그인 설치](#install-lightsailctl-on-linux) ## Docker 설치 Docker는 Linux 컨테이너를 기반으로 하는 분산 애플리케이션을 구축, 실행, 테스트 및 배포할 수 있는 기술입니다. Lightsail 컨테이너 서비스와 함께 사용할 수 있는 자체 컨테이너 이미지를 생성하려면 Docker 소프트웨어를 설치하고 사용해야 합니다. 자세한 내용은 [Lightsail 컨테이너 서비스의 컨테이너 이미지 생성](amazon-lightsail-creating-container-images.md)을 참조하세요. Docker는 최신 Linux 배포 버전(Ubuntu 등)을 비롯하여 macOS 및 Windows 등 다양한 운영 체제에서 사용할 수 있습니다. 특정 운영 체제에 Docker를 설치하는 방법에 대한 자세한 내용은 [Docker 설치 가이드](https://docs.docker.com/engine/installation/#installation)를 참조하세요. **참고** 항상 최신 Docker 버전을 설치해야 합니다. 이전 버전의 Docker는이 가이드의 뒷부분에 설명된 AWS CLI 및 Lightsail 제어(lightsailctl) 플러그인과 함께 사용할 수 없습니다. ## 설치 AWS CLI AWS CLI 는 명령줄 셸의 명령을 Lightsail사용하여와 같은 AWS 서비스와 상호 작용할 수 있는 오픈 소스 도구입니다. AWS CLI 를 설치하고 사용하여 로컬 시스템에서 생성된 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시해야 합니다. AWS CLI 는 다음 버전에서 사용할 수 있습니다. + **버전 2.x** – 일반적으로 사용 가능한 최신 버전의 AWS CLI입니다. 이 버전은의 최신 메이저 버전 AWS CLI 이며 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시하는 기능을 포함하여 모든 최신 기능을 지원합니다. 버전 2.1.1 이상은 Lightsail Control 플러그 인과 함께 사용할 수 있습니다. + **버전 1.x** - 이전 버전과의 호환성을 위해 사용할 수 AWS CLI 있는의 이전 버전입니다. 이 버전은 컨테이너 이미지를 Lightsail 컨테이너 서비스에 푸시하는 기능을 지원하지 않습니다. 따라서 버전 AWS CLI 2를 대신 설치해야 합니다. AWS CLI 버전 2는 Linux, macOS 및 Windows 운영 체제에서 사용할 수 있습니다. 이러한 운영 체제에를 설치하는 방법에 AWS CLI 대한 지침은 *AWS CLI 사용 설명서*[의 AWS CLI 버전 2 설치를](https://docs.aws.amazon.com/cli/latest/userguide/install-cliv2.html) 참조하세요. ## Lightsail Control 플러그 인 설치 Lightsail Control(lightsailctl) 플러그인은가 로컬 시스템에서 생성한 컨테이너 이미지에 AWS CLI 액세스할 수 있도록 하는 경량 애플리케이션입니다. 이 플러그 인을 사용하면 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시하여 서비스에 배포할 수 있습니다. **시스템 요구 사항** + 64비트를 지원하는 Windows, macOS 또는 Linux 운영 체제가 필요합니다. + AWS CLI lightsailctl 플러그인을 사용하려면 버전 2를 로컬 시스템에 설치해야 합니다. 자세한 내용은 이 설명서 앞부분의 [AWS CLI설치](#install-software-aws-cli) 섹션을 참조하세요. **최신 버전의 lightsailctl 플러그인 사용** lightsailctl 플러그인은 때때로 향상된 기능으로 업데이트됩니다. lightsailctl 플러그인을 사용할 때마다 최신 버전을 사용하고 있는지 확인합니다. 새 버전이 지원되는 경우, 최신 기능을 사용하려면 최신 버전으로 업데이트하라는 메시지가 표시됩니다. 업데이트된 버전을 사용할 수 있는 경우 설치 프로세스를 반복하여 최신 버전의 lightsailctl 플러그인을 가져와야 합니다. 다음은 lightsailctl 플러그인의 모든 릴리스와 각 버전에 포함된 기능 및 개선 사항을 나열합니다. + **v1.0.0(2020년 11월 12일 릴리스)** - 최초 릴리스에서는 AWS CLI 버전 2가 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시하는 기능을 추가합니다. ### Windows에 lightsailctl 플러그인 설치 Windows에 lightsailctl 플러그인을 설치하려면 다음 절차를 완료하세요. 1. 다음 URL에서 실행 파일을 다운로드하고 `C:\Temp\lightsailctl\` 디렉터리에 저장합니다. ``` https://s3.us-west-2.amazonaws.com/lightsailctl/latest/windows-amd64/lightsailctl.exe ``` 1. **Windows 시작(Windows Start)** 버튼을 선택한 다음 `cmd`를 검색합니다. 1. 검색 결과에서 **명령 프롬프트(Command Prompt)** 애플리케이션을 마우스 오른쪽 버튼으로 클릭하고 **관리자 권한으로 실행(Run as administrator)**을 선택합니다. ![관리자 권한으로 명령 프롬프트 실행](http://docs.aws.amazon.com/ko_kr/lightsail/latest/userguide/images/lightsailctl-cmd-run-as-administrator.png) **참고** 명령 프롬프트(Command Prompt)에서 디바이스를 변경할 수 있도록 허용할지 묻는 메시지가 나타날 수 있습니다. 설치를 계속하려면 **예(Yes)**를 선택해야 합니다. 1. 다음 명령을 입력하여 lightsailctl 플러그인을 저장한 `C:\Temp\lightsailctl\` 디렉터리를 가리키는 경로 환경 변수를 설정합니다. ``` setx PATH "%PATH%;C:\Temp\lightsailctl" /M ``` 다음 예제와 비슷한 결과가 나타나야 합니다. ![setx 명령에 대한 명령줄 응답](http://docs.aws.amazon.com/ko_kr/lightsail/latest/userguide/images/lighstailctl-setx-command.png) 이`setx` 명령은 1024자를 초과하여 잘립니다. PATH에 이미 여러 변수가 설정되어 있는 경우 다음 절차를 사용하여 경로 환경 변수를 수동으로 설정하세요. 1. **시작(Start)** 메뉴에서 **제어판(Control Panel)**을 클릭합니다. 1. **시스템 및 보안(System and Security)을** 선택한 다음 **시스템(System)을** 선택합니다. 1. **고급 시스템 설정**을 선택합니다. 1. **시스템 속성(System Properties)** 대화 상자에서 **고급(Advanced)** 탭을 선택한 다음 [**환경 변수(Environment Variables)**를 선택합니다. 1. **환경 변수(Environment Variables)** 대화 상자의 **시스템 변수(System Variables)** 상자에서 **경로(Path)**를 선택합니다. 1. **시스템 변수(System Variables)** 대화 상자 아래에 있는 **편집(Edit)** 버튼을 선택합니다. ![Windows 시스템 변수](http://docs.aws.amazon.com/ko_kr/lightsail/latest/userguide/images/lightsail-windows-system-variables.png) 1. **신규(New)를** 선택한 후 다음 경로를 입력합니다.`C:\Temp\lightsailctl\` ![Windows 환경 변수](http://docs.aws.amazon.com/ko_kr/lightsail/latest/userguide/images/lightsail-windows-edit-env-variable.png) 1. 세 개의 연속된 대화 상자에서 **확인(OK)**을 선택한 다음 **시스템(System)** 대화 상자를 닫습니다. 이제 AWS Command Line Interface (AWS CLI)를 사용하여 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시할 준비가 되었습니다. 자세한 내용은 [컨테이너 이미지 푸시 및 관리](amazon-lightsail-pushing-container-images.md)를 참조하세요. ### macOS에 lightsailctl 플러그인 설치 다음 절차 중 하나를 완료하여 macOS에 lightsailctl 플러그인을 다운로드하고 설치합니다. **Homebrew 다운로드 및 설치** 1. 터미널 창을 엽니다. 1. 다음 명령을 입력하여 lightsailctl 플러그인을 다운로드하고 설치합니다. ``` brew install aws/tap/lightsailctl ``` **참고** Homebrew에 대한 자세한 내용은 [Homebrew](https://brew.sh/) 웹 사이트를 참조하세요. **수동 다운로드 및 설치** 1. 터미널 창을 엽니다. 1. 다음 명령을 입력하여 lightsailctl 플러그인을 다운로드하고 bin 폴더에 복사합니다. ``` curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/darwin-amd64/lightsailctl" -o "/usr/local/bin/lightsailctl" ``` 1. 다음 명령을 입력하여 플러그 인을 실행할 수 있도록 합니다. ``` chmod +x /usr/local/bin/lightsailctl ``` 1. 다음 명령을 입력하여 플러그 인의 확장 속성을 지웁니다. ``` xattr -c /usr/local/bin/lightsailctl ``` 이제 AWS CLI 를 사용하여 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시할 준비가 되었습니다. 자세한 내용은 [컨테이너 이미지 푸시 및 관리](amazon-lightsail-pushing-container-images.md)를 참조하세요. ### Linux에 lightsailctl 플러그인 설치 Linux에 Lightsail 컨테이너 서비스 플러그 인을 설치하려면 다음 절차를 완료하세요. 1. 터미널 창을 엽니다. 1. 다음 명령을 입력하여 lightsailctl 플러그인을 다운로드합니다. + AMD 64비트 아키텍처 버전의 플러그 인: ``` curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/linux-amd64/lightsailctl" -o "/usr/local/bin/lightsailctl" ``` + ARM 64비트 아키텍처 버전의 플러그 인: ``` curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/linux-arm64/lightsailctl" -o "/usr/local/bin/lightsailctl" ``` 1. 다음 명령을 입력하여 플러그 인을 실행할 수 있도록 합니다. ``` sudo chmod +x /usr/local/bin/lightsailctl ``` 이제 AWS CLI 를 사용하여 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시할 준비가 되었습니다. 자세한 내용은 [컨테이너 이미지 푸시 및 관리](amazon-lightsail-pushing-container-images.md)를 참조하세요.