Skip to content

installation.md

Latest commit

 

History

History
198 lines (145 loc) · 7.61 KB

installation.md

File metadata and controls

198 lines (145 loc) · 7.61 KB
Raw

Docker 설치 가이드 (Docker Installation Guide)

이 가이드는 Linux (다양한 배포판), Windows, macOS 환경에서 Docker를 설치하고 설정하는 상세한 방법을 다룹니다.

적용 범위와 검증 기준

  • 범위: 설치 명령은 OS·배포판·release·architecture와 Docker Engine/Desktop·Compose 버전에 종속됩니다. 실행 전 Docker 공식 문서의 현재 repository와 지원 범위를 대조합니다.
  • 환경 전제: 기존 package와 data root, virtualization, WSL, proxy, firewall, cgroup, rootful·rootless 방식과 조직 보안 정책을 확인합니다.
  • 불확실성: 설치 script의 지원 배포판, RAM 요구량과 성능 비교는 시점·workload·hardware에 따라 달라지며 보편 권장값이 아닙니다.
  • 실패·완료: package 충돌, signature·repository 오류, daemon 실패, 권한 과다와 기존 image·volume 손실을 점검합니다. version, daemon 정보, test container, network, volume과 reboot 후 동작까지 확인해야 완료입니다.

1. Linux 설치 가이드

Linux에서는 대상 배포판이 지원하는 repository 또는 Docker 공식 repository 중 조직의 update·support 정책에 맞는 경로를 선택합니다. 기존 package 제거는 이름과 data 호환성을 확인한 뒤 충돌이 실제로 있는 경우에만 수행합니다.

사전 준비: 오래된 버전 제거 (공통)

# Ubuntu/Debian
sudo apt-get remove docker docker-engine docker.io containerd runc

# CentOS/RHEL/Rocky
sudo yum remove docker \
                  docker-client \
                  docker-client-latest \
                  docker-common \
                  docker-latest \
                  docker-latest-logrotate \
                  docker-logrotate \
                  docker-engine

A. 자동 설치 스크립트 (개발·검증 환경용 예시)

편의 script의 지원 배포판과 동작은 시점에 따라 바뀝니다. 내용을 검토하고 version을 고정한 비프로덕션 환경에서 사용하며, 가장 빠른 설치 경로인지도 network와 image 상태에 따라 달라집니다.

curl -fsSL https://get.docker.com -o get-docker.sh
sudo sh get-docker.sh

B. 배포판별 수동 설치

1. Ubuntu / Debian 계열 (apt)

  1. 필수 패키지 설치 및 GPG 키 추가

    sudo apt-get update
sudo apt-get install ca-certificates curl gnupg

# GPG 키 저장 디렉토리 생성
sudo install -m 0755 -d /etc/apt/keyrings
# Docker 공식 GPG 키 다운로드
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

  2. 리포지토리 설정

    # Ubuntu의 경우
echo \
  "deb [arch="$(dpkg --print-architecture)" signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  "$(. /etc/os-release && echo "$VERSION_CODENAME")" stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Debian의 경우 위 URL의 ubuntu를 debian으로 변경

  3. Docker 엔진 설치

    sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

2. CentOS / RHEL / Rocky Linux / Fedora (yum/dnf)

  1. 리포지토리 설정

    sudo yum install -y yum-utils
sudo yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo

  2. Docker 엔진 설치

    sudo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

  3. 서비스 시작

    sudo systemctl start docker
sudo systemctl enable docker

3. Arch Linux / Manjaro (pacman)

Arch Linux는 공식 리포지토리에서 Docker를 지원합니다.

sudo pacman -Syu
sudo pacman -S docker docker-compose

C. Linux 설치 후 필수 설정 (Root 권한 없이 실행하기)

기본적으로 Docker 명령어는 sudo가 필요합니다. 매번 입력하지 않으려면 사용자를 docker 그룹에 추가해야 합니다.

# 1. docker 그룹 생성 (이미 존재할 수 있음)
sudo groupadd docker

# 2. 현재 사용자를 docker 그룹에 추가
sudo usermod -aG docker $USER

# 3. 변경 사항 적용 (로그아웃 후 재로그인하거나 아래 명령어 실행)
newgrp docker

2. Windows 설치 가이드 (Docker Desktop)

Windows의 WSL 2 backend는 일반적인 Linux-container 개발에 유리할 수 있지만, Hyper-V 선택과 성능은 Windows edition, filesystem 경로, virtualization 정책과 workload로 판단합니다.

시스템 요구사항

  • Windows 10 버전 2004 이상 (Build 19041 이상) 또는 Windows 11.
  • BIOS에서 가상화(Virtualization) 기능 활성화 필요.

설치 단계

  1. WSL 2 활성화: PowerShell(관리자 권한)에서 아래 명령어를 실행하여 WSL을 설치 및 업데이트합니다.

    wsl --install

    안내: 이미 설치되어 있다면 wsl --update로 최신 커널로 업데이트하세요.

  2. Docker Desktop 다운로드: Docker Hub Windows 다운로드 페이지에서 설치 파일을 다운로드합니다.

  3. 설치 및 실행:

    • 설치 마법사에서 "Use WSL 2 instead of Hyper-V" 옵션이 체크되어 있는지 확인합니다(권장).
    • 설치 완료 후 재부팅이 필요할 수 있습니다.
    • Docker Desktop을 실행하고 라이선스 동의를 진행합니다.

  4. 설정 (Optional):

    • Docker Desktop 설정 > Resources > WSL Integration 에서 Docker를 사용할 WSL 배포판(예: Ubuntu)을 스위치를 켜서 연동합니다. 이렇게 하면 WSL 터미널 내부에서도 docker 명령어를 바로 사용할 수 있습니다.

3. macOS 설치 가이드 (Docker Desktop)

시스템 요구사항

  • macOS 버전 12 (Monterey) 이상 권장.
  • 메모리 요구량은 Docker Desktop 버전, 동시 container와 workload에 따라 산정합니다. 4GB는 일부 구성의 예시일 뿐입니다.

설치 단계

  1. Docker Desktop 다운로드: Docker Hub Mac 다운로드 페이지로 이동합니다.

    • Mac with Apple silicon: M1, M2, M3 등 Apple 칩셋 사용자.
    • Mac with Intel chip: 구형 Intel 맥 사용자.
    • 본인의 칩셋에 맞는 버전을 선택하여 다운로드하세요.

  2. 설치:

    • 다운로드한 .dmg 파일을 엽니다.
    • Docker 아이콘을 Applications 폴더로 드래그합니다.

  3. 실행:

    • Applications 폴더에서 Docker를 실행합니다.
    • 초기 설정 시 권한 부여(네트워킹 등)가 필요할 수 있습니다.

  4. 터미널 확인:

    • 터미널 앱을 열고 docker --version을 입력하여 설치를 확인합니다.

4. 설치 검증 (Hello World)

설치가 완료되었다면 터미널(또는 CMD/PowerShell)을 열고 다음 명령어를 실행하여 정상 작동을 확인합니다.

docker run --rm hello-world

성공 시 출력 예시:

Hello from Docker!
This message shows that your installation appears to be working correctly.
...

5. Docker Compose 사용 참조

최신 Docker를 설치했다면 docker-compose (하이픈 있음) 대신 docker compose (공백, V2 플러그인) 명령어를 사용하는 것이 표준입니다.

docker compose version

문서 작성일: 2026-01-29