DSA Docs Docker & AWS 수업 자료
로그인

Part 1. Docker 기본 과정

Docker 설치 및 설정

학습 목표

  • 자신의 운영 환경(Windows / macOS)에 Docker Desktop을 설치할 수 있다.

  • 설치 후 정상 동작 여부를 명령어로 확인할 수 있다.

1. Windows 설치

1-1. WSL2 설치 및 설정

Docker Desktop for Windows는 내부적으로 WSL2(Windows Subsystem for Linux 2) 를 사용한다. 먼저 WSL2를 설치해야 한다.

  1. PowerShell을 관리자 권한으로 실행한 뒤 아래 명령어를 입력한다.

    wsl --install

    설치 완료 후 PC를 재부팅한다.

  2. 기본 버전을 WSL2로 설정한다.

    wsl --set-default-version 2

  3. WSL을 최신 버전으로 갱신한다.

    wsl --update
wsl --version

    Docker Desktop은 WSL 2.1.5 이상을 요구한다. wsl --version 출력의 첫 줄에서 버전을 확인한다.

1-2. Docker Desktop 설치

  1. Docker Desktop for Windows 공식 페이지에서 설치 파일을 내려받아 실행한다.

  2. 설치 완료 후 Docker Desktop을 실행하고, Settings → Resources → WSL Integration에서 사용할 WSL 배포판을 활성화한다.

WSL Integration 설정 방법: Docker Desktop 상단 메뉴 톱니바퀴(⚙️) 아이콘 → Resources → WSL Integration → 사용할 Linux 배포판 토글 ON → Apply & Restart 클릭

Settings → Resources → WSL integration

Settings → Resources → WSL integration

배포판 목록이 비어 있다면 위 화면처럼 You don't have any WSL 2 distros installed 메시지만 보인다. WSL 2 배포판이 하나도 없다는 뜻이므로 1-1로 돌아가 wsl --install -d Ubuntu 로 배포판을 먼저 설치한다. 설치 후 이 화면에서 Refetch distros 를 누르면 목록에 나타나고, 그때 토글을 켤 수 있다.

배포판을 따로 쓰지 않고 기본 배포판만 쓸 거라면 Enable integration with my default WSL distro 하나만 켜도 된다.

1-3. 설치 확인

PowerShell 또는 WSL 터미널에서 아래 명령어를 실행한다.

# Docker 버전 확인
docker --version

# Docker 엔진 정상 동작 확인 (Hello World 컨테이너 실행)
docker run hello-world

Hello from Docker! 메시지가 출력되면 정상적으로 설치된 것이다.

2. macOS 설치

2-1. Docker Desktop 설치

  1. Docker Desktop for Mac 공식 페이지에서 칩셋에 맞는 설치 파일을 내려받는다.

    • Apple Silicon (M 시리즈): Apple silicon 버전

    • Intel Mac: Intel chip 버전

  2. 내려받은 .dmg 파일을 열고 Docker 아이콘을 Applications 폴더로 드래그한다.

  3. Docker Desktop을 실행하면 메뉴 바에 고래 아이콘이 표시된다.

칩셋별 Docker Desktop for Mac 내려받기

공식 설치 문서의 칩셋별 내려받기 링크

칩셋을 잘못 고르면 설치는 되지만 성능이 크게 떨어지거나 실행되지 않는다. 터미널에서 uname -m 을 실행해 arm64 가 나오면 Apple Silicon, x86_64 가 나오면 Intel 판을 받는다.

2-2. 설치 확인

docker --version
docker run hello-world

3. 리눅스 호스트

이 장은 학습용 개발 PC를 전제로 하므로 Docker Desktop만 다룬다. 서버(EC2 등) 리눅스에 Docker Engine 을 직접 설치하는 절차는 배포판마다 다르고 저장소 주소·패키지 이름이 자주 바뀌므로, Docker 공식 설치 문서를 참고한다.

Amazon Linux 2023 에 설치하는 절차는 EC2에 Docker로 배포하기에서 실제로 다룬다. 설치 후 sudo 없이 쓰려면 Docker 환경 설정의 docker 그룹 설정을 참고한다.

Windows에서 Docker 이미지 저장 경로(WSL 가상 디스크)를 다른 드라이브로 옮기는 방법은 Docker 환경 설정 문서를 참고한다.

마지막 수정 2026년 10월 22일