도커허브 (DockerHub) 저장소 활용하기 [2022 ver.]

도커 이미지를 사용함에 있어서 조직 내에서 컨테이너 서비스를 이용할 때 이미지의 관리와 공유가 중요하게 되었다. 이미지의 관리와 공유를 도와주는 서비스가 이미지 저장소이다. 이미지 저장소 중 도커 허브 (Docker Hub) 를 이용하여 이미지를 관리하는 방법을 알아본다.

 

다음 링크에 접속하면 도커 허브의 홈 페이지가 보인다.

https://hub.docker.com 

Docker Hub Container Image Library | App Containerization

 

가장 먼저 보이는 건 회원가입 페이지인데, 아직 회원가입을 하지 않았다면 회원가입을 진행하면 된다.

 

Docker ID 는 Docker Hub 내에서 사용할 고유한 ID 이므로 잘 입력해야 한다.

모든 정보를 입력하고 Sign Up 버튼을 클릭하면 이메일로 인증 정보가 발송되고 인증까지 완료되면 계정이 활성화된다.

 

---

도커에 회원가입이 완료되었다면, 우측 상단에 본인의 프로필이 보일 것이다. 해당 프로필을 클릭하고, Account Settings 로 접속해 보자.

 

Security 메뉴에 진입하면 Access Token 을 생성할 수 있는데, New Access Token 을 클릭하여 새로운 Access Token 을 생성한다.

 

다음과 같이 정보를 설정하고, Generate 버튼을 클릭한다.

 

이렇게 Generate 가 완료되면 Access Token 에 대한 가이드가 나오는데, 

 

설명과 같이 docker 에 login 명령어가 있고, 특정 사용자로 로그인하여 진행할 수 있다.

실제로 로그인하기 위해 다음 명렁어를 실행한다.

docker login -u [username]

 

명령어를 입력하면 위와 같이 패스워드를 입력하라는 인풋이 나오는데, 위 가이드 페이지에서 패스워드를 토큰을 복사하여 붙여넣기하면 된다. 붙여넣기해도 보안을 위해 실제 콘솔에는 입력값이 뜨지 않는데, 그냥 엔터를 입력하면 자동으로 검증이 된다.

 

로그를 보면 패스워드가 암호화되지 않은 상태로 특정 디렉토리에 파일로 저장이 된다고 하는데, 실제 해당 파일을 열어보면 json 형태로 저장되어 있음을 확인할 수 있다.

 

---

 

이제 새로운 Repository 를 생성하고 해당 Repository 에 이미지를 업로드해 보자.

상단 메뉴에서 Repositories 탭으로 진입하고,

 

Create Repository 를 선택한다.

 

다음과 같은 정보로 Repository 를 구성한다. 그냥 이름만 설정하는 것이므로 독자의 마음대로 설정해도 무관하다.

 

화면 우측에 Pro tip 이라는 섹션이 있을 것이다.

 

도커 이미지를 도커 허브에 업로드할 때는 위의 두 명령어를 실행하면 되는데,

1. 이미지의 이름을 설정하고

2. 해당 이미지를 업로드하면 된다.

 

Repository 를 성공적으로 생성하였다면 다음과 같이 Repository 를 조회할 수 있다.

---

이제 다시 콘솔로 돌아와서 Repository 에 이미지를 업로드해 보자.

 

docker images 명령어를 통해 업로드할 이미지의 이름을 확인하고,

 

docker tag 명령어를 입력하여 업로드할 이미지에 태그를 지정한다.

# tag [업로드할 이미지의 이름] [태그를 지정할 full name]
docker tag nginx:latest wkdgus1164/sample-repository:v1.0.0

 

그러면 아래와 같이 태그가 지정된 것을 확인할 수 있다.

 

이 상태에서 docker push 명령어를 이용하여 업로드 명령을 입력한다.

docker push [name]

 

다음과 같이 로그가 나오면,

 

다음과 같이 Docker Hub 에 잘 업로드된 것을 확인할 수 있다.

 

---

도커 허브에 이미지를 업로드했으니, 이제 업로드된 이미지를 다운로드 받아 보자.

 

먼저, 정확한 실습을 위해 docker rmi 명령어를 통해 업로드한 이미지를 로컬에서 삭제한다.

 

이미지가 삭제된 것을 확인하고,

 

다음 명령어를 통해 도커 허브에 있는 이미지의 이름을 입력하여 다운로드 받아 보자.

docker pull [name]

 

정상적으로 pull 작업이 진행되고, 다시 images 를 조회해 보면 정상적으로 출력되는 것을 확인할 수 있다.

 

이렇게 Docker Hub 에 Private Repository 를 만들고, 해당 Repository 에 이미지를 업로드하고 다운로드하는 방법을 알아보았다.