docker push

docker push 명령어는 Docker 이미지를 로컬에서 원격 레지스트리(예: Docker Hub, AWS ECR, GCR, etc.)로 업로드하는 데 사용됩니다. 이미지를 업로드하면 다른 사용자나 시스템이 이를 다운로드(docker pull)하여 사용할 수 있습니다.

---

1️⃣ docker push의 기본 구조

docker push [레지스트리 주소]/[이미지 이름]:[태그]

구성 요소 설명

• [레지스트리 주소]:
  • 이미지를 업로드할 레지스트리 주소. 기본값은 Docker Hub (docker.io)입니다.
  • 예: index.docker.io (Docker Hub), 123456789012.dkr.ecr.us-east-1.amazonaws.com (AWS ECR).
• [이미지 이름]:
  • 업로드하려는 Docker 이미지의 이름.
  • 예: myapp, nginx, username/myapp.
• [태그]:
  • 이미지 버전(태그)을 지정. 기본값은 latest입니다.
  • 예: v1.0, latest, dev.

---

2️⃣ 사용 방법

1. Docker 이미지 태그 추가

docker push를 실행하기 전에 이미지를 원격 레지스트리에 업로드할 수 있도록 올바른 태그를 지정해야 합니다.
태그는 docker tag 명령어를 사용해 지정합니다.

docker tag [이미지 ID] [레지스트리 주소]/[이미지 이름]:[태그]

예제:

docker tag myapp:latest username/myapp:v1.0

2. Docker 레지스트리에 로그인

레지스트리에 이미지를 업로드하려면 먼저 로그인해야 합니다.

docker login [레지스트리 주소]

예제 (Docker Hub):

docker login

AWS ECR의 경우:

aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin [레지스트리 주소]

3. 이미지 업로드

태그를 지정한 이미지를 원격 레지스트리에 업로드합니다.

docker push [레지스트리 주소]/[이미지 이름]:[태그]

예제:

docker push username/myapp:v1.0

---

3️⃣ docker push 작동 방식

1. 이미지 계층 확인:
   • docker push는 업로드할 이미지의 계층(레이어)을 확인합니다.
   • 이미 원격 레지스트리에 업로드된 계층은 건너뜁니다.
2. 업로드:
   • 새로운 계층만 원격 레지스트리에 업로드됩니다.
3. 완료:
   • 이미지가 성공적으로 업로드되면 레지스트리에 해당 이미지의 URL이 저장됩니다.

---

4️⃣ 자주 발생하는 문제 및 해결 방법

문제 1: 권한 부족

• 오류: denied: requested access to the resource is denied
• 원인: 로그인하지 않았거나 레지스트리의 권한이 없습니다.
• 해결: 올바른 계정으로 로그인하거나 권한을 확인합니다.

  docker login
  

문제 2: 태그가 없거나 잘못됨

• 오류: repository does not exist or may require 'docker login'
• 원인: 태그가 누락되었거나 잘못된 이름을 사용했습니다.
• 해결: 이미지를 태그하고 다시 시도합니다.

  docker tag myapp:latest username/myapp:v1.0
  

문제 3: 네트워크 연결 문제

• 오류: unauthorized: authentication required 또는 업로드 중 실패.
• 원인: 네트워크 문제로 레지스트리에 연결할 수 없습니다.
• 해결: 네트워크 상태를 확인하고 다시 시도합니다.

---

5️⃣ 실전 예제

1. Docker Hub에 이미지 업로드

1. 이미지 태그 지정:
2. docker tag myapp:latest username/myapp:v1.0
3. Docker Hub 로그인:
4. docker login
5. 이미지 업로드:
6. docker push username/myapp:v1.0

---

2. AWS ECR에 이미지 업로드

1. ECR에 로그인:
2. aws ecr get-login-password --region us-east-1 | docker login --username AWS --password-stdin 123456789012.dkr.ecr.us-east-1.amazonaws.com
3. 이미지 태그 지정:
4. docker tag myapp:latest 123456789012.dkr.ecr.us-east-1.amazonaws.com/myapp:v1.0
5. 이미지 업로드:
6. docker push 123456789012.dkr.ecr.us-east-1.amazonaws.com/myapp:v1.0