소개
Amazon ECR Docker Credential Helper는 AWS(Amazon Web Services)에서 개발한 오픈소스 도구로, Docker 데몬과 Amazon Elastic Container Registry(ECR)를 원활하게 연결합니다. 이 도구는 docker pull 및 docker push 명령을 실행할 때 자동으로 AWS 자격 증명을 생성 및 관리하여, 수동으로 docker login을 할 필요 없이 ECR 리포지토리에 쉽게 접근할 수 있게 합니다.
상세정보
자동 자격 증명 관리
이 도구를 설정하면 docker pull 또는 docker push 명령을 실행할 때 AWS 자격 증명이 자동으로 가져와지고 사용됩니다. 수동으로 docker login 또는 docker logout 명령을 사용할 필요가 없습니다.
유연한 AWS 자격 증명 지원
다양한 AWS 자격 증명 위치를 지원합니다. ~/.aws/credentials에 저장된 공유 자격 증명 파일, AWS_ACCESS_KEY_ID 및 AWS_SECRET_ACCESS_KEY 환경 변수, Amazon ECS 작업 또는 Amazon EC2 인스턴스에 연결된 IAM 역할을 사용할 수 있습니다.
레지스트리별 설정
Docker 1.13.0 이상에서는 credHelpers를 사용하여 특정 ECR 레지스트리에 대해 이 자격 증명 도우미를 지정할 수 있습니다. 이를 통해 여러 레지스트리(예: public.ecr.aws 및 개인 계정 레지스트리)를 동시에 사용할 수 있습니다.
Windows 설치
Windows 사용자는 GitHub 릴리스 페이지에서 실행 파일을 다운로드하여 설치할 수 있습니다. 설치 후에는 docker-credential-ecr-login 바이너리를 시스템 PATH에 추가해야 합니다.
소스에서 빌드
소스 코드에서 빌드하려면 Go 1.19 이상, git, make가 필요합니다. 다음 명령으로 설치할 수 있습니다.
go install github.com/awslabs/amazon-ecr-credential-helper/ecr-login/cli/docker-credential-ecr-login@latest
Docker 설정
설치 후 ~/.docker/config.json 파일을 수정하여 Docker 클라이언트가 이 자격 증명 도우미를 사용하도록 설정해야 합니다. 파일에 다음 내용을 추가합니다.
{“credsStore”: “ecr-login”}
이 설정은 모든 Amazon ECR 레지스트리에 대해 자격 증명 도우미를 활성화합니다.
Docker 명령 사용
설정이 완료되면 일반적인 Docker 명령을 사용할 수 있습니다. 예를 들어, 다음 명령으로 ECR 이미지를 풀할 수 있습니다.
docker pull 123456789012.dkr.ecr.us-west-2.amazonaws.com/my-repository:my-tag
또는 공개 ECR 레지스트리에서 이미지를 가져올 수도 있습니다.
docker pull public.ecr.aws/amazonlinux/amazonlinux:latest
이런 경우에 유용합니다
이 도구는 Amazon ECR을 사용하여 컨테이너 이미지를 빌드, 푸시, 또는 풀하는 DevOps 엔지니어, 클라우드 아키텍트, 및 개발자에게 특히 유용합니다. Amazon EC2 인스턴스 또는 Amazon ECS 작업에서 Docker 이미지를 자주 관리하는 경우 자동 자격 증명 처리로 워크플로우를 크게 간소화할 수 있습니다.
지원 환경 및 시스템 요구사항
Docker 1.11 이상이 시스템에 설치되어 있어야 합니다. AWS 자격 증명은 공유 자격 증명 파일, 환경 변수, 또는 IAM 역할을 통해 구성할 수 있습니다. Windows, macOS, 그리고 여러 Linux 배포판을 지원합니다.
시스템 요구사항
Docker 1.11 이상이 시스템에 설치되어 있어야 합니다. AWS 자격 증명(공유 자격 증명 파일, 환경 변수, 또는 IAM 역할)이 구성되어 있어야 합니다.