[Docker] Docker를 활용한 Ngnix Container 설정, 관리 & Docker hub 배포

이번에는 Python Programming 환경을 Container로 제공해 보기 위한 실습을 한번 해보겠습니다.

Docker 컨테이너에 Python 이미지 설치 및 실행

 # 샘플 소스 코드 작성(로또 프로그램)
$ vi py_lotto.py
from random import shuffle
from time import sleep

gamenum = input('로또 게임 횟수를 입력하세요: ')
for i in range(int(gamenum)):
    balls = [x+1 for x in range(45)]
    ret = []
    for j in range(6):
        shuffle(balls)             # balls를 무작위로 섞고,
        number = balls.pop()        # balls의 제일 마지막 숫자를 추출하고, 제거
        ret.append(number)          # 추출된 숫자를 ret에 추가
    ret.sort()
    print('로또번호[%d]: ' % (i+1), end='')
    print(ret)
    sleep(1)

• Python Container 실행 후 py_lotto.py 샘플 코드를 복사합니다.
• 먼저, docker run 명령어를 사용하여 Python 컨테이너를 설치하고 실행합니다. 아래 명령어는 python:latest 이미지를 다운로드하여 python_test라는 이름의 컨테이너를 백그라운드에서 실행합니다. -p 8900:8900 옵션은 호스트의 8900번 포트를 컨테이너의 8900번 포트에 매핑합니다.

toby@tobykakao:~$ docker run -it -d --name=python_test -p 8900:8900 python
Unable to find image 'python:latest' locally
latest: Pulling from library/python
c1e0ef7b956a: Already exists 
95b894d63c77: Pull complete 
cb5594266b1b: Pull complete 
59d4884f8528: Pull complete 
d2dab3c2913c: Pull complete 
19c44926628f: Pull complete 
8c7b7fcf5c89: Pull complete 
Digest: sha256:a31cbb4db18c6f09e3300fa85b77f6d56702501fcb9bdb8792ec702a39ba6200
Status: Downloaded newer image for python:latest
8d3a7836310293de69e69500c137324c5f71a4c75bb3733fe7d19044628016ad

• 파이썬 컨테이너를 확인합니다.
• 컨테이너가 실행된 후, Python 파일을 컨테이너 내부로 복사할 수 있습니다. 예를 들어, py_lotte.py라는 파일을 python_test 컨테이너에 복사하려면 다음 명령어를 사용합니다.
• 그다음, docker exec 명령어를 사용하여 python_test 컨테이너에 접속하고 Python 인터프리터를 실행하거나 스크립트를 실행할 수 있습니다.

toby@tobykakao:~$ docker cp py_lotte.py python_test:/
Successfully copied 2.56kB to python_test:/

toby@tobykakao:~$ docker exec -it python_test bash
root@8d3a78363102:/# python
Python 3.13.0 (main, Oct 19 2024, 18:03:27) [GCC 12.2.0] on linux
Type "help", "copyright", "credits" or "license" for more information.
>>> exit()

• python 관련 도구를 확인합니다.

root@8d3a78363102:/# pip list
Package Version
------- -------
pip     24.2

• 파이썬 컨테이너에 설치된 파일의 모듈을 확인합니다.

root@8d3a78363102:/# python -c 'help("modules")'

Please wait a moment while I gather a list of all available modules...

__future__          _stat               faulthandler        re
__hello__           _statistics         fcntl               readline
__phello__          _string             filecmp             reprlib
_abc                _strptime           fileinput           resource
_aix_support        _struct             fnmatch             rlcompleter
_android_support    _suggestions        fractions           runpy
_ast                _symtable           ftplib              sched
_asyncio            _sysconfig          functools           secrets
_bisect             _sysconfigdata__linux_aarch64-linux-gnu gc                  select
_blake2             _testbuffer         genericpath         selectors
_bz2                _testcapi           getopt              shelve
_codecs             _testclinic         getpass             shlex
_codecs_cn          _testclinic_limited gettext             shutil
_codecs_hk          _testexternalinspection glob                signal
_codecs_iso2022     _testimportmultiple graphlib            site
_codecs_jp          _testinternalcapi   grp                 smtplib
_codecs_kr          _testlimitedcapi    gzip                socket
_codecs_tw          _testmultiphase     hashlib             socketserver
_collections        _testsinglephase    heapq               sqlite3
_collections_abc    _thread             hmac                sre_compile
_colorize           _threading_local    html                sre_constants
_compat_pickle      _tkinter            http                sre_parse
_compression        _tokenize           idlelib             ssl
_contextvars        _tracemalloc        imaplib             stat
_csv                _typing             importlib           statistics
_ctypes             _uuid               inspect             string
_ctypes_test        _warnings           io                  stringprep
_curses             _weakref            ipaddress           struct
_curses_panel       _weakrefset         itertools           subprocess
_datetime           _xxtestfuzz         json                symtable
_dbm                _zoneinfo           keyword             sys
_decimal            abc                 linecache           sysconfig
_elementtree        antigravity         locale              syslog
_functools          argparse            logging             tabnanny
_gdbm               array               lzma                tarfile
_hashlib            ast                 mailbox             tempfile
_heapq              asyncio             marshal             termios
_imp                atexit              math                textwrap
_interpchannels     base64              mimetypes           this
_interpqueues       bdb                 mmap                threading
_interpreters       binascii            modulefinder        time
_io                 bisect              multiprocessing     timeit
_ios_support        builtins            netrc               tkinter
_json               bz2                 ntpath              token
_locale             cProfile            nturl2path          tokenize
_lsprof             calendar            numbers             tomllib
_lzma               cmath               opcode              trace
_markupbase         cmd                 operator            traceback
_md5                code                optparse            tracemalloc
_multibytecodec     codecs              os                  tty
_multiprocessing    codeop              pathlib             turtle
_opcode             collections         pdb                 turtledemo
_opcode_metadata    colorsys            pickle              types
_operator           compileall          pickletools         typing
_osx_support        concurrent          pip                 unicodedata
_pickle             configparser        pkgutil             unittest
_posixshmem         contextlib          platform            urllib
_posixsubprocess    contextvars         plistlib            uuid
_py_abc             copy                poplib              venv
_pydatetime         copyreg             posix               warnings
_pydecimal          csv                 posixpath           wave
_pyio               ctypes              pprint              weakref
_pylong             curses              profile             webbrowser
_pyrepl             dataclasses         pstats              wsgiref
_queue              datetime            pty                 xml
_random             dbm                 pwd                 xmlrpc
_sha1               decimal             py_compile          xxlimited
_sha2               difflib             py_lotte            xxlimited_35
_sha3               dis                 pyclbr              xxsubtype
_signal             doctest             pydoc               zipapp
_sitebuiltins       email               pydoc_data          zipfile
_socket             encodings           pyexpat             zipimport
_sqlite3            ensurepip           queue               zlib
_sre                enum                quopri              zoneinfo
_ssl                errno               random              

Enter any module name to get more help.  Or, type "modules spam" to search
for modules whose name or summary contain the string "spam".

root@8d3a78363102:/# exit 
exit

• 외부에서 파이썬 컨테이너 코드를 실행해보겠습니다.

toby@tobykakao:~$ docker exec -it python_test python /py_lotte.py
\ub85c\ub610 \uac8c\uc784 \ud69f\uc218\ub97c \uc785\ub825\ud558\uc138\uc694: 5
\ub85c\ub610\ubc88\ud638[1]: [5, 15, 26, 35, 37, 45]
\ub85c\ub610\ubc88\ud638[2]: [2, 4, 5, 6, 16, 30]
\ub85c\ub610\ubc88\ud638[3]: [7, 14, 23, 24, 30, 44]
\ub85c\ub610\ubc88\ud638[4]: [9, 12, 15, 25, 32, 45]
\ub85c\ub610\ubc88\ud638[5]: [8, 15, 19, 40, 43, 44]

Container 내부에 소스코드, 구성 정보 (conf)등을 변경하는 경우 docker cp가 유용합니다. 예를 들어서, ngnix의 구성파일인 ngnix.conf를 수정해야 한다면 굳이 컨데이너에 편집기를 설치하는 수고를 들이거나 경량의 컨테이너를 무겁게 할 필요가 없습니다.

docker run 명령어로 Python 컨테이너를 설치하고 실행.
docker cp 로 Python 파일을 컨테이너로 복사.
docker exec 로 컨테이너 내에서 Python 스크립트 실행.

---

Docker를 활용한 Nginx 컨테이너 설정 및 구성 파일 관리

Nginx Docker 컨테이너를 생성하고, Nginx 설정 파일을 호스트로 복사한 뒤 수정하여 다시 컨테이너로 복사하고 재시작하는 방법을 설명해 보겠습니다.

 

먼저, docker run 명령어를 사용하여 Nginx 컨테이너를 생성합니다. -p 8010:80 옵션은 호스트의 8010번 포트를 컨테이너의 80번 포트와 매핑하여, 웹 브라우저에서 http://localhost:8010으로 접근할 수 있게 합니다.

# nginx 컨테이너를 만든다.
toby@tobykakao:~$ docker run -d -p 8010:80 --name=webserver10 nginx:latest
0b423670cb26dfa30faea24f31c0539b7aa522fe017dc046deb69aeedbacbfa4

 

docker cp 명령어를 사용하여 컨테이너 내부의 Nginx 설정 파일을 호스트로 복사합니다. 설정 파일은 /etc/nginx/nginx.conf 경로에 있으며, 이를 로컬의 현재 디렉토리로 복사할 수 있습니다.

# nginx 컨테이너의 nginx.conf를 호스트로 복사해 온다.
toby@tobykakao:~$ docker cp webserver10:/etc/nginx/nginx.conf ./nginx.conf
Successfully copied 2.56kB to /home/toby/nginx.conf

이 명령을 통해 nginx.conf 파일이 호스트의 현재 디렉토리에 복사됩니다. 그리고 nginx.conf 파일을 수정한 후, 동일한 경로로 컨테이너에 다시 복사합니다.

# nginx 구성 정보를 변경했다고 가정한다. 다시 원래 위치에 복사해 준다.
toby@tobykakao:~$ docker cp nginx.conf webserver10:/etc/nginx/nginx.conf
Successfully copied 2.56kB to webserver10:/etc/nginx/nginx.conf

이 명령어를 실행하면 수정된 설정 파일이 Nginx 컨테이너의 원래 위치에 덮어쓰기됩니다.

또한 Nginx 설정 파일을 반영하려면 컨테이너를 재시작해야 합니다. docker restart 명령어를 통해 컨테이너를 재시작합니다. 이제 아래처럼 Nginx 컨테이너가 재시작되어 새로운 설정이 적용됩니다.

# nginx 컨테이너를 재시작해 준다.
toby@tobykakao:~$ docker restart webserver10
webserver10

docker run을 사용해 Nginx 컨테이너 생성.
docker cp로 Nginx 설정 파일을 호스트로 복사.
수정된 설정 파일을 다시 컨테이너로 복사.
docker restart로 Nginx 컨테이너를 재시작하여 설정 적용.

---

Node.js 테스트 환경을 위한 컨테이너 실행

Docker를 활용하여 Node.js 애플리케이션을 실행하는 방법을 설명합니다. Node.js 샘플 코드를 작성하고, Docker 컨테이너에 복사한 후 실행하는 과정을 단계별로 다룹니다.

먼저 nodejs_test.js라는 파일을 생성하고, HTTP 서버를 간단히 설정하는 코드를 작성합니다.

# node.js 샘플 코드 실행을 위한 컨테이너를 생성한다.
toby@tobykakao:~$ vi nodejs_test.js
var http = require('http');
var content = function(req, resp) {
    resp.end("Good morning Korea~!" + "\n");
    resp.writeHead(200);
}

다음으로 Node.js Docker 이미지를 다운로드합니다. 최신 버전을 사용하려면 docker pull node 명령어를 입력합니다.

# node 컨테이너를 실행한다.
toby@tobykakao:~$ docker pull node
Using default tag: latest
latest: Pulling from library/node
c1e0ef7b956a: Already exists 
95b894d63c77: Already exists 
cb5594266b1b: Already exists 
59d4884f8528: Already exists 
dfd6b1d2546c: Pull complete 
a4ac632c2863: Pull complete 
0ce2f898cccf: Pull complete 
478f75ada764: Pull complete 
Digest: sha256:840dad0077213cadd2d734d542ae11cd0f648200be29504eb1b6e2c995d2b75a
Status: Downloaded newer image for node:latest
docker.io/library/node:latest

Node.js 컨테이너를 생성하고 백그라운드에서 실행합니다. -p 8002:8002 옵션을 통해 호스트의 8002 포트를 컨테이너의 8002 포트에 매핑합니다.

# 소스 코드 복사 후 실행한다.
toby@tobykakao:~$ docker run -d -it -p 8002:8002 --name=nodejs_test node
bb75f81042af805aebb73c63757adb595d5c308255650cd6126c164f9b0b1b45

toby@tobykakao:~$ docker ps
CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS          PORTS                                       NAMES
bb75f81042af   node           "docker-entrypoint.s\u2026"   4 seconds ago    Up 3 seconds    0.0.0.0:8002->8002/tcp, :::8002->8002/tcp   nodejs_test
0b423670cb26   nginx:latest   "/docker-entrypoint.\u2026"   5 minutes ago    Up 3 minutes    0.0.0.0:8010->80/tcp, [::]:8010->80/tcp     webserver10
8d3a78363102   python         "python3"                21 minutes ago   Up 21 minutes   0.0.0.0:8900->8900/tcp, :::8900->8900/tcp   python_test

그후, 작성한 nodejs_test.js 파일을 docker cp 명령어를 사용하여 nodejs_test 컨테이너로 복사합니다.

# 소스 코드 복사 후 실행한다.
toby@tobykakao:~$ docker cp nodejs_test.js nodejs_test:/nodejs_test.js
toby@tobykakao:~$ docker exec -it nodejs_test node /nodejs_test.js

위에서 생성한 컨테이너 이름이 nodejs_test입니다. 만약 컨테이너 이름을 변경하고 싶다면 docker rename을 이용해서 변경할 수 있습니다. 컨테이너의 이름을 주지 않고 생성한 경우에 애플리케이션과 연관된 이름으로 변경할 경우, 컨테이너의 실행과 상관없이 동적 변경이 된다.

# 방식: docker rename <기존의 Container명> <새로운 Container명>
toby@tobykakao:~$ docker rename nodejs_test nodeapp
toby@tobykakao:~$ docker ps
CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS          PORTS                                       NAMES
bb75f81042af   node           "docker-entrypoint.s\u2026"   8 minutes ago    Up 8 minutes    0.0.0.0:8002->8002/tcp, :::8002->8002/tcp   nodeapp
0b423670cb26   nginx:latest   "/docker-entrypoint.\u2026"   14 minutes ago   Up 12 minutes   0.0.0.0:8010->80/tcp, [::]:8010->80/tcp     webserver10
8d3a78363102   python         "python3"                30 minutes ago   Up 30 minutes   0.0.0.0:8900->8900/tcp, :::8900->8900/tcp   python_test

docker commit은 생성한 컨테이너의 node 프로그램 환경과 저장한 소스 코드 그대로 새로운 이미지로 생성할 수 있습니다.

일반적으로 도커 이미지를 통해 컨테이너를 생성하지만, docker commit을 통해 컨테이너를 이미지로 생성할 수도 있습니다.

먼저 nginx:latest 이미지를 사용해 Nginx 컨테이너를 실행합니다.

toby@tobykakao:~$ docker run -it --name webserver8 -d -p 8008:80 nginx:latest
4bd32b7f867b4d6665d94fc5761a4840c96dc4566a0d3662b66854fad60459a5
toby@tobykakao:~$ docker ps
CONTAINER ID   IMAGE          COMMAND                  CREATED          STATUS          PORTS                                       NAMES
4bd32b7f867b   nginx:latest   "/docker-entrypoint.\u2026"   13 seconds ago   Up 12 seconds   0.0.0.0:8008->80/tcp, [::]:8008->80/tcp     webserver8
bb75f81042af   node           "docker-entrypoint.s\u2026"   10 minutes ago   Up 10 minutes   0.0.0.0:8002->8002/tcp, :::8002->8002/tcp   nodeapp
0b423670cb26   nginx:latest   "/docker-entrypoint.\u2026"   15 minutes ago   Up 13 minutes   0.0.0.0:8010->80/tcp, [::]:8010->80/tcp     webserver10
8d3a78363102   python         "python3"                31 minutes ago   Up 31 minutes   0.0.0.0:8900->8900/tcp, :::8900->8900/tcp   python_test

먼저 nginx:latest 이미지를 사용해 Nginx 컨테이너를 실행합니다.

# index.html 파일 수정
toby@tobykakao:~$ vi index.html

# curl localhost:8008을 통해 정상 동작을 확인한다.
toby@tobykakao:~$ curl localhost:8008
<!DOCTYPE html>
<html>
<head>
<title>Welcome to nginx!</title>
<style>
html { color-scheme: light dark; }
body { width: 35em; margin: 0 auto;
font-family: Tahoma, Verdana, Arial, sans-serif; }
</style>
</head>
<body>
<h1>Welcome to nginx!</h1>
<p>If you see this page, the nginx web server is successfully installed and
working. Further configuration is required.</p>

<p>For online documentation and support please refer to
<a href="http://nginx.org/">nginx.org</a>.<br/>
Commercial support is available at
<a href="http://nginx.com/">nginx.com</a>.</p>

<p><em>Thank you for using nginx.</em></p>
</body>
</html>

그후, 컨테이너 내부의 index.html 파일을 수정하기 위해 다음과 같이 호스트에서 수정한 파일을 컨테이너로 복사할 수 있습니다.

# 도커 cp 명령어로 파일 복사
toby@tobykakao:~$ docker ps index.html webserver8:/usr/share/nginx/html/index/html
"docker ps" accepts no arguments.
See 'docker ps --help'.

Usage:  docker ps [OPTIONS]

List containers

컨테이너 내에서 파일이나 디렉터리가 추가, 삭제, 또는 수정되었는지 확인하려면 docker diff 명령을 사용합니다.

위에서 C는 변경됨, A는 추가됨, D는 삭제됨을 나타냅니다.

# 추가된 웹 소스 변경 정보를 확인하려면 docker diff(difference) 명령을 통해 가능하다.
# docker diff는 파일 및 디렉터리의 모든 변경 정보를 추적한다.
# 앞 열의 키워드는 A(추가), D(삭제), C(변경)를 의미한다.
toby@tobykakao:~$ docker diff webserver8
C /var
C /var/cache
C /var/cache/nginx
A /var/cache/nginx/fastcgi_temp
A /var/cache/nginx/proxy_temp
A /var/cache/nginx/scgi_temp
A /var/cache/nginx/uwsgi_temp
A /var/cache/nginx/client_temp
C /etc
C /etc/nginx
C /etc/nginx/conf.d
C /etc/nginx/conf.d/default.conf
C /run

변경된 내용을 새로운 Docker 이미지로 저장하기 위해 docker commit 명령을 사용합니다. -a 옵션을 사용하여 작성자를 지정할 수 있습니다.

# docker commit으로 이미지를 생성한다. 이때 -a(author)는 생성한 사람의 이니셜이다.
toby@tobykakao:~$ docker commit -a "kakao" webserver8 webfront:1.0
sha256:09366d99740ca4b93678281409da85a04376a544a4f5fee5d5b842b57ee076fe

# 이미지 확인
toby@tobykakao:~$ docker images | grep webfront
webfront                1.0       09366d99740c   24 seconds ago   197MB
toby@tobykakao:~$

이미지를 Docker Hub에 업로드하기 위해 먼저 Docker Hub에 로그인합니다. Docker Hub에 업로드한 이미지를 사용해 새로운 컨테이너를 실행하고, 정상적으로 작동하는지 curl 명령어로 확인합니다.

# 본인의 도커 허브 저장소에 올려본다.
toby@tobykakao:~$ docker login
Authenticating with existing credentials...
WARNING! Your password will be stored unencrypted in /home/toby/.docker/config.json.
Configure a credential helper to remove this warning. See
https://docs.docker.com/engine/reference/commandline/login/#credential-stores

Login Succeeded

toby@tobykakao:~$ docker tag webfront:1.0 daehyunbigbread/webfront:1.0

toby@tobykakao:~$ docker push daehyunbignread/webfront:1.0
The push refers to repository [docker.io/daehyunbignread/webfront]
An image does not exist locally with the tag: daehyunbignread/webfront

# 푸시한 이미지로 잘 동작하는지 확인해 보자.
toby@tobykakao:~$ docker run -it --name webserver9 -d -p 8009:80 본인ID/webfront:1.0
toby@tobykakao:~$ curl localhost:8009

Node.js 샘플 코드를 작성하여 컨테이너 내부로 복사.
docker pull을 통해 Node.js 이미지를 다운로드.
docker run으로 Node.js 컨테이너를 생성하고 포트를 매핑.
컨테이너 내에서 Node.js 애플리케이션을 실행.
Nginx 컨테이너 생성 및 파일 수정.
docker diff 명령으로 변경 사항 확인.
변경된 컨테이너 상태를 새로운 이미지로 커밋.
Docker Hub에 이미지 푸시.
푸시한 이미지로 새로운 컨테이너를 실행하고 테스트.