[Docker 강의 11편] 도커 이미지 푸시(Push) 및 풀(Pull)

 

안녕하세요 펭귄 교수입니다.

 

도커에서 이미지를 효율적으로 관리하고 배포하는 데 중요한 두 가지 개념이 바로 푸시(Push)와 풀(Pull)입니다.

 

이미지를 푸시하는 과정은 로컬에서 빌드한 이미지를 중앙 저장소인 도커 레지스트리(Docker Registry)에 업로드하는 것을 의미하며, 풀은 해당 레지스트리에서 이미지를 다운로드하는 과정입니다.

이 과정은 개발자나 운영자들이 애플리케이션을 원활하게 공유하고 배포하는 데 필수적입니다.

 

이번 글에서는 도커 이미지 푸시 및 풀의 기초적인 개념부터, 이를 실제로 사용하는 방법, 그리고 도커 허브나 프라이빗 레지스트리에서 이미지 관리의 효율성을 높이는 방법까지 다루어보겠습니다.

---

1. 도커 이미지 푸시(Push)

도커 이미지 푸시는 로컬 환경에서 빌드된 이미지를 원격 레지스트리에 업로드하는 과정입니다. 이를 통해 다른 개발자나 시스템이 해당 이미지를 사용할 수 있게 됩니다.

1-1. 푸시를 위한 기본 준비

도커 이미지를 푸시하려면 먼저 레지스트리에 로그인해야 합니다. 가장 많이 사용하는 도커 레지스트리는 **도커 허브(Docker Hub)**입니다. 도커 허브에 로그인하려면 다음 명령어를 사용합니다.

docker login

로그인 후에는 도커 허브 또는 프라이빗 레지스트리에 이미지를 푸시할 수 있습니다. 여기서 주의할 점은 푸시할 이미지를 해당 레지스트리에 맞는 태그로 변경해야 한다는 것입니다.

1-2. 이미지 태그 지정

도커 허브나 프라이빗 레지스트리에 이미지를 푸시하기 위해서는 이미지를 푸시할 레지스트리 주소와 사용자 이름을 포함한 태그를 지정해야 합니다.

docker tag <이미지ID> <레지스트리주소>/<사용자명>/<이미지명>:<태그>

예시로 myapp이라는 로컬 이미지를 도커 허브에 v1.0이라는 버전으로 푸시하려면 다음과 같이 태그를 지정합니다.

docker tag myapp myusername/myapp:v1.0

1-3. 이미지 푸시

태그가 설정된 이미지는 docker push 명령어를 통해 레지스트리로 업로드됩니다.

docker push myusername/myapp:v1.0

이제 도커 허브에서 해당 이미지를 다른 시스템이나 개발자가 사용할 수 있습니다.

---

2. 도커 이미지 풀(Pull)

도커 이미지 풀은 원격 레지스트리에서 이미지를 다운로드하는 과정입니다. 푸시된 이미지를 다시 로컬 환경에서 가져오려면 docker pull 명령어를 사용합니다. 이는 애플리케이션 배포나 개발 과정에서 필수적인 단계입니다.

2-1. 이미지 풀 기본 명령어

다음 명령어를 사용해 원격 레지스트리에서 이미지를 다운로드할 수 있습니다.

docker pull <레지스트리주소>/<이미지명>:<태그>

예를 들어, 도커 허브에서 nginx 최신 버전 이미지를 풀하려면 다음과 같이 명령어를 실행합니다.

docker pull nginx:latest

특정 버전의 이미지를 풀하고 싶다면, 해당 태그를 지정하면 됩니다.

docker pull nginx:1.19

2-2. 프라이빗 레지스트리에서 이미지 풀

프라이빗 도커 레지스트리에서도 이미지를 동일한 방식으로 풀할 수 있습니다. 프라이빗 레지스트리에 로그인한 후, 레지스트리 주소와 함께 이미지를 풀하면 됩니다.

docker pull <레지스트리주소>/<이미지명>:<태그>

로컬 레지스트리에서 이미지를 풀할 때는 localhost를 사용하여 이미지를 가져옵니다.

docker pull localhost:5000/myapp:v1.0

---

3. 푸시와 풀의 활용 사례

이미지를 푸시하고 풀하는 과정은 다양한 상황에서 유용하게 사용됩니다. 대표적인 활용 사례를 몇 가지 소개하겠습니다.

3-1. 협업 및 배포 자동화

푸시와 풀은 개발자 간의 협업을 효율적으로 만듭니다. 개발자는 로컬에서 이미지를 빌드하고 푸시한 후, 다른 개발자나 운영팀이 해당 이미지를 풀하여 애플리케이션을 실행하거나 배포할 수 있습니다. 특히 CI/CD 파이프라인에서 코드가 업데이트될 때마다 자동으로 이미지를 빌드하고 푸시한 후, 이를 풀하여 자동으로 배포할 수 있습니다.

3-2. 멀티 환경 지원

도커 이미지를 레지스트리에 푸시해 두면, 다양한 환경에서 동일한 애플리케이션을 배포할 수 있습니다. 예를 들어, 개발 환경, 스테이징 환경, 프로덕션 환경 각각에 맞는 이미지를 빌드하고 태그를 설정한 후, 각 환경에서 적절한 이미지를 풀하여 일관된 환경을 유지할 수 있습니다.

3-3. 버전 관리

도커 이미지 태그를 사용하면 애플리케이션의 여러 버전을 관리할 수 있습니다. 예를 들어, v1.0, v1.1, v2.0 등의 태그를 사용해 동일한 애플리케이션의 다른 버전 이미지를 관리할 수 있습니다. 이를 통해 새로운 버전으로 업그레이드하거나, 문제가 생겼을 때 이전 버전으로 되돌리는 것이 용이합니다.

---

4. 도커 레지스트리 활용 팁

도커 푸시와 풀 명령어는 이미지 관리에 필수적인 기능입니다. 이를 더욱 효율적으로 사용하기 위한 몇 가지 팁을 소개합니다.

4-1. 태그로 이미지 관리

이미지 버전을 명확하게 구분하기 위해 태그를 잘 활용하는 것이 중요합니다. 각 이미지에 latest 태그를 붙이는 것보다, v1.0, v2.0처럼 명확한 버전 태그를 붙이는 것이 관리에 도움이 됩니다. 이를 통해 어떤 버전의 애플리케이션이 실행되고 있는지 명확하게 파악할 수 있습니다.

4-2. 프라이빗 레지스트리 보안 설정

프라이빗 레지스트리에서 이미지를 관리할 때는 반드시 보안을 고려해야 합니다. HTTPS를 사용해 안전한 통신을 설정하고, 인증서 관리 및 사용자 권한을 통해 레지스트리에 접근하는 사용자와 시스템을 제한하는 것이 좋습니다.

4-3. 푸시 후 자동 테스트

도커 이미지를 푸시한 후에는 반드시 이미지가 정상적으로 동작하는지 확인해야 합니다. 이를 위해 CI/CD 파이프라인을 통해 푸시 후 자동으로 테스트가 실행되도록 설정하면 좋습니다.

---

5. 리눅스 명령어와 도커 명령어의 조합

리눅스 명령어와 도커 명령어를 결합하여 이미지 관리 및 자동화를 더욱 효과적으로 할 수 있습니다. 예를 들어, 스크립트를 사용해 여러 개의 이미지를 자동으로 푸시하거나 풀할 수 있습니다.

for i in {1..10}; do
    docker pull myimage:v$i
done

이 스크립트는 myimage라는 이미지의 1부터 10까지의 버전을 자동으로 풀하는 예시입니다.

또한, 리눅스에서 cron 작업을 설정해 정기적으로 이미지를 풀하거나 업데이트할 수 있습니다.

---

6. 마무리

도커 이미지를 푸시하고 풀하는 과정은 도커 환경에서 애플리케이션을 배포하고 관리하는 데 핵심적인 역할을 합니다. 특히 푸시와 풀은 개발자가 원격 레지스트리에서 이미지를 공유하고, 언제든지 해당 이미지를 다운로드해 사용할 수 있게 만들어줍니다.

 

도커 허브와 프라이빗 레지스트리를 효율적으로 활용하고, 버전 관리를 통해 애플리케이션의 안정성을 유지하며, 보안을 강화하는 것이 중요합니다.

 

---

다른 글 더보기

[Docker 강의 7편] 도커 이미지 빌드

[Docker 강의 6편] 도커 파일 작성하기 (Dockerfile)

 

[Docker 강의 5편] 도커 이미지 최적화 및 관리