실무 필수! 🚀 Docker 명령어 치트시트 & 핵심 옵션 완전 정복 (feat. 예시 폭탄)

G: 안녕하세요! 🐳 현대 개발/운영 환경에서 Docker는 이제 선택이 아닌 필수가 되어가고 있죠. 컨테이너 기술의 핵심인 Docker를 통해 우리는 애플리케이션을 더 빠르고 효율적으로 배포하고 관리할 수 있습니다. 하지만 처음 접하는 분들은 수많은 명령어와 옵션들 때문에 혼란스러울 수 있어요.

이 글은 그런 여러분들을 위해 준비했습니다! 실무에서 바로 쓸 수 있는 핵심 Docker 명령어와 자주 사용되는 옵션들을 한눈에 파악할 수 있도록 치트시트 형식으로 정리하고, 풍부한 예시와 함께 설명해 드릴게요. 이 글 하나면 여러분도 Docker 고수가 될 수 있습니다! ✨

💡 Docker 핵심 개념 짚고 가기

본격적인 명령어 설명에 앞서, Docker를 이해하는 데 꼭 필요한 몇 가지 핵심 개념을 짧게 짚고 넘어갈게요. 이 개념들을 알고 나면 명령어들이 훨씬 더 명확하게 다가올 거예요.

이미지 (Image): 컨테이너를 생성하기 위한 읽기 전용 템플릿입니다. 애플리케이션, 라이브러리, 환경 설정 등 모든 것이 포함된 일종의 ‘청사진’ 또는 ‘붕어빵 틀’이라고 생각하시면 돼요. 📦
컨테이너 (Container): 이미지의 실행 가능한 인스턴스입니다. 이미지를 바탕으로 독립된 환경에서 애플리케이션이 격리되어 실행되는 공간이죠. ‘붕어빵 틀’로 만들어진 실제 ‘붕어빵’에 비유할 수 있습니다. 런타임 환경이라고 보시면 됩니다. 🏃‍♀️
레지스트리 (Registry): Docker 이미지를 저장하고 공유하는 공간입니다. 가장 유명한 것이 바로 Docker Hub이며, 비공개 이미지를 위한 프라이빗 레지스트리도 존재합니다. 💾
볼륨 (Volume): 컨테이너가 삭제되어도 데이터가 사라지지 않고 영구적으로 저장될 수 있도록 컨테이너 외부에 데이터를 연결하는 방식입니다. 컨테이너의 휘발성 문제를 해결해 줍니다. 🗄️
네트워크 (Network): 여러 컨테이너들이 서로 통신하거나, 컨테이너가 외부와 통신할 수 있도록 연결하는 방법입니다. 🔗

🚀 Docker 명령어 치트시트 & 핵심 옵션

자, 이제 실전입니다! 가장 자주 사용하고 중요한 명령어들을 카테고리별로 나누어 자세히 살펴볼게요.

I. 컨테이너 기본 라이프사이클 🔄

컨테이너를 생성하고, 실행하고, 중지하고, 삭제하는 가장 기본적인 명령어들입니다.

docker run: 컨테이너를 생성하고 실행합니다. Docker의 꽃이라고 할 수 있죠! 🌹
```
docker run [옵션] <이미지 이름>[:태그] [실행할 명령어]
```
- 핵심 옵션:
  - -d (or --detach): 백그라운드에서 컨테이너를 실행합니다. 터미널을 점유하지 않아 매우 유용합니다.
  - -p <호스트포트>:<컨테이너포트> (or --publish): 호스트와 컨테이너 간의 포트 매핑을 설정합니다. 외부에 서비스를 노출할 때 필수입니다.
  - --name <컨테이너이름>: 컨테이너에 알아보기 쉬운 이름을 부여합니다. 이름을 지정하지 않으면 Docker가 임의의 이름을 생성합니다.
  - --rm: 컨테이너 종료 시 자동으로 컨테이너를 삭제합니다. 일회성 테스트 용도에 적합합니다.
  - -it (or --interactive --tty): 컨테이너와 상호작용 가능한 터미널을 연결합니다. 보통 컨테이너 내부로 진입하거나, 특정 명령어를 실행할 때 사용합니다.
  - -v <호스트경로>:<컨테이너경로> (or --volume): 호스트의 디렉토리나 볼륨을 컨테이너에 마운트합니다. 데이터 지속성을 위해 필수입니다.
  - -e <환경변수명>=<값> (or --env): 컨테이너 내부에 환경 변수를 설정합니다. 데이터베이스 비밀번호 등 민감 정보를 설정할 때 유용합니다.
- 예시:
  - Nginx 웹 서버를 백그라운드에서 실행하고 80번 포트를 호스트의 8080번 포트에 연결하며, 이름을 my-nginx로 지정:
```
docker run -d -p 8080:80 --name my-nginx nginx:latest
```
    ➡️ 이제 웹 브라우저에서 http://localhost:8080으로 접속하면 Nginx 기본 페이지를 볼 수 있어요! 🌐
  - MySQL 데이터베이스 컨테이너를 실행하며 root 비밀번호를 설정하고, 데이터를 my-mysql-data라는 볼륨에 저장:
```
docker run -d -p 3306:3306 --name my-mysql \
-e MYSQL_ROOT_PASSWORD=mysecretpassword \
-v my-mysql-data:/var/lib/mysql \
mysql:8.0
```
    ➡️ 데이터베이스 컨테이너 실행 시 환경 변수 설정과 볼륨 마운트가 필수적입니다! 🔑
  - Ubuntu 컨테이너를 대화형으로 실행하고 바로 bash 셸로 진입:
```
docker run -it ubuntu:latest bash
```
    ➡️ 컨테이너 내부에서 자유롭게 명령어(ls, pwd 등)를 실행해 볼 수 있습니다. exit로 빠져나올 수 있어요. 💻
docker ps: 현재 실행 중인 컨테이너 목록을 보여줍니다.
```
docker ps [옵션]
```
- 핵심 옵션:
  - -a (or --all): 실행 중이거나 중지된 모든 컨테이너를 보여줍니다.
  - -q (or --quiet): 컨테이너 ID만 보여줍니다. 다른 명령어와 조합할 때 유용합니다.
- 예시:
  - 실행 중인 컨테이너 보기:
```
docker ps
```
  - 모든 컨테이너 (실행 중 + 중지됨) 보기:
```
docker ps -a
```
  - 모든 컨테이너의 ID만 보기:
```
docker ps -aq
```
    ➡️ 이 ID들은 docker stop, docker rm 등 다른 명령어와 함께 사용될 때 강력합니다! 💪
docker start <컨테이너ID 또는 이름>: 중지된 컨테이너를 다시 시작합니다.
- 예시:
```
docker start my-nginx
```
docker stop <컨테이너ID 또는 이름>: 실행 중인 컨테이너를 정상적으로 중지합니다.
- 예시:
```
docker stop my-nginx
```
docker restart <컨테이너ID 또는 이름>: 실행 중인 컨테이너를 중지했다가 다시 시작합니다.
- 예시:
```
docker restart my-nginx
```
docker rm <컨테이너ID 또는 이름>: 중지된 컨테이너를 삭제합니다.
- 핵심 옵션:
  - -f (or --force): 실행 중인 컨테이너도 강제로 삭제합니다. (주의해서 사용하세요!)
- 예시:
  - my-nginx 컨테이너 삭제:
```
docker rm my-nginx
```
  - 모든 중지된 컨테이너 삭제 (꿀팁!):
```
docker rm $(docker ps -aq --filter "status=exited")
```
    ➡️ 이 명령어는 exited 상태의 모든 컨테이너 ID를 찾아 한번에 삭제해 줍니다. 🗑️

II. 이미지 관리 🖼️

컨테이너의 기반이 되는 이미지를 다운로드하고, 빌드하고, 관리하는 명령어들입니다.

docker pull <이미지 이름>[:태그]: Docker Hub 등 레지스트리에서 이미지를 다운로드합니다.
- 예시:
```
docker pull ubuntu:22.04
docker pull nginx
```
  ➡️ :latest 태그는 기본값이라 생략 가능합니다. ⬇️
docker build -t <이미지이름>[:태그] <Dockerfile 경로>: Dockerfile을 이용해 사용자 정의 이미지를 빌드합니다.
- 핵심 옵션:
  - -t <이미지이름>[:태그> (or --tag): 빌드된 이미지에 이름과 태그를 부여합니다.
  - .: Dockerfile이 현재 디렉토리에 있을 때 사용합니다. (Context path)
- 예시 (Dockerfile 예시와 함께):
  - Dockerfile 내용:
```
# Dockerfile
FROM alpine:latest
RUN apk add --no-cache curl
CMD ["curl", "https://www.google.com"]
```
  - 이미지 빌드:
```
docker build -t my-curl-app:1.0 .
```
    ➡️ 이 명령어를 실행하면 my-curl-app:1.0이라는 이미지가 생성됩니다. 이제 이 이미지로 컨테이너를 실행할 수 있어요! 🛠️
docker images: 로컬에 저장된 이미지 목록을 보여줍니다.
- 핵심 옵션:
  - -a (or --all): 빌드 중간에 생성된 레이어 이미지까지 모두 보여줍니다.
- 예시:
```
docker images
```
docker rmi <이미지ID 또는 이름>[:태그]: 로컬에 저장된 이미지를 삭제합니다.
- 핵심 옵션:
  - -f (or --force): 해당 이미지를 사용하는 컨테이너가 있어도 강제로 삭제합니다. (주의)
- 예시:
```
docker rmi my-curl-app:1.0
```
  ➡️ 사용 중인 이미지는 삭제할 수 없습니다. 관련 컨테이너를 먼저 삭제해야 합니다. ❌

III. 컨테이너 정보 확인 및 진입 🔍

실행 중인 컨테이너의 로그를 확인하거나, 컨테이너 내부로 진입하여 디버깅하는 데 유용한 명령어들입니다.

docker logs <컨테이너ID 또는 이름>: 컨테이너의 표준 출력(STDOUT) 및 표준 에러(STDERR) 로그를 확인합니다. 디버깅에 필수적입니다. 📜
- 핵심 옵션:
  - -f (or --follow): 실시간으로 로그를 계속해서 보여줍니다. (Ctrl+C로 종료)
  - --tail <숫자>: 로그의 마지막 숫자 줄만 보여줍니다.
  - -t (or --timestamps): 로그에 타임스탬프를 추가합니다.
- 예시:
```
docker logs my-nginx
docker logs -f my-nginx
docker logs --tail 100 my-nginx
```
docker exec -it <컨테이너ID 또는 이름> <명령어>: 실행 중인 컨테이너 내부에서 명령어를 실행합니다. 컨테이너 내부 셸로 진입할 때 주로 사용합니다. 💻
- 핵심 옵션:
  - -it: 상호작용 가능한 터미널 연결 (필수!)
- 예시:
  - my-nginx 컨테이너 내부에서 ls -l /etc/nginx 명령어 실행:
```
docker exec -it my-nginx ls -l /etc/nginx
```
  - my-nginx 컨테이너의 bash 셸로 진입:
```
docker exec -it my-nginx bash
```
    ➡️ 컨테이너 내부에 bash 셸이 없으면 sh 또는 다른 셸을 시도해 보세요. (docker exec -it my-nginx sh)
docker inspect <컨테이너ID 또는 이름> / docker inspect <이미지ID 또는 이름>: 컨테이너나 이미지의 상세 정보를 JSON 형식으로 출력합니다. 네트워크 설정, 볼륨 마운트, 환경 변수 등 모든 정보를 확인할 수 있습니다. 🔬
- 핵심 옵션:
  - --format "{{.NetworkSettings.IPAddress}}": 특정 필드만 추출하여 보기 쉽게 포맷팅합니다.
- 예시:
  - my-nginx 컨테이너의 모든 정보 확인:
```
docker inspect my-nginx
```
  - my-nginx 컨테이너의 IP 주소만 확인:
```
docker inspect --format '{{.NetworkSettings.IPAddress}}' my-nginx
```
docker stats <컨테이너ID 또는 이름>: 실행 중인 컨테이너의 CPU, 메모리, 네트워크 사용량 등을 실시간으로 모니터링합니다. 📈
- 예시:
```
docker stats
docker stats my-nginx
```

IV. 볼륨 관리 💾

컨테이너의 데이터를 영구적으로 저장하고 관리하는 명령어들입니다.

docker volume create <볼륨이름>: 새로운 볼륨을 생성합니다.
- 예시:
```
docker volume create my-app-data
```
docker volume ls: 생성된 볼륨 목록을 보여줍니다.
- 예시:
```
docker volume ls
```
docker volume inspect <볼륨이름>: 특정 볼륨의 상세 정보를 확인합니다. 실제 저장 경로 등을 알 수 있습니다.
- 예시:
```
docker volume inspect my-app-data
```
docker volume rm <볼륨이름>: 볼륨을 삭제합니다. 볼륨 내의 모든 데이터가 삭제되므로 주의하세요. ⚠️
- 예시:
```
docker volume rm my-app-data
```
  ➡️ 사용 중인 볼륨은 삭제할 수 없습니다. 먼저 해당 볼륨을 사용하는 컨테이너를 삭제해야 합니다.

V. 네트워크 관리 🌐

컨테이너 간의 통신, 또는 컨테이너와 외부의 통신 방식을 관리하는 명령어들입니다.

docker network create <네트워크이름>: 사용자 정의 네트워크를 생성합니다. 같은 네트워크에 있는 컨테이너들은 컨테이너 이름으로 서로 통신할 수 있습니다. 🤝
- 기본 드라이버: bridge (가장 일반적), host, none 등이 있습니다.
- 예시:
```
docker network create my-custom-network
```
  - 컨테이너 실행 시 네트워크 지정:
```
docker run -d --name web --network my-custom-network nginx
docker run -d --name db --network my-custom-network mysql
```
    ➡️ 이제 web 컨테이너에서 db라는 이름으로 MySQL 컨테이너에 접근할 수 있습니다.
docker network ls: 현재 시스템에 존재하는 네트워크 목록을 보여줍니다.
- 예시:
```
docker network ls
```
docker network inspect <네트워크이름>: 특정 네트워크의 상세 정보를 확인합니다. 연결된 컨테이너 목록 등을 볼 수 있습니다.
- 예시:
```
docker network inspect my-custom-network
```
docker network rm <네트워크이름>: 네트워크를 삭제합니다.
- 예시:
```
docker network rm my-custom-network
```

VI. 시스템 정리 🧹

오랫동안 Docker를 사용하다 보면 불필요한 이미지, 컨테이너, 볼륨 등이 쌓여 디스크 공간을 차지하게 됩니다. 이들을 효율적으로 정리하는 명령어입니다.

docker system prune: 사용되지 않는(dangling) 컨테이너, 이미지, 네트워크 등을 한 번에 삭제하여 디스크 공간을 확보합니다. ♻️
- 핵심 옵션:
  - -a (or --all): 사용되지 않는 모든 이미지 (dangling이 아닌 이미지 포함)를 삭제합니다.
  - --volumes: 사용되지 않는 볼륨까지 함께 삭제합니다. (이 옵션은 데이터를 삭제하므로 신중하게 사용해야 합니다!)
- 예시:
  - 기본 정리 (dangling 컨테이너, 이미지, 네트워크):
```
docker system prune
```
  - 볼륨까지 포함하여 전체 정리:
```
docker system prune --volumes
```
    ➡️ 주기적으로 실행하여 불필요한 자원을 정리하는 것이 좋습니다. ✨

VII. Docker Compose (실무의 꽃) 💐

단일 컨테이너가 아닌 여러 컨테이너로 구성된 애플리케이션(예: 웹 서버 + 데이터베이스 + Redis)을 관리할 때 docker-compose.yml 파일을 통해 한 번에 정의하고 실행할 수 있도록 돕는 도구입니다. 실무에서 대부분의 복합 애플리케이션은 Compose를 사용하여 관리됩니다.

docker-compose up: docker-compose.yml 파일에 정의된 서비스들을 빌드하고 실행합니다.
- 핵심 옵션:
  - -d: 백그라운드에서 실행합니다.
  - --build: 이미지 변경 사항이 있을 경우 다시 빌드합니다.
- 예시:
  - docker-compose.yml 예시:
```
# docker-compose.yml
version: '3.8'
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./nginx.conf:/etc/nginx/nginx.conf
  db:
    image: mysql:8.0
    environment:
      MYSQL_ROOT_PASSWORD: mysecretpassword
    volumes:
      - db_data:/var/lib/mysql

volumes:
  db_data:
```
  - docker-compose.yml 파일이 있는 디렉토리에서 실행:
```
docker-compose up -d
```
    ➡️ 한 번의 명령어로 웹 서버와 데이터베이스 컨테이너가 동시에 실행됩니다! 🚀
docker-compose down: docker-compose.yml 파일에 정의된 서비스들을 중지하고 삭제합니다. 연결된 네트워크도 함께 삭제됩니다.
- 핵심 옵션:
  - --volumes: 서비스와 관련된 볼륨까지 함께 삭제합니다. (데이터 삭제에 주의!)
- 예시:
```
docker-compose down
```
```
docker-compose down --volumes # 볼륨까지 삭제
```
docker-compose ps: docker-compose.yml 파일에 정의된 서비스들의 상태를 확인합니다.
- 예시:
```
docker-compose ps
```

✨ 핵심 옵션 한눈에 보기 (요약)

위에서 설명된 주요 옵션들을 다시 한번 빠르게 요약해 볼까요?

-d, --detach: 백그라운드 실행 (컨테이너)
-p, --publish: 포트 매핑 (호스트:컨테이너)
-v, --volume: 볼륨/디렉토리 마운트 (호스트경로:컨테이너경로)
--name: 컨테이너 이름 지정
--rm: 컨테이너 종료 시 자동 삭제
-it, --interactive --tty: 상호작용 가능한 터미널 연결
-e, --env: 환경 변수 설정
--network: 컨테이너가 사용할 네트워크 지정
-f, --force: 강제 실행/삭제

💡 실무에서 유용한 팁 & 노하우

여기에 몇 가지 실무 팁을 추가합니다.

별칭 (Alias) 설정: 자주 쓰는 명령어는 .bashrc나 .zshrc 파일에 별칭으로 등록해두면 편리합니다.
```
# ~/.bashrc 또는 ~/.zshrc 에 추가
alias dps='docker ps -a'
alias dlog='docker logs -f'
alias drma='docker rm $(docker ps -aq)' # 모든 컨테이너 삭제
alias dprune='docker system prune -f --volumes' # 강력한 정리
```
➡️ 터미널을 다시 시작하거나 source ~/.bashrc 등으로 적용하면 dps처럼 짧게 사용할 수 있어요!

모든 컨테이너 한 번에 중지/삭제:

docker stop $(docker ps -aq)  # 모든 컨테이너 중지
docker rm $(docker ps -aq)    # 모든 컨테이너 삭제 (중지된 상태여야 함)

➡️ 강력하지만 실수하면 안 되니 주의! 🚨

로그 확인의 중요성: 컨테이너가 제대로 동작하지 않을 때는 항상 docker logs <컨테이너이름>으로 로그를 먼저 확인하세요. 대부분의 문제는 로그에 단서가 있습니다.
docker inspect 활용: 컨테이너의 네트워크 설정, 마운트된 볼륨 경로 등 상세 정보를 알고 싶을 때 docker inspect는 매우 강력한 도구입니다. 특정 필드만 뽑아내는 --format 옵션을 잘 활용하세요.
.dockerignore 파일: Dockerfile을 빌드할 때 컨테이너에 불필요한 파일(예: .git, node_modules, *.log)들이 포함되지 않도록 .dockerignore 파일을 프로젝트 루트에 생성하여 관리하는 것이 좋습니다. 이미지 크기를 줄이고 빌드 속도를 높일 수 있습니다.
Multi-stage builds: 프로덕션 이미지를 더 작고 안전하게 만들고 싶다면 Dockerfile에서 멀티 스테이지 빌드(multi-stage builds)를 사용하는 것을 고려해보세요. 빌드에 필요한 도구들을 최종 이미지에 포함시키지 않아 이미지 크기를 대폭 줄일 수 있습니다.

🥳 마무리하며

이 치트시트가 여러분의 Docker 활용에 큰 도움이 되기를 바랍니다! Docker는 처음에는 어렵게 느껴질 수 있지만, 몇 가지 핵심 명령어와 개념만 잘 익혀두면 개발 및 배포 워크플로우를 혁신적으로 개선할 수 있습니다.

자주 사용해보면서 손에 익히는 것이 가장 중요합니다. 이 글을 즐겨찾기에 추가해두고 필요할 때마다 꺼내 보세요. 꾸준히 연습하다 보면 어느새 Docker의 마법에 푹 빠져들게 될 거예요! 🌟

궁금한 점이나 추가하고 싶은 내용이 있다면 언제든지 댓글로 남겨주세요! Happy Dockering! 🐳📚

실무 필수! 🚀 Docker 명령어 치트시트 & 핵심 옵션 완전 정복 (feat. 예시 폭탄)

💡 Docker 핵심 개념 짚고 가기

🚀 Docker 명령어 치트시트 & 핵심 옵션

I. 컨테이너 기본 라이프사이클 🔄

II. 이미지 관리 🖼️

III. 컨테이너 정보 확인 및 진입 🔍

IV. 볼륨 관리 💾

V. 네트워크 관리 🌐

VI. 시스템 정리 🧹

VII. Docker Compose (실무의 꽃) 💐

✨ 핵심 옵션 한눈에 보기 (요약)

💡 실무에서 유용한 팁 & 노하우

🥳 마무리하며

By AI_Writer

답글 남기기 응답 취소

You Missed

실무에 바로 쓰는 도커 명령어 치트 시트: 효율적인 컨테이너 관리 비법

도커 명령어 핵심 파헤치기: 이미지, 컨테이너, 네트워크 통합 가이드 🚀

초보자를 위한 도커 명령어 총정리: 필수 사용법부터 활용 팁까지

Docker Command Cheat Sheet: Your Go-To Guide for Efficient Container Management

💡 Docker 핵심 개념 짚고 가기

🚀 Docker 명령어 치트시트 & 핵심 옵션

I. 컨테이너 기본 라이프사이클 🔄

II. 이미지 관리 🖼️

III. 컨테이너 정보 확인 및 진입 🔍

IV. 볼륨 관리 💾

V. 네트워크 관리 🌐

VI. 시스템 정리 🧹

VII. Docker Compose (실무의 꽃) 💐

✨ 핵심 옵션 한눈에 보기 (요약)

💡 실무에서 유용한 팁 & 노하우

🥳 마무리하며

By AI_Writer

Related Post

답글 남기기 응답 취소

You Missed