VS Code에서 Amazon Elastic Container Registry 서비스 사용 - AWS VS Code용 툴킷
필수 조건1. Dockerfile 생성2. Dockerfile에서 이미지 빌드3. 새 리포지토리 생성4. 이미지 푸시, 풀 및 삭제

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

VS Code에서 Amazon Elastic Container Registry 서비스 사용

Amazon Elastic Container Registry (Amazon ECR)는 VS Code AWS Explorer에서 액세스할 수 있으며, Amazon ECR 리포지토리로 프로그램 이미지를 푸시할 수 있습니다. 시작하기 전에 다음을 준비하세요.

  1. 이미지 빌드에 필요한 정보가 포함된 Dockerfile을 생성합니다.

  2. 해당 Dockerfile에서 이미지를 빌드하고 처리할 이미지에 태그를 지정합니다.

  3. Amazon ECR 인스턴스 내부에 리포지토리를 생성합니다.

  4. 리포지토리에 태그가 지정된 이미지를 푸시합니다.

필수 조건

VS Code용 도구 키트의 Amazon ECR 기능을 사용하려면 먼저 이러한 다음 조건을 갖춰야 합니다.

1. Dockerfile 생성

Docker는 Dockerfile이라는 파일을 사용하여 원격 리포지토리에 푸시하고 저장할 수 있는 이미지를 정의합니다. 이미지를 ECR 리포지토리에 업로드하려면 먼저 Dockerfile을 생성한 다음 Dockerfile에서 이미지를 빌드하세요.

Dockerfile 생성

  1. Toolkit for VS Code 탐색기를 사용하여 Dockerfile을 저장할 디렉토리로 이동합니다.

  2. Dockerfile 이름으로 새 파일을 생성합니다.

    참고

    VS Code에서 파일 형식 또는 파일 확장자를 선택하라는 메시지가 표시될 수 있습니다. 이 경우에는 일반 텍스트를 선택합니다. Vs Code에는 'dockerfile' 확장자가 있습니다. 그러나 사용하지 않는 것이 좋습니다. 이 확장자가 특정 버전의 Docker 또는 기타 관련 애플리케이션과 충돌을 일으킬 수 있기 때문입니다.

VS Code를 사용하여 Dockerfile 편집

Dockerfile에 파일 확장자가 있는 경우 파일에 대한 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 열고 해당 파일 확장자를 제거합니다.

Dockerfile에서 파일 확장자를 제거한 후 다음을 수행합니다.

  1. VS Code에서 빈 Dockerfile을 엽니다.

  2. 다음 예제의 내용을 Dockerfile에 복사합니다.

    예 Dockerfile 이미지 템플릿
    
FROM ubuntu:18.04

# Install dependencies
RUN apt-get update && \
 apt-get -y install apache2

# Install apache and write hello world message
RUN echo 'Hello World!' > /var/www/html/index.html

# Configure apache
RUN echo '. /etc/apache2/envvars' > /root/run_apache.sh && \
 echo 'mkdir -p /var/run/apache2' >> /root/run_apache.sh && \
 echo 'mkdir -p /var/lock/apache2' >> /root/run_apache.sh && \ 
 echo '/usr/sbin/apache2 -D FOREGROUND' >> /root/run_apache.sh && \ 
 chmod 755 /root/run_apache.sh

EXPOSE 80

CMD /root/run_apache.sh

    이것은 Ubuntu 18.04 이미지를 사용하는 Dockerfile입니다. RUN 명령은 패키지 캐시를 업데이트합니다. 웹 서버용 소프트웨어 패키지를 설치하고 'Hello World!'를 웹 서버의 문서 루트에 작성합니다. EXPOSE 명령은 컨테이너에 포트 80을 노출하고 CMD 명령은 웹 서버를 시작합니다.

  3. Dockerfile을 저장합니다.

    중요

    Dockerfile 이름에 확장자가 첨부되어 있지 않은지 확인하세요. 확장자가 있는 Dockerfile은 특정 버전의 Docker 또는 기타 관련 애플리케이션과 충돌을 일으킬 수 있기 때문입니다.

2. Dockerfile에서 이미지 빌드

생성한 Dockerfile에는 프로그램의 이미지를 빌드하는 데 필요한 정보가 포함되어 있습니다. 해당 이미지를 Amazon ECR 인스턴스로 푸시하려면 먼저 이미지를 빌드해야 합니다.

Dockerfile에서 이미지 빌드

  1. Dockerfile이 포함된 디렉터리로 이동하려면 Docker CLI 또는 Docker 인스턴스와 통합된 CLI를 사용합니다.

  2. Dockerfile에 정의된 이미지를 빌드하려면 Docker build 명령을 실행합니다.

    
          docker build -t hello-world .

  3. 이미지가 올바르게 생성되었는지 확인하려면 Docker images 명령을 실행합니다.

    docker images --filter reference=hello-world
    예 출력 예:
    
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
hello-world         latest              e9ffedc8c286        4 minutes ago       241MB
  4. 참고

    이 단계는 이미지를 생성하거나 푸시하는 데 필요하지 않지만 프로그램 이미지가 실행되면 어떻게 작동하는지 확인할 수 있습니다.

    Docker run 명령으로 새로 빌드된 이미드를 실행할 수 있습니다.

    docker run -t -i -p 80:80 hello-world

    위 예제에서 지정한 -p 옵션으로 컨테이너의 노출된 포트 80을 호스트 시스템의 포트 80에 매핑할 수 있습니다. Docker가 로컬에서 실행되고 있다면, 웹 브라우저에서 http://localhost:80로 이동하세요. 프로그램이 제대로 실행되면 “Hello, World!” 문구가 표시됩니다.

    Docker run 명령에 대한 자세한 내용은 Docker 웹 사이트에서 Docker run reference를 참조하세요.

3. 새 리포지토리 생성

이미지를 Amazon ECR 인스턴스에 업로드하려면 이미지를 저장할 수 있는 새 리포지토리를 생성합니다.

Amazon ECR 리포지토리를 생성합니다.

  1. VS Code Activity Bar에서 AWS도구 키트 아이콘을 선택합니다.

  2. AWS Explorer 메뉴를 확장합니다.

  3. AWS 계정에 연결된 기본 AWS 리전을 찾습니다. 리전을 선택하면 Toolkit for VS Code가 제공하는 서비스 목록이 표시됩니다.

  4. ECR+ 옵션을 선택하여 새 리포지토리 생성 프로세스를 시작하세요.

  5. 프롬프트의 메시지를 따라 프로세스를 완료합니다.

  6. 프로세스가 완료되면 AWS Explorer 메뉴의 ECR 섹션에서 새 리포지토리에 액세스할 수 있습니다.

4. 이미지 푸시, 풀 및 삭제

Dockerfile에서 이미지를 빌드하고 리포지토리를 생성한 후에는 Amazon ECR 리포지토리로 이미지를 푸시할 수 있습니다. 또한 Docker 및 AWS CLI와 함께 AWS Explorer를 사용하여 다음 작업을 수행할 수 있습니다.

  • 리포지토리에서 이미지를 가져옵니다.

  • 리포지토리에 저장된 이미지를 삭제합니다.

  • 리포지토리를 삭제합니다.

기본 레지스트리에 대해 Docker 인증

Amazon ECR과 Docker 인스턴스 간에 데이터를 교환하려면 인증이 필요합니다. 레지스트리에 대해 Docker를 인증하려면 다음을 수행합니다.

  1. AWS CLI 인스턴스에 연결된 명령줄 운영 체제를 실행하세요.

  2. get-login-password 메서드를 사용하여 프라이빗 ECR 레지스트리에 대해 인증합니다.

    aws ecr get-login-password --region region | docker login --username AWS --password-stdin AWS_account_id.dkr.ecr.region.amazonaws.com
    중요

    이전 명령에서 region과 AWS_account_id 모두 AWS 계정에 맞는 정보로 업데이트해야 합니다.

이미지를 리포지토리에 태그 지정 및 푸시

AWS 인스턴스로 Docker 인증 후 이미지를 리포지토리에 푸시합니다.

  1. Docker images 명령을 사용하면 로컬에 저장된 이미지를 보고 태그 지정할 이미지를 식별할 수 있습니다.

    docker images
    예 출력 예:
    
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
hello-world         latest              e9ffedc8c286        4 minutes ago       241MB

  2. Docker tag 명령을 사용하여 이미지에 태그를 지정합니다.

    docker tag hello-world:latest AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world:latest

  3. Docker push 명령을 사용하여 태그가 지정된 이미지를 리포지토리에 푸시합니다.

    docker push AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world:latest
    예 출력 예:
    
The push refers to a repository [AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world] (len: 1)
e9ae3c220b23: Pushed
a6785352b25c: Pushed
0998bf8fb9e9: Pushed
0a85502c06c9: Pushed
latest: digest: sha256:215d7e4121b30157d8839e81c4e0912606fca105775bb0636b95aed25f52c89b size: 6774

태그가 지정된 이미지를 리포지토리에 업로드되면 AWS Explorer 메뉴에 해당 이미지가 표시됩니다.

Amazon ECR에서 이미지 가져오기

  • Docker tag 명령의 로컬 인스턴스로 이미지를 가져올 수 있습니다.

    docker pull AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world:latest
    예 출력 예:
    
The push refers to a repository [AWS_account_id.dkr.ecr.region.amazonaws.com/hello-world] (len: 1)
e9ae3c220b23: Pushed
a6785352b25c: Pushed
0998bf8fb9e9: Pushed
0a85502c06c9: Pushed
latest: digest: sha256:215d7e4121b30157d8839e81c4e0912606fca105775bb0636b95aed25f52c89b size: 6774
Amazon ECR 리포지토리에서 이미지 삭제

VS Code에서 이미지를 삭제하는 방법은 두 가지입니다. 첫 번째 방법은 AWS Explorer를 사용하는 것입니다.

  1. AWS 탐색기에서 ECR 메뉴를 확장합니다.

  2. 삭제할 이미지의 리포지토리를 확장합니다.

  3. 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 클릭하여 삭제하고 싶은 이미지와 연결된 이미지 태그를 선택하세요.

  4. 해당 태그와 연결된 이미지를 모두 삭제하려면 Delete Tag...를 선택합니다.

AWS CLI로 이미지 삭제

  • AWS ecr batch-delete-image 명령을 사용하여 리포지토리에서 이미지를 삭제할 수도 있습니다.

    AWS ecr batch-delete-image \
      --repository-name hello-world \
      --image-ids imageTag=latest
    예 출력 예:
    
{
    "failures": [],
    "imageIds": [
        {
            "imageTag": "latest",
            "imageDigest": "sha256:215d7e4121b30157d8839e81c4e0912606fca105775bb0636b95aed25f52c89b"
        }
    ]
}
Amazon ECR 인스턴스에서 리포지토리 삭제

VS Code에서 리포지토리를 삭제하는 방법은 두 가지입니다. 첫 번째 방법은 AWS 탐색기를 사용하는 것입니다.

  1. AWS Explorer에서 ECR 메뉴를 확장합니다.

  2. 컨텍스트(마우스 오른쪽 버튼 클릭) 메뉴를 열고 삭제할 리포지토리를 선택합니다.

  3. 선택한 리포지토리에서 Delete Repository... 옵션을 선택합니다.

AWS CLI에서 Amazon ECR 리포지토리 삭제

  • AWS ecr delete-repository 명령을 사용하여 리포지토리를 삭제할 수 있습니다.

    참고

    기본적으로, 이미지가 들어 있는 리포지토리는 삭제할 수 없습니다. 하지만 --force 플래그로 삭제할 수 있습니다.

    
        AWS ecr delete-repository \
      --repository-name hello-world \
      --force
    예 출력 예:
    
{
    "failures": [],
    "imageIds": [
        {
            "imageTag": "latest",
            "imageDigest": "sha256:215d7e4121b30157d8839e81c4e0912606fca105775bb0636b95aed25f52c89b"
        }
    ]
}