🐳 Docker

Multilingual DevOps cheat sheet: Linux, Docker, Git, Kubernetes, Helm, Terraform, practical scenarios & templates.

Docker는 격리된 컨테이너에서 애플리케이션을 실행하기 위한 플랫폼입니다. 이 치트시트에는 이미지, 컨테이너, 네트워크, 볼륨, 그리고 Docker Compose와 Swarm을 다루는 명령어가 포함되어 있습니다.

📦 기본 명령어

명령어	예시	설명
docker		하위 명령 실행 및 컨테이너, 이미지, 네트워크, 볼륨을 관리하는 주요 Docker CLI 명령어
docker version		설치된 Docker 버전(클라이언트 및 서버)을 표시합니다. 설치 확인에 유용
	docker version --format '{{.Client.APIVersion}}'	Docker 클라이언트 API 버전만 표시
	docker version --format '{{.Server.Version}}'	Docker 서버(엔진) 버전만 표시
	docker version --format '{{json .}}'	전체 버전 정보를 JSON 형식으로 출력
docker system info		일반적인 Docker 시스템 정보 표시: 컨테이너 수, 이미지, 리소스
	docker info	Docker 데이터 표시: 버전, 네트워크, 컨테이너 및 이미지 수
	docker info --format '{{json .}}'	JSON 형식으로 출력 — 자동화에 유용
	docker info --format '{{.NCPU}} CPUs, {{.MemTotal}} bytes RAM'	CPU 수 및 총 메모리 표시
	docker info --format '{{.Driver}}'	Docker가 사용하는 스토리지 드라이버 표시
docker image pull		Docker Hub 또는 다른 레지스트리에서 이미지 다운로드. 컨테이너는 이미지 없이는 실행할 수 없음
	docker pull ubuntu	최신 Ubuntu 이미지 다운로드
	docker pull nginx:alpine	Alpine Linux 기반의 경량 Nginx 이미지 다운로드
	docker pull redis:7	Redis 이미지 버전 7 다운로드
docker container run		이미지에서 새 컨테이너를 생성하고 실행
	docker run -it ubuntu bash	대화형 Bash 터미널로 Ubuntu 실행
	docker run -d nginx	Nginx를 분리(detached) 모드로 실행
	docker run -p 8080:80 nginx	Nginx 실행 후 컨테이너 포트 80을 호스트 포트 8080에 바인딩
docker container ls		실행 중인 컨테이너 나열
	docker ps	실행 중인 컨테이너만 표시
	docker ps -a	중지된 컨테이너 포함 모두 표시
	docker ps --format '{{.Names}}'	컨테이너 이름만 출력
docker container start		중지된 컨테이너 시작
	docker start container_name	이름으로 컨테이너 시작
	docker start $(docker ps -aq)	모든 컨테이너 시작
	docker start -ai container_name	컨테이너 시작 후 대화형 터미널 연결
docker container stop		실행 중인 컨테이너 중지
	docker stop container_name	이름으로 컨테이너 중지
	docker stop $(docker ps -q)	실행 중인 모든 컨테이너 중지
	docker stop -t 5 container_name	컨테이너에 5초를 주고 중지
docker container restart		컨테이너 재시작
	docker restart container_name	특정 컨테이너 재시작
	docker restart $(docker ps -q)	실행 중인 모든 컨테이너 재시작
	docker restart -t 10 container_name	10초 지연 후 컨테이너 재시작
docker container rm		컨테이너 삭제
	docker rm container_name	중지된 특정 컨테이너 삭제
	docker rm $(docker ps -aq)	모든 중지된 컨테이너 삭제
	docker rm -f container_name	실행 중인 컨테이너 강제 삭제
docker image ls		다운로드된 이미지 나열
	docker images	호스트의 모든 이미지 표시
	docker images -a	중간 레이어 포함 모든 이미지 표시
	docker images --format '{{.Repository}}:{{.Tag}}'	이미지 이름과 태그만 출력
docker image rm		로컬 저장소에서 이미지 삭제
	docker rmi test1:latest	test1 저장소의 latest 태그 이미지 삭제
	docker rmi 1a2b3c4d5e6f	ID로 이미지 삭제
	docker rmi $(docker images -q)	모든 이미지 삭제 (주의 필요!)

🔁 컨테이너 관리

명령어	예시	설명
docker container exec		실행 중인 컨테이너 안에서 명령 실행
	docker exec -it container bash	container라는 컨테이너 안에서 대화형 bash 셸 실행
	docker exec container ls /app	컨테이너 내부 /app 디렉터리에서 ls 명령 실행
	docker exec -d container touch /tmp/testfile	분리 모드로 컨테이너 안에서 명령 실행 (대기하지 않음)
docker container logs		컨테이너 로그 보기
	docker logs container	container 컨테이너의 모든 로그 표시
	docker logs -f container	실시간으로 컨테이너 로그 팔로우
	docker logs --tail 50 container	마지막 50줄 로그 표시
docker inspect		컨테이너 또는 이미지의 자세한 JSON 정보 가져오기
	docker inspect container	container 컨테이너의 세부 정보 표시
	docker inspect --format '{{.NetworkSettings.IPAddress}}' container	컨테이너의 IP 주소 표시
docker container stats		컨테이너의 실시간 리소스 사용량 표시
	docker stats	모든 컨테이너의 CPU, 메모리, 네트워크, 디스크 사용량 표시
	docker stats container_name	특정 컨테이너만 표시
	docker stats --no-stream	스냅샷 통계 한 번만 출력 후 종료
docker container rename		컨테이너 이름 변경
	docker rename old_name new_name	old_name에서 new_name으로 이름 변경
docker container cp		컨테이너와 호스트 간 파일 복사
	docker cp container:/src/file.txt ./file.txt	컨테이너에서 파일을 현재 호스트 디렉터리로 복사
	docker cp ./config.yaml container:/app/config.yaml	호스트에서 컨테이너로 파일 복사
	docker cp CONTAINER:/var/logs/app.log - | tar x -O | grep "ERROR"	컨테이너의 로그 파일을 스트리밍하여 “ERROR” 줄만 필터링 (디스크 저장 없이)
docker container top		컨테이너 내부 실행 중인 프로세스 표시
	docker top container	container라는 컨테이너의 프로세스 표시
docker container pause		컨테이너의 모든 프로세스 일시 정지
	docker pause container	container 컨테이너 일시 정지
docker container unpause		일시 정지된 컨테이너 재개
	docker unpause container	container 컨테이너 재개
docker container update		재시작 없이 컨테이너 설정 업데이트
	docker update --memory 500m container	컨테이너 메모리 사용량을 500MB로 제한

🧱 이미지와 Dockerfile

명령어	예시	설명
docker buildx build		Dockerfile에서 Docker 이미지 빌드
	docker build -t my_image .	현재 디렉터리에서 my_image 태그로 이미지 빌드
	docker build -t my_image:1.0 .	1.0 버전 태그로 이미지 빌드
	docker build --no-cache -t my_image .	캐시를 사용하지 않고 이미지 클린 빌드
docker container commit		컨테이너의 현재 상태에서 이미지 생성
	docker commit container my_img:v1	container에서 my_img:v1 이미지 생성
	docker commit -m "Added config" container my_img:v2	커밋 메시지를 포함해 이미지 생성
	docker commit -a "John Doe" container my_img:latest	작성자를 지정하여 이미지 생성
docker image tag		이미지 태그 추가 또는 변경
	docker tag my_image myrepo/my_image:latest	myrepo 레지스트리에 푸시할 태그 추가
	docker tag my_image:1.0 my_image:stable	1.0 태그 이미지에 stable 태그 생성
	docker tag my_image my_image:backup	로컬 이미지에 backup 태그 추가
docker image push		Docker Hub 또는 다른 레지스트리에 이미지 푸시
	docker push myrepo/my_image:latest	myrepo 저장소에 latest 태그 이미지 푸시
	docker push myrepo/my_image:1.0	1.0 태그 이미지 푸시
	docker push myrepo/my_image	기본 태그 latest로 이미지 푸시
docker login		Docker Hub 또는 다른 레지스트리에 로그인
	docker login	Docker Hub에 사용자명과 비밀번호로 로그인
	docker login myregistry.local:5000	개인 레지스트리에 로그인
	docker login -u username -p password	명령어로 사용자명과 비밀번호 입력 (권장하지 않음)
docker logout		Docker Hub 또는 다른 레지스트리에서 로그아웃
	docker logout	Docker Hub에서 로그아웃
	docker logout myregistry.local:5000	개인 레지스트리에서 로그아웃
HEALTHCHECK		컨테이너 상태를 자동으로 확인하는 Dockerfile 지시어
	HEALTHCHECK --interval=30s --timeout=5s --retries=3 CMD curl -f http://localhost/ || exit 1	30초마다 서비스 가용성 확인 헬스체크 추가
	docker inspect --format='{{json .State.Health}}' container_name	실행 중인 컨테이너의 헬스체크 상태 확인

🔌 네트워크와 볼륨

명령어	예시	설명
docker network ls		모든 Docker 네트워크 나열
	docker network ls	생성된 모든 Docker 네트워크 표시
	docker network ls --filter driver=bridge	bridge 드라이버 네트워크만 표시
	docker network ls --format '{{.Name}}'	네트워크 이름만 표시
docker network create		새 Docker 네트워크 생성
	docker network create my_net	my_net 이름으로 기본 설정 네트워크 생성
	docker network create --driver bridge my_bridge_net	bridge 드라이버로 네트워크 생성
	docker network create --subnet=192.168.10.0/24 my_custom_net	서브넷 지정하여 네트워크 생성
docker network connect		컨테이너를 네트워크에 연결
	docker network connect my_net container	container 컨테이너를 my_net 네트워크에 연결
	docker network connect --alias db_net my_net container	별칭 db_net으로 연결
docker network disconnect		컨테이너를 네트워크에서 분리
	docker network disconnect my_net container	container 컨테이너를 my_net에서 분리
docker volume ls		모든 Docker 볼륨 나열
	docker volume ls	모든 Docker 볼륨 표시
	docker volume ls --filter dangling=true	사용하지 않는 볼륨 표시
docker volume create		새 Docker 볼륨 생성
	docker volume create my_vol	my_vol 이름의 볼륨 생성
	docker volume create --driver local --opt type=tmpfs my_tmp_vol	tmpfs를 사용해 임시 볼륨 생성
docker volume inspect		볼륨의 세부 정보 표시
	docker volume inspect my_vol	my_vol 볼륨을 JSON 형식으로 표시
docker volume rm		볼륨 삭제
	docker volume rm my_vol	my_vol 볼륨 삭제
	docker volume rm $(docker volume ls -qf dangling=true)	사용하지 않는 모든 볼륨 삭제

🧩 도커 플러그인

명령어	예시	설명
docker plugin ls		설치된 Docker 플러그인 나열
	docker plugin ls	모든 플러그인과 상태 표시
docker plugin install		레지스트리에서 Docker 플러그인 설치
	docker plugin install vieux/sshfs	SSHFS 볼륨 플러그인 설치
	docker plugin install store/weaveworks/net-plugin:latest_release	Weave 네트워크 플러그인 설치
docker plugin disable		설치된 플러그인 비활성화
	docker plugin disable vieux/sshfs	SSHFS 플러그인 비활성화
docker plugin enable		비활성화된 플러그인 활성화
	docker plugin enable vieux/sshfs	SSHFS 플러그인 활성화
docker plugin rm		Docker 플러그인 제거
	docker plugin rm vieux/sshfs	SSHFS 플러그인 제거

📋 도커 컴포즈

명령어	예시	설명
docker compose up		docker-compose.yml에 정의된 컨테이너 시작
	docker compose up	현재 디렉터리의 모든 서비스를 대화형 모드로 시작
	docker compose up -d	서비스를 분리(detached) 모드(백그라운드)로 시작
	docker compose up --build	서비스 시작 전에 이미지 빌드
docker compose down		up으로 생성된 컨테이너, 네트워크, 볼륨 중지 및 제거
	docker compose down	실행 중인 모든 서비스 중지 및 관련 리소스 제거
	docker compose down --volumes	Compose가 생성한 볼륨도 제거
	docker compose down --rmi all	Compose가 생성한 이미지도 제거
docker compose logs		모든 서비스 또는 특정 서비스의 로그 보기
	docker compose logs	모든 서비스 로그 표시
	docker compose logs -f	실시간으로 로그 팔로우
	docker compose logs web	web 서비스의 로그만 표시
docker compose exec		실행 중인 서비스 컨테이너에서 명령 실행
	docker compose exec web bash	web 서비스 컨테이너 안에서 대화형 bash 셸 실행
	docker compose exec db ls /var/lib/postgresql	데이터베이스 컨테이너에서 ls 명령 실행
	docker compose exec -d worker touch /tmp/done	worker 컨테이너 안에서 분리 모드로 명령 실행
docker compose build		서비스 이미지 빌드 또는 재빌드
	docker compose build	docker-compose.yml에 정의된 모든 이미지 빌드
	docker compose build web	web 서비스 이미지 빌드
	docker compose build --no-cache	캐시 없이 이미지 빌드
docker compose ps		모든 서비스와 컨테이너 상태 표시
	docker compose ps -a	중지된 컨테이너 포함 모두 표시
	docker compose ps --services	서비스 이름만 표시
docker compose pull		레지스트리에서 서비스 이미지 다운로드/업데이트
	docker compose pull web	web 서비스의 이미지 가져오기
	docker compose pull --ignore-pull-failures	일부 이미지가 실패해도 계속 가져오기
docker compose restart		모든 서비스 또는 지정한 서비스 재시작
	docker compose restart db	db 서비스만 재시작
	docker compose restart -t 10	10초 타임아웃으로 서비스 재시작
docker compose config		최종 Compose 설정을 YAML 형식으로 표시
	docker compose config --services	설정에 정의된 모든 서비스 나열
	docker compose config --volumes	설정에 정의된 모든 볼륨 나열
docker compose start		중지된 서비스를 컨테이너 재생성 없이 시작
	docker compose start web	web 서비스 시작
	docker compose start db api	여러 서비스 한 번에 시작
docker compose stop		컨테이너를 제거하지 않고 서비스 중지
	docker compose stop web	web 서비스 중지
	docker compose stop -t 5	5초 타임아웃으로 서비스 중지

📤 내보내기 및 가져오기

명령어	예시	설명
docker image save		하나 이상의 Docker 이미지를 tar 아카이브로 저장하여 나중에 가져오거나 전송
	docker save -o image.tar my_img:tag	Docker 이미지를 tar 아카이브 파일로 저장
	docker save my_image > my_image.tar	이미지를 파일로 저장하는 대체 방법
	docker save -o redis_latest.tar redis:latest	특정 Redis 이미지를 파일로 저장
docker image load		이전에 저장된 tar 아카이브에서 Docker 이미지 불러오기
	docker load < image.tar	tar 아카이브 파일에서 Docker 이미지 불러오기
	docker load --input redis_latest.tar	매개변수를 통해 파일을 지정하여 이미지 불러오기
	docker load --quiet < my_image.tar	진행 출력 없이 이미지 불러오기
docker container export		컨테이너 파일시스템을 이미지 기록이나 메타데이터 없이 tar 아카이브로 내보내기
	docker export container > file.tar	컨테이너 파일시스템을 아카이브로 내보내기
	docker export my_container > my_container_fs.tar	컨테이너 이름으로 내보내기
	docker export -o container_fs.tar container_id	-o 플래그를 사용하여 컨테이너 ID로 내보내기
docker image import		파일시스템 tar 아카이브에서 새 이미지 생성
	docker import file.tar new_img	아카이브 파일을 새 Docker 이미지로 가져오기
	docker import https://example.com/image.tar my_new_image	URL에서 직접 이미지 가져오기
	docker import - my_image < file.tar	표준 입력에서 이미지 가져오기

🧹 정리 및 진단

명령어	예시	설명
docker system df		Docker 디스크 사용량 표시: 볼륨, 이미지, 컨테이너, 빌드 캐시
	docker system df -v	각 이미지, 컨테이너, 볼륨의 자세한 정보 출력
	docker system df --format '{{json .}}'	JSON 형식으로 정보 출력
docker system prune		모든 사용하지 않는 Docker 데이터 제거: 중지된 컨테이너, 미사용 네트워크, 중간 이미지, 빌드 캐시
	docker system prune -a	중간 이미지 포함 사용하지 않는 이미지 제거
	docker system prune --volumes	다른 리소스와 함께 미사용 볼륨 제거
docker image prune		사용하지 않는 Docker 이미지 제거 (dangling 레이어 포함)
	docker image prune -a	dangling 포함 모든 미사용 이미지 제거
	docker image prune --filter "until=24h"	24시간 이상 된 이미지 제거
docker container prune		필터에 맞는 중지된 컨테이너 또는 지정하지 않으면 모두 제거
	docker container prune --filter "until=24h"	24시간 이상 된 중지된 컨테이너 제거
	docker container prune --force	확인 없이 제거

🐝 도커 스웜

명령어	예시	설명
docker swarm init		현재 노드에서 새 Docker Swarm 클러스터 초기화
	docker swarm init --advertise-addr 192.168.1.100	IP 주소를 지정하여 클러스터 초기화
	docker swarm init --listen-addr 0.0.0.0:2377	리스닝 포트를 지정하여 초기화
docker service create		Swarm 클러스터에 새 서비스 생성
	docker service create --name nginx nginx	Swarm에서 Nginx 서비스 생성
	docker service create --replicas 3 --name web webserver	3개의 복제본으로 서비스 생성
	docker service create --name redis --publish 6379:6379 redis	포트 매핑으로 서비스 생성
docker stack deploy		Compose 파일 기반으로 Swarm 클러스터에 스택 배포
	docker stack deploy -c docker-compose.yml mystack	Compose 파일에서 스택 배포
	docker stack deploy --with-registry-auth -c compose.yml mystack	레지스트리 인증 전달과 함께 배포
	docker stack deploy -c swarm-compose.yml mystack	대체 Compose 파일을 사용하여 스택 배포
docker stack rm		Swarm 클러스터에서 하나 이상의 스택 제거
	docker stack rm mystack	mystack 스택 제거
	docker stack rm	모든 스택 제거 (권장하지 않음)
	docker stack rm mystack && docker swarm leave --force	스택 제거 후 Swarm에서 탈퇴

💼 고급 Docker 사용

🚀 전문가용 Docker 명령어

명령어	예시	설명
docker buildx		docker build를 대체하는 고급 이미지 빌드 도구. 다중 플랫폼, 캐싱, 병렬 빌드 및 다양한 형식으로 내보내기를 지원. CI/CD 및 크로스 플랫폼 개발에 유용
	docker buildx build --platform linux/arm64,linux/amd64 -t myimg:multi .	멀티 플랫폼 이미지 빌드 (ARM과 x86 동시에)
	docker buildx build --load -t localimg .	이미지를 빌드하고 로컬 Docker 엔진 캐시에 로드
	docker buildx build --push --platform linux/amd64,linux/arm64 -t repo/app:latest .	멀티 플랫폼 이미지를 레지스트리에 빌드 및 푸시
docker context		원격 또는 다중 환경 작업을 위한 Docker 컨텍스트 관리. 로컬과 원격 Docker 엔진 간 빠른 전환 가능
	docker context create myremote --docker "host=ssh://user@host"	원격 Docker 호스트에 연결할 컨텍스트 생성
	docker context use myremote	원격 컨텍스트로 전환
	docker context ls	사용 가능한 컨텍스트와 활성 컨텍스트 나열
docker system events		실시간으로 Docker 이벤트 수신. 이벤트 유형별 필터링 지원 (예: 컨테이너 시작). 모니터링 및 자동화에 유용
	docker events --filter 'event=start'	컨테이너 시작 이벤트만 표시
	docker events --since 1h --until 10m	지난 1시간부터 10분 전까지 이벤트 표시
	docker events --filter 'type=network'	네트워크 관련 이벤트만 표시
	docker events --filter 'image=nginx'	nginx 이미지와 관련된 이벤트 표시
docker container update		실행 중인 컨테이너의 리소스 제한 및 설정을 재시작 없이 변경
	docker update --cpus 2 --memory 1g my_container	CPU 2개와 RAM 1GB로 제한
	docker update --restart unless-stopped my_container	자동 재시작 정책을 unless-stopped로 설정
	docker update --pids-limit 200 my_container	프로세스 수를 200으로 제한
docker container diff		컨테이너의 파일시스템 변경 사항을 원본 이미지와 비교하여 표시. 디버깅 및 감사에 유용
	docker diff my_container	컨테이너의 모든 파일시스템 변경 사항 표시
	docker diff my_container | grep '^A'	추가된 파일만 표시 (A — Added)
docker image history		이미지 레이어의 히스토리 표시: 빌드 명령, 각 레이어 크기 및 생성 시간. 최적화 및 감사에 유용
	docker history my_image	이미지의 레이어 히스토리 표시
	docker history --no-trunc my_image	생략 없이 전체 빌드 명령 표시
	docker history --format "{{.CreatedBy}}: {{.Size}}" my_image	빌드 명령과 레이어 크기만 출력

🛠 유용한 Docker 활용 및 자동화

• 이미지 크기 최소화
  alpine 또는 scratch 같은 최소 베이스 이미지를 사용.
  레이어를 합치려면 빌드 시 --squash 옵션 사용 (실험적 기능 필요).
  또한 임시 파일과 캐시는 하나의 레이어에서 제거:

  RUN apk add --no-cache curl && rm -rf /var/cache/apk/*

• 레이어 수 최소화
  명령을 하나의 RUN에 결합하여 레이어 수와 최종 이미지 크기를 줄임:

  RUN apt-get update && apt-get install -y curl && rm -rf /var/lib/apt/lists/*

• Dockerfile 빌드 최적화
  멀티 스테이지 빌드를 사용해 최종 이미지에 필요한 파일만 남기기.
  먼저 의존성을 복사 및 설치한 후 코드를 복사 — 이는 레이어 캐싱을 개선하고 빌드 속도를 높임.

• 비밀과 설정 분리
  .env 파일, API 키, 개인 인증서를 이미지 내부에 저장하지 말 것.
  구성 방법:

  • docker secret (Swarm에서)
    
  • 환경 변수 (-e VAR=value 또는 .env)
    

  • 구성을 위한 외부 볼륨

• 빌드 시크릿 (BuildKit)
  빌드 중 보안을 위해 --secret 플래그 사용:

  docker buildx build --secret id=mysecret,src=./secret.txt .

  Dockerfile에서 시크릿은 /run/secrets/mysecret 경로에서 사용 가능:

  RUN --mount=type=secret,id=mysecret cat /run/secrets/mysecret

  🛡 이 방식은 이미지 레이어에 시크릿이 저장되지 않도록 함.

• 루트리스 Docker
  루트 권한 없이 Docker 실행 시 보안이 향상되고 호스트 손상 위험이 줄어듦.
  활성화 방법:

  dockerd-rootless-setuptool.sh install
  export PATH=/usr/bin:$PATH

  확인:

  docker info | grep Rootless

  ⚠ 일부 기능(예: 1024 미만 포트 포워딩)은 사용할 수 없음.

• 이미지 취약점 스캔
  내장 도구 사용:

  docker scan my_image

  또는 새로운 CLI 사용:

  docker scout cves my_image

  이 방법으로 베이스 이미지와 의존성의 취약점을 탐지할 수 있음.

• 리소스 사용 제한 및 모니터링
  컨테이너를 메모리, CPU, 프로세스 개수로 제한:

  docker run --memory=512m --cpus="1.5" --pids-limit=200 myimage

  이렇게 하면 리소스 과도 사용 방지.
  또한 I/O 제한 가능:

  docker run --device-read-bps /dev/sda:1mb --device-write-bps /dev/sda:1mb myimage

  디스크 서브시스템 과부하 방지가 필요한 컨테이너에 유용.

• 자동 정리
  정기적으로 사용하지 않는 이미지, 컨테이너, 볼륨, 네트워크 제거:

  docker system prune -af --volumes

  ⚠ 주의: 이 명령은 사용하지 않는 모든 리소스를 삭제합니다.

  선택적으로 정리하려면:

  docker image prune --filter "until=24h"

• CI/CD 통합
  GitHub Actions, GitLab CI, Jenkins 파이프라인에 빌드, 테스트, 배포 통합.
  예시 GitHub Actions 단계:

  - run: docker build -t myapp:${GITHUB_SHA} .
  - run: docker push myapp:${GITHUB_SHA}

• 로그 및 모니터링
  로그 드라이버(--log-driver)를 ELK, Loki, Splunk와 같은 중앙 시스템에 연결.
  컨테이너 메트릭은 Prometheus + cAdvisor 사용.

• 프로덕션 배포
  docker-compose.override.yml을 사용해 개발 및 프로덕션 구성을 분리.
  고가용성과 확장을 위해:

  • Docker Swarm
    

  • Kubernetes

🐞 Docker 컨테이너 디버깅 및 프로파일링

명령어	예시	설명
docker container exec		실행 중인 컨테이너 안에서 명령을 실행하여 대화형 접근 또는 격리된 환경에서 프로세스 실행 가능
	docker exec -it my_container bash	실행 중인 컨테이너 안에서 대화형 터미널(bash) 시작
	docker exec -it my_container sh	컨테이너 안에서 최소 셸 시작 (bash가 없을 경우)
	docker exec my_container ls /app	대화형 모드 없이 컨테이너 안에서 명령 실행
docker container logs		지정된 컨테이너의 로그를 표시하여 작동 관련 출력과 이벤트를 확인하고 진단 및 모니터링 가능
	docker logs -f --tail 100 my_container	실시간 스트리밍으로 최근 100줄 로그 보기
	docker logs my_container	컨테이너의 모든 로그 표시
	docker logs --since 1h my_container	지난 1시간의 로그 보기
docker inspect		컨테이너, 이미지, 네트워크 등 Docker 객체의 구성 및 상태를 포함한 상세 정보를 JSON 형식으로 출력
	docker inspect my_container	컨테이너의 전체 JSON 정보 가져오기
	docker inspect --format '{{.State.Pid}}' my_container	호스트에서 컨테이너 메인 프로세스의 PID 확인
	docker inspect --format '{{.NetworkSettings.IPAddress}}' my_container	컨테이너의 IP 주소 표시
nsenter (with strace)		Linux 유틸리티로 다른 프로세스(여기서는 컨테이너)의 네임스페이스에 진입. strace와 함께 사용해 컨테이너 내 시스템 호출을 추적 가능
	nsenter --target $(docker inspect --format '{{.State.Pid}}' my_container) --mount --uts --ipc --net --pid strace -p 1	컨테이너 네임스페이스에 진입하여 프로세스 1의 시스템 호출 추적
	nsenter --target $(docker inspect --format '{{.State.Pid}}' my_container) --mount --uts --ipc --net --pid bash	컨테이너 네임스페이스 안에서 bash 셸 열기
	nsenter --target $(docker inspect --format '{{.State.Pid}}' my_container) --net netstat -tulnp	컨테이너 내 열린 포트 확인
tcpdump (inside container)		네트워크 트래픽 캡처 및 분석용 콘솔 도구. 컨테이너 내에서 네트워크 문제 진단, 패킷 분석, 연결 모니터링에 사용
	docker exec -it my_container tcpdump -i any	컨테이너 안에서 네트워크 트래픽 캡처 및 분석
	docker exec -it my_container tcpdump -nn port 80	포트 80의 트래픽만 캡처
	docker exec -it my_container tcpdump -w /tmp/dump.pcap	트래픽을 파일에 저장하여 나중에 분석
docker container stats		하나 이상의 컨테이너에 대해 CPU, 메모리, 네트워크, 디스크 사용량을 실시간으로 표시
	docker stats my_container	컨테이너의 실시간 CPU, 메모리, 네트워크, 디스크 사용량 표시
	docker stats	모든 컨테이너의 통계 표시
	docker stats --no-stream	한 번만 출력하고 종료
docker container top		컨테이너 안에서 실행 중인 프로세스를 표시 (ps와 유사)하여 컨테이너 활동 분석
	docker top my_container	컨테이너에서 실행 중인 프로세스 표시
	docker top my_container aux	ps aux와 같은 대체 출력 형식 사용
	docker top my_container -eo pid,cmd	프로세스의 PID와 명령만 표시
docker diff		컨테이너 파일시스템이 기본 이미지와 비교해 변경된 부분 표시 (추가, 변경, 삭제된 파일)
	docker diff my_container	컨테이너 파일시스템 변경 사항 표시
	docker diff my_container | grep '^A'	추가된 파일만 표시 (A — Added)
	docker diff my_container | grep '^C'	변경된 파일만 표시 (C — Changed)
docker cp		컨테이너와 호스트 간 파일 및 디렉터리 복사로 데이터 교환 및 백업 가능
—	—	—
	docker cp my_container:/path/to/file ./file	컨테이너에서 호스트로 파일 복사
	docker cp ./config.yaml my_container:/app/config.yaml	호스트에서 컨테이너로 파일 복사
	docker cp my_container:/var/log/app.log - | tar x -O | grep "ERROR"	로그 파일을 복사하지 않고 “ERROR” 줄만 필터링하여 표시

💡 고급 디버깅에는 nsenter, strace, tcpdump, gdb와 같은 저수준 도구를 사용할 수 있습니다.

💼 Docker Compose 고급 사용법

🚀 전문가용 Docker Compose 명령어

명령어	예시	설명
docker compose up		docker-compose.yml 파일에서 지정된 서비스를 시작하고 백그라운드 실행 가능
	docker compose up -d web db	web과 db 서비스만 분리 모드로 실행
	docker compose up --build	서비스 시작 전에 이미지 재빌드
	docker compose up --remove-orphans	현재 compose 파일에 정의되지 않은 컨테이너 제거
docker compose build		캐시 제어와 병렬 빌드를 통해 compose 파일에 정의된 서비스 이미지 빌드
	docker compose build --no-cache	캐시를 사용하지 않고 전체 이미지 재빌드
	docker compose build --parallel	모든 서비스를 동시에 빌드하여 속도 향상
	docker compose build web	web 서비스 이미지 빌드
docker compose pull		모든 또는 특정 서비스의 최신 이미지 레지스트리에서 다운로드
	docker compose pull	모든 서비스 이미지 가져오기
	docker compose pull db	db 서비스 이미지 가져오기
	docker compose pull --ignore-pull-failures	가져오는 중 오류가 발생해도 무시하고 계속 실행
docker compose restart		컨테이너 재생성 없이 모든 또는 특정 서비스 재시작
	docker compose restart	현재 프로젝트의 모든 서비스 재시작
	docker compose restart worker	worker 서비스만 재시작
	docker compose restart web db	여러 서비스를 동시에 재시작
docker compose exec		실행 중인 서비스 컨테이너 안에서 대화형 모드 선택적으로 명령 실행
	docker compose exec db psql -U user -d database	db 서비스 컨테이너 안에서 psql 실행
	docker compose exec web sh	web 컨테이너 안에서 셸 열기
	docker compose exec api curl http://localhost:8080	api 서비스 컨테이너에서 curl 요청 실행
docker compose config		모든 파일과 환경 변수를 고려하여 최종 Compose 설정 출력
	docker compose config	병합된 설정을 YAML 형식으로 표시
	docker compose config --services	모든 서비스 나열
	docker compose config --environment	서비스에서 사용하는 모든 환경 변수 표시
docker compose watch		소스 파일 변경 시 서비스를 자동으로 재시작 — 개발에 유용
	docker compose watch	파일 변경을 감시하고 서비스 재시작
docker compose events		서비스 시작, 중지, 업데이트와 같은 Compose 이벤트 스트리밍
	docker compose events --json	JSON 형식으로 이벤트 수신
docker compose rm		중지된 서비스 컨테이너 제거
	docker compose rm web db	web과 db 서비스 컨테이너 제거
docker compose pause		서비스 일시 중지
	docker compose pause api	api 서비스 일시 중지
docker compose unpause		일시 중지된 서비스 재개
	docker compose unpause api	api 서비스 재개
docker compose create		컨테이너를 생성하되 시작하지 않음
	docker compose create web db	web과 db 서비스 컨테이너 생성 (시작하지 않음)
docker compose images		서비스에서 사용하는 이미지 목록 표시
	docker compose images	모든 서비스 이미지 표시
docker compose top		서비스 컨테이너 안에서 실행 중인 프로세스 표시
	docker compose top web	web 서비스 컨테이너 내 프로세스 표시

🛠 Docker Compose 활용 및 자동화

• 환경 분리
  환경별(development, staging, production)로 별도의 docker-compose.override.yml 파일을 사용하세요. 이는 구성을 분리하고 설정 충돌을 방지합니다.
  -f 플래그로 여러 구성 파일을 결합할 수도 있습니다:

  docker compose -f docker-compose.yml -f docker-compose.prod.yml up -d

  환경 변수를 관리하기 위해 다른 .env 파일(.env.dev, .env.prod 등)을 사용하세요.

• 비밀 데이터 안전 저장
  비밀번호, 토큰 같은 민감 데이터를 Compose 파일에 직접 포함하지 마세요. 대신 사용하세요:

  • 환경 변수용 .env 파일 (단, .env 파일은 암호화되지 않으며 공개 저장소에 커밋하지 말아야 함)
    
  • Docker Swarm의 docker secret 및 docker config
    
  • 비밀이 포함된 구성 파일용 외부 볼륨
    

  • 외부 비밀 관리 시스템 (예: HashiCorp Vault, AWS Secrets Manager)

• depends_on 및 healthcheck으로 시작 순서 제어
  서비스가 종속 서비스 준비를 기다리도록 설정:

  services:
    db:
      image: postgres
      healthcheck:
        test: ["CMD-SHELL", "pg_isready -U postgres"]
        interval: 10s
        retries: 5
    api:
      image: my_api
      depends_on:
        db:
          condition: service_healthy

• 업데이트 중 다운타임 최소화
  서비스 업데이트 전에 실행:

  docker compose pull && docker compose up -d --remove-orphans

  -d 옵션은 백그라운드 실행, --remove-orphans는 현재 구성에 없는 컨테이너 제거.
  필요하다면 오래된 컨테이너 완전히 중지 및 제거:

  docker compose down --remove-orphans

  이렇게 하면 새 이미지가 로드되고 불필요한 컨테이너가 다운타임 없이 제거됩니다.

• 개발용 코드 핫 리로드 (볼륨 사용)
  로컬 디렉터리를 컨테이너에 마운트하기 위해 volumes를 사용하세요. 이렇게 하면 이미지를 재빌드하지 않고도 코드 변경을 즉시 적용할 수 있습니다.
  Windows와 macOS에서 파일 권한 문제 및 파일시스템 캐싱 특성에 주의하여 성능 문제를 피하세요.

• 볼륨 없이 핫 리로드 (Compose 2.22+)

  develop:
    watch:
      - path: ./src
        action: sync
        target: /app

• 서비스 중앙 로그 관리
  컨테이너 로그를 ELK Stack, Loki, Prometheus, Fluentd 같은 시스템으로 리디렉션하여 분석 및 알림을 쉽게 할 수 있습니다.
  Docker 로깅 드라이버(--log-driver)를 사용하여 로그를 중앙 수집 및 처리.
  Compose에서 컨테이너의 로깅 드라이버를 설정:

  services:
    api:
      image: my_api
      logging:
        driver: "json-file"
        options:
          max-size: "10m"
          max-file: "3"

• 자동 서비스 재시작
  docker-compose.yml에서 재시작 정책 구성:

  restart: unless-stopped

  다른 재시작 정책:

  • no — 자동 재시작 없음 (기본값)
    
  • always — 항상 컨테이너 재시작
    

  • on-failure — 실패 시에만 재시작 (재시도 횟수 지정 가능)

  운영 환경에서는 unless-stopped가 서비스 복원성 확보에 최적.
  이렇게 하면 장애나 호스트 재부팅 후에도 서비스가 자동 복구됩니다.

• 서비스 프로파일
  특정 서비스 그룹만 실행 가능:

  services:
    db:
      image: postgres
      profiles: ["backend"]
    web:
      image: nginx
      profiles: ["frontend"]

  프론트엔드 프로파일만 실행:

  docker compose --profile frontend up

🐞 Docker Compose 서비스 디버깅 및 프로파일링

명령어	예시	설명
docker compose exec		실행 중인 서비스 안에서 명령 실행, 컨테이너 접근 또는 개별 프로세스 실행 가능
	docker compose exec web sh	web 서비스 컨테이너 안에서 셸 열기
	docker compose exec db psql -U user -d database	db 서비스 컨테이너 안에서 psql 명령 실행
docker compose logs		진단 및 모니터링을 위한 서비스 로그 보기
	docker compose logs -f db	db 서비스 로그를 실시간으로 보기
	docker compose logs --tail=50 api	api 서비스의 마지막 50줄 로그 표시
	docker compose logs --since=1h web	web 서비스의 지난 1시간 로그 표시
docker inspect		서비스를 실행하는 컨테이너의 상세 정보 보기
	docker inspect $(docker compose ps -q web)	web 서비스 컨테이너의 상세 JSON 정보 가져오기
docker container stats		서비스 컨테이너의 리소스 사용량 모니터링
	docker stats $(docker compose ps -q worker)	worker 서비스 컨테이너의 CPU, 메모리 등 리소스 사용량 추적
docker compose run --rm		서비스 설정으로 임시 컨테이너 실행 — 디버깅에 유용
	docker compose run --rm web sh	web 서비스용 임시 컨테이너를 대화형 셸로 실행
docker container cp		호스트와 컨테이너 간 파일 복사
	docker cp $(docker compose ps -q db):/dump.sql ./dump.sql	db 서비스 컨테이너에서 호스트로 파일 복사

💡 복잡한 다중 서비스 디버깅에는 docker compose run --rm을 사용해 개별 컨테이너를 필요한 네트워크와 볼륨으로 실행하면 메인 서비스에 영향을 주지 않습니다.

📚 추가 자료

🚫 .dockerignore로 파일 무시하기

이미지에 포함하지 않아야 할 파일과 폴더를 .dockerignore에 추가하여 크기를 줄이고 빌드를 빠르게 하세요:

node_modules/
*.log
.env

⚡ 별칭으로 명령 단축

자주 사용하는 명령어는 별칭을 만들어 더 빠르게 실행할 수 있습니다:

alias dcu="docker compose up -d"
alias dcd="docker compose down"
alias dcb="docker compose build"

🧠 팁: Docker 사용 조언

• 모든 걸 외우려 하지 말고 docker --help 또는 docker <command> --help로 명령 탐색하세요.
  
• 정기적으로 연습하고 간단한 프로젝트로 실험하세요.
  

• 이미지 크기를 주시하고 .dockerignore를 사용해 불필요한 파일 제거.

🌐 유용한 링크

📘 공식 Docker 문서 — Docker 관련 모든 주제에 대한 포괄적 가이드와 참고 자료:
https://docs.docker.com/

📙 Docker 치트 시트 — 공식 Docker 치트시트 전체:
https://dockerlabs.collabnix.com/docker/cheatsheet/

📗 Docker Hub — 이미지와 레지스트리:
https://hub.docker.com/