컨테이너용 Docker, AWS CLI 및 Lightsail Control 플러그인 설치 - Amazon Lightsail

컨테이너용 Docker, AWS CLI 및 Lightsail Control 플러그인 설치

Amazon Lightsail 콘솔을 사용하여 Lightsail 컨테이너 서비스를 생성하고, Amazon ECR Public Gallery와 같은 온라인 퍼블릭 레지스트리의 컨테이너 이미지를 사용하여 배포를 생성할 수 있습니다. 사용자의 자체 컨테이너 이미지를 생성하고 컨테이너 서비스에 푸시하려면, 컨테이너 이미지를 생성하려는 동일한 컴퓨터에 다음과 같은 추가 소프트웨어를 설치해야 합니다.

  • Docker - Lightsail 컨테이너 서비스에서 사용할 수 있는 자체 컨테이너 이미지를 실행, 테스트 및 생성합니다.

  • AWS Command Line Interface(AWS CLI) – 생성한 컨테이너 이미지의 파라미터를 지정한 다음, Lightsail 컨테이너 서비스에 푸시할 수 있습니다. 버전 2.1.1 이상은 Lightsail Control 플러그 인과 함께 사용할 수 있습니다.

  • Lightsail Control(lightsailctl) 플러그인 – AWS CLI를 활성화하여 로컬 시스템에 있는 컨테이너 이미지에 액세스할 수 있습니다.

이 가이드의 다음 섹션에서는 이러한 소프트웨어 패키지를 다운로드할 수 있는 위치와 설치 방법을 안내합니다. 컨테이너 서비스에 대한 자세한 내용은 컨테이너 서비스를 참조하세요.

목차

Docker 설치

Docker는 Linux 컨테이너를 기반으로 하는 분산 애플리케이션을 구축, 실행, 테스트 및 배포할 수 있는 기술입니다. Lightsail 컨테이너 서비스와 함께 사용할 수 있는 자체 컨테이너 이미지를 생성하려면 Docker 소프트웨어를 설치하고 사용해야 합니다. 자세한 내용은 Lightsail 컨테이너 서비스의 컨테이너 이미지 생성을 참조하세요.

Docker는 최신 Linux 배포 버전(Ubuntu 등)을 비롯하여 macOS 및 Windows 등 다양한 운영 체제에서 사용할 수 있습니다. 특정 운영 체제에 Docker를 설치하는 방법에 대한 자세한 내용은 Docker 설치 가이드를 참조하세요.

참고

항상 최신 Docker 버전을 설치해야 합니다. 이전 Docker 버전은 이 설명서의 후반부에 나와 있는 AWS CLI 및 Lightsail Control(lightsailctl) 플러그인과 함께 사용하지 못할 수도 있습니다.

AWS CLI 설치

AWS CLI는 명령줄 쉘의 명령을 사용하여 Lightsail 등의 AWS 서비스와 상호 작용할 수 있는 오픈 소스 도구입니다. 로컬 시스템에 생성된 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시하려면 AWS CLI를 설치하고 사용해야 합니다.

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 설치를 참조하세요.

Lightsail Control 플러그 인 설치

Lightsail Control(lightsailctl) 플러그인은 용량이 작은 애플리케이션으로, AWS CLI가 로컬 시스템에서 생성한 컨테이너 이미지에 액세스할 수 있도록 지원합니다. 이 플러그 인을 사용하면 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시하여 서비스에 배포할 수 있습니다.

시스템 요구 사항

  • 64비트를 지원하는 Windows, macOS 또는 Linux 운영 체제가 필요합니다.

  • lightsailctl 플러그인을 사용하려면 로컬 시스템에 AWS CLI 버전 2가 설치되어 있어야 합니다. 자세한 내용은 이 설명서 앞부분의 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
  2. Windows 시작(Windows Start) 버튼을 선택한 다음 cmd를 검색합니다.

  3. 검색 결과에서 명령 프롬프트(Command Prompt) 애플리케이션을 마우스 오른쪽 버튼으로 클릭하고 관리자 권한으로 실행(Run as administrator)을 선택합니다.

    관리자 권한으로 명령 프롬프트 실행
    참고

    명령 프롬프트(Command Prompt)에서 디바이스를 변경할 수 있도록 허용할지 묻는 메시지가 나타날 수 있습니다. 설치를 계속하려면 예(Yes)를 선택해야 합니다.

  4. 다음 명령을 입력하여 lightsailctl 플러그인을 저장한 C:\Temp\lightsailctl\ 디렉터리를 가리키는 경로 환경 변수를 설정합니다.

    setx PATH "%PATH%;C:\Temp\lightsailctl" /M

    다음 예제와 비슷한 결과가 나타나야 합니다.

    setx 명령에 대한 명령줄 응답

setx 명령은 1024자를 초과하여 잘립니다. PATH에 이미 여러 변수가 설정되어 있는 경우 다음 절차를 사용하여 경로 환경 변수를 수동으로 설정하세요.

  1. 시작(Start) 메뉴에서 제어판(Control Panel)을 클릭합니다.

  2. 시스템 및 보안(System and Security)을 선택한 다음 시스템(System)을 선택합니다.

  3. 고급 시스템 설정을 선택합니다.

  4. 시스템 속성(System Properties) 대화 상자에서 고급(Advanced) 탭을 선택한 다음 [환경 변수(Environment Variables)를 선택합니다.

  5. 환경 변수(Environment Variables) 대화 상자의 시스템 변수(System Variables) 상자에서 경로(Path)를 선택합니다.

  6. 시스템 변수(System Variables) 대화 상자 아래에 있는 편집(Edit) 버튼을 선택합니다.

    Windows 시스템 변수
  7. 신규(New)를 선택한 후 다음 경로를 입력합니다.C:\Temp\lightsailctl\

    Windows 환경 변수
  8. 세 개의 연속된 대화 상자에서 확인(OK)을 선택한 다음 시스템(System) 대화 상자를 닫습니다.

이제 AWS Command Line Interface(AWS CLI)를 사용하여 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시할 준비를 마쳤습니다. 자세한 내용은 컨테이너 이미지 푸시 및 관리를 참조하세요.

macOS에 lightsailctl 플러그인 설치

macOS에 lightsailctl 플러그인을 다운로드하고 설치하려면 다음 절차 중 하나를 완료하세요.

Homebrew 다운로드 및 설치
  1. 터미널 창을 엽니다.

  2. 다음 명령을 입력하여 lightsailctl 플러그인을 다운로드하고 설치합니다.

    brew install aws/tap/lightsailctl
    참고

    Homebrew에 대한 자세한 내용은 Homebrew 웹 사이트를 참조하세요.

수동 다운로드 및 설치
  1. 터미널 창을 엽니다.

  2. 다음 명령을 입력하여 lightsailctl 플러그인을 다운로드하고 휴지통 폴더에 복사합니다.

    curl "https://s3.us-west-2.amazonaws.com/lightsailctl/latest/darwin-amd64/lightsailctl" -o "/usr/local/bin/lightsailctl"
  3. 다음 명령을 입력하여 플러그 인을 실행할 수 있도록 합니다.

    chmod +x /usr/local/bin/lightsailctl
  4. 다음 명령을 입력하여 플러그 인의 확장 속성을 지웁니다.

    xattr -c /usr/local/bin/lightsailctl

이제 AWS CLI를 사용하여 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시할 준비를 마쳤습니다. 자세한 내용은 컨테이너 이미지 푸시 및 관리를 참조하세요.

Linux에 lightsailctl 플러그인 설치

Linux에 Lightsail 컨테이너 서비스 플러그 인을 설치하려면 다음 절차를 완료하세요.

  1. 터미널 창을 엽니다.

  2. 다음 명령을 입력하여 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"
  3. 다음 명령을 입력하여 플러그 인을 실행할 수 있도록 합니다.

    sudo chmod +x /usr/local/bin/lightsailctl

    이제 AWS CLI를 사용하여 컨테이너 이미지를 Lightsail 컨테이너 서비스로 푸시할 준비를 마쳤습니다. 자세한 내용은 컨테이너 이미지 푸시 및 관리를 참조하세요.