docker 이미지를 만들어보자

이번 시간에는 docker 이미지를 커스터마이징하기 위해 Dockerfile로 이미지를 만들어 봅시다. 더 나아가 만든 도커 이미지를 hub에 올려 봅시다.

 

💡 목차

이번 시간에 학습할 부분은 아래와 같습니다. 전체적으로 무엇을 배울지 미리 확인하고 갑시다.

1. docker 이미지 생성 방법
   • 이미지 생성 방법에 대해 정리해 봅시다.
2. docker commit
   • docker commit 명령어를 통해 이미지를 생성해 봅니다.
3. Dockerfile 만들기
   • Dockerfile를 만들어 이미지를 커스터마이징 해봅시다.
4. docker hub 올리기
   • docker hub에 위에서 만든 이미지를 올려 봅시다.

---

1. docker 이미지 생성 방법

 이미지 생성 방법은 다음과 같은 3가지가 존재합니다. 

1. 기본 이미지(nginx, centos 등) 로 컨테이너 생성
   • 베이스 이미지를 pull 하여 이미지를 얻을 수 있습니다.
2. Dockerfile를 만들어 이미지 커스터마이징 하기
   • Dockerfile는 컨테이너에 필요한 패키지, 소스코드 등을 기록해둔 파일로 빌드를 하면 도커 이미지가 생성됩니다.
   • 장기적인 시점에서 본다면, 아래 commit 방식보단 Dockerfile 작성이 저 좋습니다. 이유는 이미지 생성 방법 기록 + 배포 측면에서 더 유리합니다.
3. commit를 이용해서 이미지 생성하기
   • docker commit 명령어를 이용하면 컨테이너에서 설치 및 작업한 내용이 저장되는 방식입니다.

---

2. docker commit

 이미지 생성 방법 중 commit를 이용해서 이미지를 생성해 봅시다.

🔹 commit 명령어 설명

 아래 실습은 아래와 같이 진행하려고 합니다. 이 방법은 우선 기본 이미지를 실행시킨 후, 컨테이너 안에서 원하는 패키지나 소스코드 등 작업(아래에서는 telnet를 설치)을 진행합니다. 그 후, commit 명령어로 원하는 작업이 추가된 새로운 이미지를 얻습니다.

 

🔸 commit 명령어

• 참고 : https://docs.docker.com/engine/reference/commandline/commit/

💡 docker commit [OPTIONS] CONTAINER_명 [저장소이름]/이미지이름[:TAG]]

🔸 OPTIONS

options	설명
-a, --author	생성자 정보를 입력합니다.
m, --message	변경 사항에 대한 메시지를 입력 합니다.
-p, --pause	이미지를 생성하는 동안 컨테이너를 중단 시킵니다. default 값으로 true

 

🔹 실습하기 - telnet 설치된 이미지 만들기

 commit 없이 진행한 것과 commit 명령어로 진행한 작업을 비교하고자 합니다. 아래 두 가지 작업 모두 실습해 봅시다.

• 참고
  • telnet 명령어: 특정 포트(Port)가 접속 가능한지 확인 가능한 명령어 입니다.

🔸 commit 명령어 없이 이미지 확인하기

 컨테이너에서 telnet를 설치해 보고 commit 없이 컨테이너를 내릴 경우 해당 이미지가 어떻게 되는지 확인해 봅시다.

 

1. docker run

• 아래 명령어로 centos 도커 컨테이너를 실행 후, bash로 컨테이너에 들어가 보자.

$ docker run -it --name commit_test centos bash

 

2. telnet를 설치하기

• 아래 명령어로 cenots 컨테이너에서 telnet를 설치합니다.

[root@ade9f1da26d3 /]# **yum install -y telnet**

Failed to set locale, defaulting to C.UTF-8
CentOS-8 - AppStream                                                                                                         3.1 MB/s | 6.5 MB     00:02    
CentOS-8 - Base                                                                                                              3.2 MB/s | 5.0 MB     00:01    
CentOS-8 - Extras                                                                                                            2.8 kB/s | 4.2 kB     00:01    
Dependencies resolved.

------- 생략 -------                                                                                                                              

Complete!

[root@ade9f1da26d3 /]# **telnet**
telnet>

 

3. 새 터미널에서 diff 명령어로 변경된 파일 확인하기

• 확인해 보면 telnet이 추가된 것을 확인할 수 있다.

*(new terminal)*
$ docker diff commit_test

A /usr/bin/telnet

 

4. 해당 컨테이너 내리기

$ docker rm -f commit_test

 

5. 같은 이미지를 다시 실행시켜 위에서 설치한 telnet 명령어가 되는지 확인

• 아래와 같이 저장이 안 된 모습을 확인할 수 있다.

$ docker run -it --name commit_test centos bash
[root@82aa81723f45 /]# telnet
bash: telnet: command not found

 

🔸 commit 명령어 후, 이미지 확인하기

 위와 같이 컨테이너에서 telnet를 설치해 보고, commit를 진행하면 어떤 점이 다른지 확인해 봅시다.

 

1. docker run

• 아래 명령어로 centos 도커 컨테이너를 실행 후, bash로 컨테이너에 들어가 보자.

$ docker run -it --name commit_test centos bash

2. telnet를 설치하기

[root@82aa81723f45 /]# yum install -y telnet
Failed to set locale, defaulting to C.UTF-8
CentOS-8 - AppStream                                                                                                         3.1 MB/s | 6.5 MB     00:02    
CentOS-8 - Base                                                                                                              3.2 MB/s | 5.0 MB     00:01    
CentOS-8 - Extras                                                                                                            2.8 kB/s | 4.2 kB     00:01    
Dependencies resolved.

------- 생략 -------                                                                                                                              

Complete!

[root@82aa81723f45 /]# telnet
telnet>

3. 새 터미널에서 commit 진행

• -m 옵션: 변경된 로그를 입력해 줍니다. ("install telnet")
• 컨테이너 명: commit_test
• 원하는 이미지 명 & tag : centos_telnet:01

*(new terminal)*
$ **docker commit -m "install telnet" commit_test centos_telnet:01**
sha256:257fc79abba712f2dbb4e35c1816321dd854989bfedbb07ed94e614b4a59fa89

jungee-MacBook-Pro:~ jungee$ docker ps
CONTAINER ID        IMAGE               COMMAND             CREATED             STATUS              PORTS               NAMES
82aa81723f45        centos              "bash"              4 minutes ago       Up 4 minutes                            commit_test
jungee-MacBook-Pro:~ jungee$ docker images
REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE
centos_telnet       01                  257fc79abba7        6 seconds ago       274MB
centos              latest              470671670cac        2 months ago        237MB

4. commit으로 생성한 이미지 실행하여 telnet 동작 확인

• commit 명령어로 telnet이 설치된 이미지가 생성된 것을 확인할 수 있다.

$ docker run -it --name commit_test2 centos_telnet:01 bash
[root@863ac3be5d1c /]# telnet
telnet>

---

3. DockerFile

🔹 기본 설명

 이전에 설명했던 부분으로 1 ) 베이스 이미지와 2) 도커 파일(Dockerfile)로 생성하는 방식이 있다. 지금은 Dockerfile로 이미지를 커스터마이징하여 사용하고자 합니다. 아래 이미지와 같이 Dockerfile를 build를 하면, 커스터마이징된 이미지가 생성됩니다.

• Dockerfile: 컨테이너에 설치해야 하는 패키지, 추가해야 하는 소스코드, 실행해야 하는 명령어 등을 기록해 두는 파일
• Build: Dockerfile를 읽어 이미지를 생성합니다.

🔹 실습 1. python-Flask

app.py, requirements.txt 는 python-flask를 실행하기 위한 파일입니다. 우선 해당 파일을 생성 후, Dockerfile를 만들어 봅시다. 

 

1. app.py

• '/' 경로로 접근 시, hello_world()라는 함수 실행합니다.

from flask import Flask
app = Flask(__name__)

@app.route('/')
def hello_world():
    return 'hello Flask'

if __name__ == '__main__':
    app.run(debug=True, host='0.0.0.0')

2. requirements.txt

• Flask라는 라이브러리 설치가 필요하여 버전과 함께 설치할 라이브러리를 명시해준 파일입니다.

Flask==0.10.1

3. Dockerfile

• 패키지, 소스코드 등을 기록해둔 파일입니다. 위에서 말했듯이 이를 build 하면 커스터마이징된 이미지가 생성됩니다.
• RUN과 같은 명령어 의미에 대해서 파악해봅니다.

# FROM: 베이스 이미지를 지정 (여기서는 ubuntu 16.04 버전 사용) 
FROM ubuntu:16.04

# MAINTAINER: 개발자 정보를 나타냅니다. 
MAINTAINER "youremail@domain.com"

# RUN : 해당 명령어 실행, 필요한 패키지를 설치 
RUN apt-get update -y && \
    apt-get install -y python-pip python-dev

# COPY: 현재 경로(.)에 존재하는 파일들을 이미지 /app 경로에 모두 추가 
COPY . /app

# WORKDIR: 작업 디렉토리 변경. 셸 cd /app 과 같은 기능 
WORKDIR /app

# RUN: 명령어 실행. 복사된 requirements.txt 파일로 pip로 필요 라이브러리 설치 
RUN pip install -r requirements.txt

# EXPOSE: 컨테이너 실행 시 노출될 포트
EXPOSE 5000

# ENTRYPOINT: 컨테이너 시작 시 기본으로 실행되는 명령어 
ENTRYPOINT [ "python" ]

# CMD: 컨테이너 시작 시 실행되는 명령어로 위 ENTRYPOINT 명령어 뒤 인자로 실행하게 된다. 
# 결국 python app.py 명령어 실행 
CMD [ "app.py" ]

 

🔸 Dockerfile 명령어

• 참고: https://docs.docker.com/engine/reference/builder/

명령어	설명
FROM	베이스 이미지 지정/ 내가 만든 이미지도 가능
MAINTAINER	개발자 정보를 나타냄
RUN	명령어 실행. -y : 꼭 넣어주기
ADD	파일을 이미지에 추가 . COPY 기능(로컬 파일을 이미지에 추가) + 외부 url 및 tar 파일 추가 가능
COPY	파일을 이미지에 추가 . 로컬 파일 이미지에 추가
WORKDIR	작업 디렉토리 변경. 배시 셸 cd 명령어와 같은 기능
EXPOSE	컨테이너로 실행 시 노출시킬 포트. 단순히 해당 포트를 사용한다는 것을 명시하는 것. 이를 사용해도 run 명령어(도커 실행)에서 -P 옵션도 필요
CMD	컨테이너가 시작될 때마다 실행할 명령어를 설정. Dockerfile에서 한 번만 사용 가능.
ENTRYPOINT	컨테이너가 시작될 때마다 실행할 명령어를 설정. Dockerfile에서 한 번만 사용 가능. CMD와 다르게 컨테이너 실행 시, 명령어 입력을 하면 반드시 기본으로 실행하며 그 뒤 인자로 명령어가 실행됩니다.
ENV	환경변수 지정
VOLUME	호스트와 컨테이너 내부의 디렉토리를 설정하여 데이터를 공유. 도커 실행 시 , -v 명령어로 지정해야 볼륨이 생성됨.

4. docker build

• 만든 Dockerfile를 build 하여 이미지를 만들어 봅니다.

💡 docker build [OPTIONS] 도커파일경로

옵션	설명
--tag , -t	이미지 이름과 태그를 설정
--no-cache	빌드 시, 캐시 기능을 사용하지 않음

 

 

# Dockerfile 위치에서 build 명령어 실행 
**$ docker build -t myflask:0.1 .**

# docker 이미지 생성 결과 확인 
**$ docker images** 
REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
myflask                0.1                 bfac980a3b49        6 seconds ago       421MB

 

5. docker run

• 커스터마이징된 이미지를 실행시켜 컨테이너 결과를 확인해 봅니다.

$ docker run --name flask -d -p 5000:5000 myflask:0.1

6. 결과 확인

• localhost:5000 에 접속하자.

🔹 Dockerfile build 자세히 살펴보기

🔸 빌드 과정 알아보기

docker build 명령어 사용 시 빌드되는 과정을 알아봅시다.

Dockerfile에서 줄 수는 레이어 수를 의미한다. 아래와 같이 도커 파일 명령어가 실행될 때 새로운 컨테이너가 생성되며, 이를 이미지로 커밋하게 됩니다. 따라서 Dockerfile 작성 시, 줄 수을 최소화하는 것이 중요합니다.

🔸 캐시 이미지 빌드

 한 번 이미지를 빌드하면, 다시 같은 빌드를 진행할 경우 이전 빌드에서 사용했던 캐시를 이용하게 됩니다. 아래 예제로 위에서 빌드한 내용 그대로 다시 빌드해 봅시다.

• Using cache 부분을 보면 해당 명령어를 실행하지 않고 이전 캐시 내용을 사용하는 것을 알 수 있습니다.

# 1. Dockerfile를 복사한다. 
**$ cp Dockerfile Dockerfile_2**

**$ ls**
Dockerfile        Dockerfile_2        app.py            requirements.txt

# 2. 다시 같은 내용을 빌드해 봅니다. 
**$ docker build -t  myflask:0.2 -f Dockerfile_2 .**
Sending build context to Docker daemon   5.12kB
Step 1/9 : FROM ubuntu:16.04
 ---> 77be327e4b63
Step 2/9 : MAINTAINER "youremail@domain.tld"
 ---> Using cache
 ---> d528f6db2cad
Step 3/9 : RUN apt-get update -y &&     apt-get install -y python-pip python-dev
 ---> Using cache
 ---> 1073338a84e5
Step 4/9 : COPY . /app
 ---> f0aec51b1467

------- 생략 ------- 

그러나 항상 캐시 기능이 필요한 것은 아닙니다. 예를 들어 git clone과 같은 명령어를 사용할 때 캐시가 적용되면 소스가 변경될 때 변경되지 않습니다. 따라서 --no-cache 옵션을 사용하면 됩니다.

$ docker build --no-cache -t myflask:0.2 . 

🔸 멀티 스테이지 이용해서 Dockerfile 빌드하기

 멀티 스테이지는 컨테이너 이미지 생성 시 최종 컨테이너 이미지에는 필요 없는 환경은 제거하도록 단계를 나누어 이미지를 생성하는 것입니다. 이번 포스트에서는 다루지 않겠습니다. 해당 링크를 참조(https://docs.docker.com/develop/develop-images/multistage-build/) 해서 실습을 진행해 보면 좋을 것 같습니다.

 

🔸 Dockerfile 작성 시, 주의점

1. .dockerignore 파일을 작성하여 불필요한 파일을 이미지에 포함시키지 말자.

• 참고 : https://docs.docker.com/engine/reference/builder/#dockerignore-file
• 아래 예제는 Dockerfile은 포함시키지 않고 빌드하고자 합니다.

# 1. .dockerignore 파일에 불필요한 이미지를 작성합니다. 
$ vi .dockerignore 
Dockerfile

# 2. 해당 이미지를 빌드 합니다. 
$ docker build -t  myflask:0.3  .

# 3. 이미지를 실행한 후, 컨테이너에 들어 갑니다. 
$ docker run --name flask -d -p 5000:5000 myflask:0.3
3a1fa88e605b34357cf8601e04b5c1f1b8a13010ee036e67b8efe27f4fda07f6

$ docker exec -it flask bash

# 4. Dockerfile 파일만 없는 것을 확인할 수 있다. 
root@3a1fa88e605b:/app# ls
Dockerfile_2  app.py  requirements.txt

 

2. RUN 명령어를 하나로 묶을 수 있다면 && 로 묶자.

• 위에서 말했듯이 Dockerfile 한 줄은 한 이미지 레이어라고 하였습니다. 따라서 RUN 명령어는 한 줄로 묶는 것이 가능하다면 묶는 것이 좋습니다.

---

4. docker hub

 이번엔 내가 만든 이미지를 docker Hub에 올려보자. docker Hub는 다른 사용자들과 도커 이미지를 공유하는 저장소입니다.

• 참고 사이트 : https://docs.docker.com/docker-hub/

🔹 Docker hub 실습해 보기

1. docker hub 가입하기

• https://hub.docker.com/signup

2. docker 로그인하기

• 방법 1. 터미널에서 docker login 명령어로 로그인 하기

**$ sudo docker login**
WARNING: Error loading config file: /Users/jungee/.docker/config.json: EOF
Login with your Docker ID to push and pull images from Docker Hub. If you don't have a Docker ID, head over to https://hub.docker.com to create one.
**Username: [내 hub ID]
Password:** 
Login Succeeded

• 방법 2. UI에서 로그인하기 (mac 환경)
  • 아래 이미지 순서로 빨간 테두리 부분을 클릭하여 로그인해 봅니다.

도커 로그인 진행

 

자신의 도커 ID와 비밀번호를 입력

 

3. 이전에 build 한 이미지를 계정에 맞게 tag 명령어로 새로 생성해 준다.

• 이미지는 자신 계정 이름과 일치해야 Hub에 push가 가능합니다.

💡 docker tag 이미지명:[태그] 원하는_이미지_명:[태그]

**$ sudo docker tag centos_telnet:01 junge2/centos_telnet:latest** 

Password:

**$ docker images**
REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
**junge2/centos_telnet**   latest              257fc79abba7        24 hours ago        274MB

4. docker hub에 push

💡 docker push [허브_아이디]/이미지명:[태그]

**$ docker push junge2/centos_telnet:latest**

WARNING: Error loading config file: /Users/jungee/.docker/config.json: open /Users/jungee/.docker/config.json: permission denied
The push refers to repository [docker.io/junge2/centos_telnet]
648f89c4f2c4: Pushed 
0683de282177: Mounted from library/centos 
latest: digest: sha256:856ed620b2179be0d6bdbbb0c38ef41b558049642489e349e715f8526777768a size: 741

5. 사이트 docker hub에 들어가 확인해보자.

• https://hub.docker.com/repositories
• 아래 이미지와 같이 위에서 push 한 이미지가 있음을 확인할 수 있습니다.

6. 이전 이미지를 지우고, hub에 올린 이미지를 다운받아 보자.

• docker rmi : 이미지를 삭제
• docker pull [자신의 docker hub ID]/이미지:버전 : 자신이 올린 이미지를 다운로드합니다.
• docker images: 이미지 리스트 확인

**$ sudo docker rmi junge2/centos_telnet**
Untagged: junge2/centos_telnet:latest
Untagged: junge2/centos_telnet@sha256:856ed620b2179be0d6bdbbb0c38ef41b558049642489e349e715f8526777768a

**$ sudo docker pull junge2/centos_telnet:latest**
latest: Pulling from junge2/centos_telnet
Digest: sha256:856ed620b2179be0d6bdbbb0c38ef41b558049642489e349e715f8526777768a
Status: Image is up to date for junge2/centos_telnet:latest
docker.io/junge2/centos_telnet:latest

**$ docker images**
REPOSITORY             TAG                 IMAGE ID            CREATED             SIZE
junge2/centos_telnet   latest              257fc79abba7        24 hours ago        274MB

---

마무리

이번 시간에는 도커 이미지 생성 방법에 대해서 알아보았습니다. 다음 시간에는 컴포즈 사용 방법에 대해서 알아보고 직접 실습해 봅시다~ 😁