[Environmental setting] 12. Docker Install & Run

김미숙

Jul 30, 2025

[Environmental setting] 12. Docker Install & Run

Contents

Docker hub 회원가입 Docker 명령어 실행

💡

설치 문서

Windows

Get started with Docker for Windows. This guide covers system requirements, where to download, and instructions on how to install and update.

https://docs.docker.com/desktop/setup/install/windows-install/

참고 강의

AWS 1강 - 학습목표

메타코딩 전체 유료동영상 50프로 할인 이벤트 진행중입니다. 네이버 메타코딩 까페 회원가입 후 가입인사에 이메일 남겨주세요. https://cafe.naver.com/metacoding 유료 동영상 강의는 이지업 클래스에 업로드되어있습니다. https://easyupclass.e-itwill.com/

https://www.youtube.com/watch?v=UmuiQJEUcng&list=PL93mKxaRDidFjQjPAzi9UxCdo2gtR-fue

Docker hub 회원가입

도커 이미지 저장소(클라우드)

도커 이미지를 올리고 받을 수 있는 중앙 서버
깃허브가 코드 저장소라면 도커허브는 이미지 저장소

🎯 Docker Hub는 어떤 일을 할까?

기능	설명
🔍 이미지 검색	`mysql`, `nginx`, `php`, `node` 등 인기 이미지 검색 가능
⬇️ 이미지 다운로드(pull)	내 서버에 이미지 가져오기 → `docker pull mysql`
⬆️ 이미지 업로드(push)	내가 만든 이미지 업로드 가능 (로그인 필요)
🧑‍💻 공유/협업	다른 사람과 이미지 공유 (Public/Private 설정 가능)

📦 용어 정리 먼저

용어	의미
Docker	앱, 환경, 의존성을 하나로 감싼 컨테이너 플랫폼
Image	컨테이너의 설계도 (앱+환경 포함)
Container	이미지를 실행한 실제 인스턴스
Docker Hub	이미지들을 올리고 공유하는 중앙 저장소 (레지스트리)

Docker Hub Container Image Library | App Containerization

Welcome to the world's largest container registry built for developers and open source contributors to find, use, and share their container images. Build, push and pull.

https://hub.docker.com/

Docker

❗

Windows 10이면 HyperV + 가상 머신 플랫폼 설치 필요

Windows 11부터는 WSL 권장

Docker Desktop: The #1 Containerization Tool for Developers | Docker

Docker Desktop is collaborative containerization software for developers. Get started and download Docker Desktop today on Mac, Windows, or Linux.

https://www.docker.com/products/docker-desktop/

Docker Desktop: The #1 Containerization Tool for Developers | Docker

→ 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가 없습니다.)

→ Windows 11 이상이면 HyperV 체크하고 재부팅 진행 (둘 다 상관없음)

실행 확인

요약:

Windows 10 Pro 이상: Hyper-V 또는 WSL 2 (WSL 2 권장)

Windows 10 Home: 반드시 WSL 2

Windows 11 (Home 포함 모든 버전): WSL 2 (권장)

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 최신버전인지 확인하기

명령어 실행

도커 이미지(ubuntu)를 다운로드(pull)하는 명령어


docker pull ubuntu

도커 클라이언트가 Docker Hub에 요청함

기본 레지스트리: https://hub.docker.com/_/ubuntu

최신 우분투 이미지(ubuntu:latest)를 로컬로 다운로드

내부적으로는 ubuntu:latest == ubuntu:<최신 버전> (ex: 22.04)

이미지 다운로드 완료 후, docker images 명령어로 확인 가능


docker images

Ubuntu 컨테이너를 실행하고, 그 안에 bash 쉘로 들어가는 명령어

빠져나올 땐 exit


docker run -it ubuntu bash

현재 실행 중(RUNNING)인 컨테이너 목록을 확인하는 명령어


docker ps

컬럼	설명
`CONTAINER ID`	컨테이너의 고유 ID
`IMAGE`	실행 중인 컨테이너가 사용한 이미지 이름
`COMMAND`	컨테이너가 실행 중인 명령어 (예: `bash`)
`CREATED`	컨테이너가 생성된 시간
`STATUS`	현재 상태 (Up = 실행 중, Exited = 종료)
`PORTS`	연결된 포트 (포트포워딩 설정 시 표시)
`NAMES`	컨테이너 이름 (자동 생성되거나 수동 지정)

자주 쓰는 옵션

docker ps -a

→ 모든 컨테이너 목록을 보여줌 (실행 중 + 종료된 컨테이너 모두)

docker ps -q

→ 컨테이너 ID만 출력

Docker hub에서 tomcat 다운로드

Docker에서 Tomcat 9.0 이미지를 실행하는 명령어


docker run -dit --rm tomcat:9.0


docker ps

Contents

Docker hub 회원가입 Docker 명령어 실행

Environmental setting

[Environmental setting] 12. Docker Install & Run

김미숙

Jul 30, 2025

Contents

Docker hub 회원가입 Docker 명령어 실행

💡

설치 문서

Windows

Get started with Docker for Windows. This guide covers system requirements, where to download, and instructions on how to install and update.

https://docs.docker.com/desktop/setup/install/windows-install/

참고 강의

AWS 1강 - 학습목표

https://www.youtube.com/watch?v=UmuiQJEUcng&list=PL93mKxaRDidFjQjPAzi9UxCdo2gtR-fue

Docker hub 회원가입

도커 이미지 저장소(클라우드)

도커 이미지를 올리고 받을 수 있는 중앙 서버
깃허브가 코드 저장소라면 도커허브는 이미지 저장소

🎯 Docker Hub는 어떤 일을 할까?

기능	설명
🔍 이미지 검색	`mysql`, `nginx`, `php`, `node` 등 인기 이미지 검색 가능
⬇️ 이미지 다운로드(pull)	내 서버에 이미지 가져오기 → `docker pull mysql`
⬆️ 이미지 업로드(push)	내가 만든 이미지 업로드 가능 (로그인 필요)
🧑‍💻 공유/협업	다른 사람과 이미지 공유 (Public/Private 설정 가능)

📦 용어 정리 먼저

용어	의미
Docker	앱, 환경, 의존성을 하나로 감싼 컨테이너 플랫폼
Image	컨테이너의 설계도 (앱+환경 포함)
Container	이미지를 실행한 실제 인스턴스
Docker Hub	이미지들을 올리고 공유하는 중앙 저장소 (레지스트리)

Docker Hub Container Image Library | App Containerization

Welcome to the world's largest container registry built for developers and open source contributors to find, use, and share their container images. Build, push and pull.

https://hub.docker.com/

Docker

❗

Windows 10이면 HyperV + 가상 머신 플랫폼 설치 필요

Windows 11부터는 WSL 권장

Docker Desktop: The #1 Containerization Tool for Developers | Docker

Docker Desktop is collaborative containerization software for developers. Get started and download Docker Desktop today on Mac, Windows, or Linux.

https://www.docker.com/products/docker-desktop/

→ Windows 다운로드 시 AMD64인지 ARM64인지 확인하고 다운로드 진행

→ 리눅스 하위 시스템 (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가 없습니다.)

→ Windows 11 이상이면 HyperV 체크하고 재부팅 진행 (둘 다 상관없음)

실행 확인

요약:

Windows 10 Pro 이상: Hyper-V 또는 WSL 2 (WSL 2 권장)

Windows 10 Home: 반드시 WSL 2

Windows 11 (Home 포함 모든 버전): WSL 2 (권장)

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 최신버전인지 확인하기

명령어 실행

도커 이미지(ubuntu)를 다운로드(pull)하는 명령어


docker pull ubuntu

도커 클라이언트가 Docker Hub에 요청함

기본 레지스트리: https://hub.docker.com/_/ubuntu

최신 우분투 이미지(ubuntu:latest)를 로컬로 다운로드

내부적으로는 ubuntu:latest == ubuntu:<최신 버전> (ex: 22.04)

이미지 다운로드 완료 후, docker images 명령어로 확인 가능


docker images

Ubuntu 컨테이너를 실행하고, 그 안에 bash 쉘로 들어가는 명령어

빠져나올 땐 exit


docker run -it ubuntu bash

현재 실행 중(RUNNING)인 컨테이너 목록을 확인하는 명령어


docker ps

컬럼	설명
`CONTAINER ID`	컨테이너의 고유 ID
`IMAGE`	실행 중인 컨테이너가 사용한 이미지 이름
`COMMAND`	컨테이너가 실행 중인 명령어 (예: `bash`)
`CREATED`	컨테이너가 생성된 시간
`STATUS`	현재 상태 (Up = 실행 중, Exited = 종료)
`PORTS`	연결된 포트 (포트포워딩 설정 시 표시)
`NAMES`	컨테이너 이름 (자동 생성되거나 수동 지정)

자주 쓰는 옵션

docker ps -a

→ 모든 컨테이너 목록을 보여줌 (실행 중 + 종료된 컨테이너 모두)

docker ps -q

→ 컨테이너 ID만 출력

Docker hub에서 tomcat 다운로드

Docker에서 Tomcat 9.0 이미지를 실행하는 명령어


docker run -dit --rm tomcat:9.0


docker ps

Contents

Docker hub 회원가입 Docker 명령어 실행