[Environmental setting] 12. Docker Install & Run

김미숙's avatar
Jul 30, 2025
[Environmental setting] 12. Docker Install & Run
 

Docker hub 회원가입

  • 도커 이미지 저장소(클라우드)
    • 도커 이미지를 올리고 받을 수 있는 중앙 서버
    • 깃허브가 코드 저장소라면 도커허브는 이미지 저장소
      • 🎯 Docker Hub는 어떤 일을 할까?
        기능
        설명
        🔍 이미지 검색
        mysql, nginx, php, node 등 인기 이미지 검색 가능
        ⬇️ 이미지 다운로드(pull)
        내 서버에 이미지 가져오기 → docker pull mysql
        ⬆️ 이미지 업로드(push)
        내가 만든 이미지 업로드 가능 (로그인 필요)
        🧑‍💻 공유/협업
        다른 사람과 이미지 공유 (Public/Private 설정 가능)
        📦 용어 정리 먼저
        용어
        의미
        Docker
        앱, 환경, 의존성을 하나로 감싼 컨테이너 플랫폼
        Image
        컨테이너의 설계도 (앱+환경 포함)
        Container
        이미지를 실행한 실제 인스턴스
        Docker Hub
        이미지들을 올리고 공유하는 중앙 저장소 (레지스트리)
notion image
 

Docker

Windows 10이면 HyperV + 가상 머신 플랫폼 설치 필요
Windows 11부터는 WSL 권장
notion image
→ Windows 다운로드 시 AMD64인지 ARM64인지 확인하고 다운로드 진행
→ 램 최소 16GB 필요 / Mac 이면 가장 좋음 (신경쓸 게 없다 - Mac 이 Linux 기반이라서) / Windows는 Linux 기반이기 때문에 Linux인척 해야하는데 HyperV와 리눅스 하위시스템 둘 중 하나를 설치해야한다 (가상화기술)
→ 리눅스 하위 시스템 (WSL2)
  • 역할: WSL 2(Windows Subsystem for Linux 2)는 Windows 10 버전 2004 이상 또는 Windows 11에서 사용할 수 있는, 리눅스 커널을 포함하는 가상화 기술입니다. Docker Desktop은 이 WSL 2를 사용하여 리눅스 VM을 실행하고 도커 엔진을 구동하는 것을 권장합니다. Hyper-V보다 더 빠르고 효율적인 리눅스 커널 통합을 제공하기 때문입니다.
  • 조건:
    • Windows 10 버전 2004 이상 (빌드 19041 이상)
    • Windows 11 홈 버전 이상
    • 중요: Windows 10 Home 버전에서는 Hyper-V를 사용할 수 없기 때문에, Docker Desktop을 설치하려면 반드시 WSL 2를 사용해야 합니다. Windows 10 Pro 이상에서는 Hyper-V와 WSL 2 중 선택하여 사용할 수 있지만, 성능상 WSL 2가 권장됩니다.
→ HyperV 설치
  • 역할: Hyper-V는 Microsoft의 가상화 기술입니다. Docker Desktop은 이 Hyper-V 위에 경량의 리눅스 가상 머신(VM)을 생성하여 도커 엔진을 구동합니다. 이 VM이 Windows에서 리눅스 컨테이너를 실행할 수 있도록 '리눅스인 척'하는 기반 환경을 제공합니다.
  • 조건: Windows 10 Pro, Enterprise, Education 버전 이상에서만 기본적으로 지원됩니다. (Home 버전은 Hyper-V가 없습니다.)
notion image
→ Windows 11 이상이면 HyperV 체크하고 재부팅 진행 (둘 다 상관없음)
notion image

실행 확인

notion image
 
요약:
  • Windows 10 Pro 이상: Hyper-V 또는 WSL 2 (WSL 2 권장)
  • Windows 10 Home: 반드시 WSL 2
  • Windows 11 (Home 포함 모든 버전): WSL 2 (권장)
notion image
  • Hyper-V: Windows에서 리눅스 컨테이너를 실행하기 위해, Docker Desktop은 Hyper-V를 사용하여 Windows 위에 작은 리눅스 가상 머신을 만들고, 그 가상 머신 안에서 도커 엔진을 실행합니다. 이 리눅스 VM이 '리눅스인 척'하며 컨테이너를 구동하는 기반을 제공합니다.
  • WSL 2: WSL 2는 Hyper-V 위에 구축된 더 효율적인 리눅스 환경입니다. Docker Desktop은 WSL 2를 백엔드로 사용함으로써, 더 빠르고 가벼우며 Windows와 더 잘 통합된 환경에서 도커 컨테이너를 실행할 수 있게 됩니다. 특히 Windows Home 버전에서는 Hyper-V가 없으므로, Docker Desktop을 사용하려면 WSL 2가 필수적입니다.
 

Tip 도커 실행이 안되면

WSL 최신버전인지 확인하기
notion image
 

명령어 실행

  • 도커 이미지(ubuntu)를 다운로드(pull)하는 명령어
    • docker pull ubuntu
      notion image
      1. 도커 클라이언트가 Docker Hub에 요청
          • 기본 레지스트리: https://hub.docker.com/_/ubuntu
      1. 최신 우분투 이미지(ubuntu:latest)를 로컬로 다운로드
          • 내부적으로는 ubuntu:latest == ubuntu:<최신 버전> (ex: 22.04)
      1. 이미지 다운로드 완료 후, docker images 명령어로 확인 가능
        1. docker images
          notion image
  • Ubuntu 컨테이너를 실행하고, 그 안에 bash 쉘로 들어가는 명령어
    • 빠져나올 땐 exit
    • docker run -it ubuntu bash
      notion image
  • 현재 실행 중(RUNNING)인 컨테이너 목록을 확인하는 명령어
    • docker ps
      notion image
      컬럼
      설명
      CONTAINER ID
      컨테이너의 고유 ID
      IMAGE
      실행 중인 컨테이너가 사용한 이미지 이름
      COMMAND
      컨테이너가 실행 중인 명령어 (예: bash)
      CREATED
      컨테이너가 생성된 시간
      STATUS
      현재 상태 (Up = 실행 중, Exited = 종료)
      PORTS
      연결된 포트 (포트포워딩 설정 시 표시)
      NAMES
      컨테이너 이름 (자동 생성되거나 수동 지정)
      자주 쓰는 옵션
    • docker ps -a
      • 모든 컨테이너 목록을 보여줌 (실행 중 + 종료된 컨테이너 모두)
    • docker ps -q
      • → 컨테이너 ID만 출력
 
  • Docker hub에서 tomcat 다운로드
    • notion image
      notion image
  • Docker에서 Tomcat 9.0 이미지를 실행하는 명령어
    • docker run -dit --rm tomcat:9.0
      notion image
      docker ps
      notion image
Share article

parangdajavous