🚨 AWS 128: Amazon ECR 설정 및 Docker 이미지 푸시

Source: Dev.to

Hey Cloud Builders 👋
#100DaysOfCloud 챌린지의 Day 28에 오신 것을 환영합니다! 이번 포스트에서는 프라이빗 Amazon Elastic Container Registry (ECR) 저장소를 만들고, 커스텀 Python 앱 Docker 이미지를 빌드한 뒤, 해당 레지스트리에 푸시하는 과정을 다룹니다.

Overview

Amazon ECR은 완전 관리형 Docker 컨테이너 레지스트리로, 개발자가 컨테이너 이미지를 안전하게 저장·관리·배포할 수 있게 해줍니다. 프라이빗 레지스트리를 사용하면 애플리케이션 아티팩트를 공개로부터 숨길 수 있습니다.

Step‑by‑Step Workflow

다음 단계 순서대로 진행합니다:

1. 저장소 생성
2. Docker 이미지 빌드
3. Docker와 ECR 인증
4. 이미지 태그 지정 및 푸시
5. 업로드 확인

Create the Repository

aws ecr create-repository \
    --repository-name devops-ecr \
    --region us-east-1

Note: ECR 저장소는 리전별로 존재합니다. 저장소를 만들고자 하는 리전과 동일하게 AWS CLI가 설정되어 있는지 확인하세요.

생성 후에는 Repository URI를 확인합니다. 형태는 다음과 같습니다:

.dkr.ecr..amazonaws.com/devops-ecr

Build the Docker Image

cd /root/pyapp          # Directory containing the Dockerfile
docker build -t pyapp .   # Build a local image named "pyapp"

Authenticate Docker with ECR

12시간 유효한 로그인 토큰을 생성하고 Docker에 파이프합니다:

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

Tag and Push the Image

# Tag the local image with the full ECR URI
docker tag pyapp:latest .dkr.ecr..amazonaws.com/devops-ecr:latest

# Push the image to the repository
docker push .dkr.ecr..amazonaws.com/devops-ecr:latest

Verify the Upload

1. ECR 콘솔을 엽니다.
2. devops-ecr 저장소를 선택합니다.
3. latest 태그가 붙은 이미지가 표시되는지 확인합니다.

다른 머신에서 이미지를 풀링해 보는 것도 좋습니다(인증 후):

docker pull .dkr.ecr..amazonaws.com/devops-ecr:latest

Common Issues & Tips

Next Steps

이미지가 ECR에 저장되면 ECS, EKS, Lambda 등 서비스에 배포할 수 있습니다. CI/CD 파이프라인을 구축해 빌드·푸시 과정을 자동화하는 것이 자연스러운 다음 단계입니다.

Resources

• KodeKloud Engineer – Practice Labs – 실제 AWS 환경에서 이 작업들을 직접 해보세요.
• LinkedIn: Hritik Raj
• GitHub: 100 Days of Cloud (⭐ 여정을 지원해 주세요)