Docker 이미지 공유하기

🐳 1. Docker Hub로 Docker Image 공유

docker hub에 docker image를 공유하기 하기 위해서 우선 `docker login` 을 해줘야 한다. 그전에 docker hub에서 token을 발급받는다.

https://hub.docker.com/ 에 로그인한 후 [Account Setting]을 누른다.

이후에 [Security] - [Personal access tokens]을 클릭

 

 

그다음 [Generate new token]을 누른다.

 

 

token의 이름과 permission을 설정해 준다.

 

생성이 완료되면 터미널에서 아래와 같이 입력한다. 아래 Access token은 다른 사람에게 노출되지 않도록 조심한다.

docker login -u [Username]
[Access Token]

 

 

로그인이 완료되면 해당 터미널에서 docker hub에 이미지를 올릴 수 있다.

 

Docker image를 생성하는 방법은

2024.09.30 - [Programming/Docker] - Docker 이미지 만들기

참고.

 

이제 업로드할 docker 이미지를 생성한다. 아래에서 “jinwoohong”에는 자신의 docker username을 작성해야 한다.

 

1. Dockerfile build

아래와 같은 dockerfile을 작성한 후에 build 해준다.

FROM ubuntu:20.04
RUN apt update && apt install -y python3
WORKDIR /var/www/html
COPY ["index.html", "."]
CMD ["python3", "-u", "-m", "http.server"]

 

docker build -t jinwoohong/webserver:1.0 .

 

2. Docker Image push

build 완료 후에 `push` 명령어를 통해 docker hub에 image를 올린다.

docker push jinwoohong/webserver:1.0

 

docker hub에 가보면 성공적으로 올라간 것을 볼 수 있다.

 

 

이제 `docker pull jinowoohong/webserver` 명령어를 통해 해당 image를 다운로드하여 실행할 수가 있다. docker hub에 image를 업로드할 때 pubilc에는 제한이 없지만 private는 1개까지만 지원한다.

 

🐱 2. Github로 Docker Image 공유

Docker hub에 Docker image를 공유할 때 public은 무제한이지만 private는 1개로 제한적이다. (유료 계정을 쓰면 무제한) 하지만 Github package registry을 통해 무제한으로 private를 사용할 수 있다.

 

1. Container Registry에 인증

우선 Container Registry에 인증을 해야 한다.

https://docs.github.com/en/packages/working-with-a-github-packages-registry/working-with-the-container-registry

Working with the Container registry - GitHub Docs

 

 

1. [Github] - [Setting]으로 이동

 

2. 좌측에 [Developer setting]으로 이동

 

 

3. [Tokens(classic)] - [Generate new token(classic]으로 이동

 

4. token 이름 설정 및 [write:packages]와 [delete:packages] 체크 후 밑으로 내려서 생성

 

 

5. 생성이 완료되면 Access token이 발급된 걸 볼 수 있다. 해당 키를 따로 복사하거나 메모해 놓는다.(외부에 공유 X)

 

6. Access Token 등록

Ubuntu나 MacOS일 경우 Terminal을 실행하고, Window일 경우 git bash 실행

export CR_PAT=[위에서 복사한 토큰]

 

$ echo $CR_PAT | docker login ghcr.io -u dev-jinwoohong --password-stdin
> Login Succeeded

 

까지 완료했다면 docker image를 push 할 수 있다.

 

이제 업로드할 docker 이미지를 생성한다. 아래에서 “dev-jinwoohong”에는 자신의 Git hub 이름을 작성해야 한다.

 

2. Dockerfile build

아래와 같은 dockerfile을 작성한 후에 build 해준다.

FROM ubuntu:20.04
RUN apt update && apt install -y python3
WORKDIR /var/www/html
COPY ["index.html", "."]
CMD ["python3", "-u", "-m", "http.server"]

 

docker build -t ghcr.io/dev-jinwoohong/webserver:1.0 .

 

 

3. Docker Image push

build 완료 후에 `push` 명령어를 통해 Github container registry에 image를 올린다.

docker push ghcr.io/dev-jinwoohong/webserver:1.0

 

 

[packages]에 가보면 정상적으로 push 된 것을 확인할 수 있다. 또한, package settings에서 Github repository랑 연결할 수 있다. 연결한 후 해당 repo로 이동하면 Packages에 추가된 것을 볼 수 있다.

Packages에 push 하면 처음에는 private으로 되지만 사용자를 추가하거나 public으로 변경할 수 있다.

 

📄 참고자료

https://www.youtube.com/watch?v=cqlY1Hc70H0

 

 

🌤️ 마치며

“아는 만큼 보인다”라는 말처럼 수많은 Github Repository를 봤지만 Packages가 뭔지 관심을 가진 적은 없다. 이번을 계기로 나도 Repository를 올릴 때 Packages에 Docker image를 함께 올려보도록 해야겠다.