04 Docker 컨테이너 관리

728x90

※ 이 글은 '도커 교과서' 책과 교육을 통해 들은 내용, 공식 문서를 토대로 정리했습니다.

컨테이너 실행하기

docker container run [OPTIONS] IMAGE [COMMAND] [ARG...]
docker run

docker run 명령어는 컨테이너 시작 시 필요하다면 이미지를 pull하고 명령어를 수행한다.

주요 옵션

Option	Description
--name	컨테이너의 이름을 지정.
-d, --detach	컨테이너를 백그라운드에서 실행.
-e, --env	환경 변수 설정.
--env-file	환경 변수를 저장한 파일로 설정.
--expose	포트 또는 포트 범위를 노출.
-p, --publish	호스트에게 컨테이너 포트를 공개.
--rm	컨테이너가 종료되면 자동으로 삭제.
-i, --interactive	STDIN을 활성화.
-t, --tty	pseudo-TTY를 할당.
-v, --volume	볼륨 설정.

자세한 옵션은 docker run | Docker Docs를 참고하시면 됩니다.

Expose와 Publish 차이점

둘 다 컨테이너 외부 접근을 허용하기 위해 사용.
expose는 동일한 network를 사용하는 컨테이너에서만 접근이 가능.
publish는 host의 포트와 바인드하여, host 또는 외부에서도 접근이 가능.

주의사항

[COMMAND]는 Entrypoint의 추가 인자로 활용됩니다.

COMMAND 예시

$ docker run ubuntu:22.04 /bin/bash -c "whoami && date"
Unable to find image 'ubuntu:22.04' locally
22.04: Pulling from library/ubuntu
6414378b6477: Pull complete
Digest: sha256:0e5e4a57c2499249aafc3b40fcd541e9a456aab7296681a3994d631587203f97
Status: Downloaded newer image for ubuntu:22.04
root # whoami 명령어
Mon Oct 21 13:48:18 UTC 2024 # date 명령어

--publish 예시

$ docker run -d -p 81:80 nginx:latest # 81이 외부로 노출되는 포트
Unable to find image 'nginx:latest' locally
latest: Pulling from library/nginx
a480a496ba95: Pull complete
f3ace1b8ce45: Pull complete
11d6fdd0e8a7: Pull complete
f1091da6fd5c: Pull complete
40eea07b53d8: Pull complete
6476794e50f4: Pull complete
70850b3ec6b2: Pull complete
Digest: sha256:28402db69fec7c17e179ea87882667f1e054391138f77ffaf0c3eb388efc3ffb
Status: Downloaded newer image for nginx:latest
6737921148d546597b43ed1b4bc7c8157174be13bf942b1c99994cba4d17bf6b

$ curl localhost:81 # powershell 사용 시 명령어 충돌로 인한 오류가 발생하므로 curl.exe로 실행.
<!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>

컨테이너 목록 보기

# 전체
docker container ls [OPTIONS]
# 축약형
docker container list
docker container ps
docker ps

컨테이너 목록을 보는 명령어입니다.

주요 옵션

Option	Description
-a, --all	상태와 관계없이 모든 컨테이너를 표시.
-f, --filter	지정된 조건에 맞는 컨테이너만 표시.
-s, --size	전체 파일 사이즈도 표기.

자세한 옵션은 docker ps | Docker Docs을 참고하시면 됩니다.

컨테이너 로그 확인하기

docker container logs [OPTIONS] CONTAINER
docker logs

docker logs는 실행 시 존재하는 로그를 일괄 검색하는 명령어입니다.

주요 옵션

Option	Default	Description
-f, --follow		계속 로그 표시.
-n, --tail	all	마지막 n개의 로그를 표시.
-t, --timestamps		timestamp를 표기.
--since		특정 시간 이후에 발생한 로그만 표시.
--until		특정 시간 이전에 발생한 로그만 표시.

예시

$ docker logs was
/docker-entrypoint.sh: /docker-entrypoint.d/ is not empty, will attempt to perform configuration
/docker-entrypoint.sh: Looking for shell scripts in /docker-entrypoint.d/
/docker-entrypoint.sh: Launching /docker-entrypoint.d/10-listen-on-ipv6-by-default.sh
10-listen-on-ipv6-by-default.sh: info: Getting the checksum of /etc/nginx/conf.d/default.conf
10-listen-on-ipv6-by-default.sh: info: Enabled listen on IPv6 in /etc/nginx/conf.d/default.conf
/docker-entrypoint.sh: Sourcing /docker-entrypoint.d/15-local-resolvers.envsh
/docker-entrypoint.sh: Launching /docker-entrypoint.d/20-envsubst-on-templates.sh
/docker-entrypoint.sh: Launching /docker-entrypoint.d/30-tune-worker-processes.sh
/docker-entrypoint.sh: Configuration complete; ready for start up
2024/10/21 14:24:01 [notice] 1#1: using the "epoll" event method
2024/10/21 14:24:01 [notice] 1#1: nginx/1.27.2
2024/10/21 14:24:01 [notice] 1#1: built by gcc 12.2.0 (Debian 12.2.0-14)
2024/10/21 14:24:01 [notice] 1#1: OS: Linux 5.15.153.1-microsoft-standard-WSL2
2024/10/21 14:24:01 [notice] 1#1: getrlimit(RLIMIT_NOFILE): 1048576:1048576
2024/10/21 14:24:01 [notice] 1#1: start worker processes
2024/10/21 14:24:01 [notice] 1#1: start worker process 30
2024/10/21 14:24:01 [notice] 1#1: start worker process 31
2024/10/21 14:24:01 [notice] 1#1: start worker process 32
2024/10/21 14:24:01 [notice] 1#1: start worker process 33

컨테이너 접속 및 명령어 실행

Attach

docker container attach [OPTIONS] CONTAINER
docker attach

현재 실행 중인 컨테이너의 터미널의 STDIN, STDOUT, STDERR에 접근합니다.

해당 명령어의 옵션은 docker container attach | Docker Docs를 참고하시길 바랍니다.

주의사항

ctrl+c를 통해 프로세스를 종료하게 되면 컨테이너도 종료됨.
컨테이너를 종료하지 않고 접속을 종료하기 위해서는 ctrl+p+q를 사용해야 함.

Exec

docker container exec [OPTIONS] CONTAINER COMMAND [ARG...]
docker exec

docker exec는 실행 중인 컨테이너에서 새 명령어를 수행할 수 있다.

주의사항

메인 프로세스가 실행되는 동안에만 명령어 실행 가능.
exec로 실행한 명령은 컨테이너 재실행 시 실행되지 않음.
일부 컨테이너는 bash, sh와 같은 shell이 없을 수 있음. ex) Scratch 이미지, ...
-it 옵션이 없다면 원격으로 명령어를 실행하고 프로세스가 종료됨.
exec로 실행한 명령어는 working Directory를 기준으로 실행되므로 파일 사용 시 주의 필요.

$ docker exec was sh -c "pwd"
/
$ docker exec --workdir /bin was sh -c "pwd"
/bin

Attach와 Exec 차이점

	Attach	Exec
접근 터미널	컨테이너의 STDIN, STDOUT, STDERR	새로운 process의 터미널
접속 종료 방법	ctrl + p + q	ctrl + c or ctrl + d(ctrl+c로 배웠지만 ctrl+d만 됐음)
PID	1 (메인 프로세스)	!= 1

컨테이너 종료 & 시작

# 종료
docker container stop [OPTIONS] CONTAINER [CONTAINER...]
docker stop
# 시작
docker container start [OPTIONS] CONTAINER [CONTAINER...]
docker start

docker stop과 docker start에 대한 자세한 내용은 아래 링크를 참고하시길 바랍니다.

docker container stop | Docker Docs

docker container start | Docker Docs

주요사항

Dockerfile을 통해 실행되지 않은 프로세스들은 종료 후 재시작할 경우 살아나지 않음.

컨테이너 중지 & 재실행

# 중지
docker container pause CONTAINER [CONTAINER...]
docker pause
# 재실행
docker container unpause CONTAINER [CONTAINER...]
docker unpause

주요사항

재실행하는 경우 중지되어있던 모든 프로세스가 재실행됨.

컨테이너 삭제

docker container rm [OPTIONS] CONTAINER [CONTAINER...]
docker container remove
docker rm

하나 이상의 컨테이너를 삭제합니다.

docker rm $(docker ps -a -q -f status=exited)

위 명령어는 종료된 모든 컨테이너를 삭제할 때 사용하면 된다.

주요옵션

Option	Description
-f, --force	SIGKILL시그널을 사용하여 실행 중인 컨테이너를 삭제.
-v, --volumes	컨테이너의 anonymous volumes도 함께 삭제

예시

$ docker stop was
was
$ docker ps -a
CONTAINER ID   IMAGE                  COMMAND                  CREATED          STATUS                     PORTS                NAMES
5556aad7335a   nginx:latest           "/docker-entrypoint.…"   39 minutes ago   Exited (0) 2 seconds ago                        was
$ docker rm was
was
$ docker ps -a
CONTAINER ID   IMAGE                  COMMAND                  CREATED        STATUS          PORTS                 NAME

컨테이너 리소스 사용량 조회

docker container stats [OPTIONS] [CONTAINER...]
docker stats

docker stats는 실행 중인 컨테이너에 대한 실시간 데이터를 반환한다.

데이터를 하나 이상의 특정 컨테이너로 제한하려면 공백으로 구분된 컨테이너 이름 또는 ID 목록을 지정합니다.

중지된 컨테이너를 지정할 수는 있지만 중지된 컨테이너는 데이터를 반환하지 않습니다.

주요옵션

Option	Description
-a, --all	모든 컨테이너를 표시.
--no-stream	결고를 지속적으로 업데이트하지 않음.

자세한 내용은 docker container stats | Docker Docs를 참고하시면 됩니다.

이상으로 도커 컨테이너 관리에 대한 기본적인 명령어 정리를 마치겠습니다.

다음은 도커 이미지 생성 및 업로드에 대해 설명하겠습니다.

728x90

저작자표시 비영리 변경금지

'Docker' 카테고리의 다른 글

03 Docker 이미지 관리 (1)	2024.09.28
02 Docker란? (1)	2024.09.28
01 Docker 설치하기 (1)	2024.09.28

Growing up as a Infra Engineer💕

04 Docker 컨테이너 관리

컨테이너 실행하기

주요 옵션

Expose와 Publish 차이점

주의사항

COMMAND 예시

--publish 예시

컨테이너 목록 보기

주요 옵션

컨테이너 로그 확인하기

주요 옵션

예시

컨테이너 접속 및 명령어 실행

Attach

주의사항

Exec

주의사항

Attach와 Exec 차이점

컨테이너 종료 & 시작

주요사항

컨테이너 중지 & 재실행

주요사항

컨테이너 삭제

주요옵션

예시

컨테이너 리소스 사용량 조회

주요옵션

'Docker' 카테고리의 다른 글

티스토리툴바

04 Docker 컨테이너 관리

컨테이너 실행하기

주요 옵션

Expose와 Publish 차이점

주의사항

COMMAND 예시

--publish 예시

컨테이너 목록 보기

주요 옵션

컨테이너 로그 확인하기

주요 옵션

예시

컨테이너 접속 및 명령어 실행

Attach

주의사항

Exec

주의사항

Attach와 Exec 차이점

컨테이너 종료 & 시작

주요사항

컨테이너 중지 & 재실행

주요사항

컨테이너 삭제

주요옵션

예시

컨테이너 리소스 사용량 조회

주요옵션

'Docker' 카테고리의 다른 글

관련글

티스토리툴바