Post

[Docker] Docker 설치 완벽 가이드

how to install aws

Posted Updated
Preview Image
By Kuandyk
4 min read
[Docker] Docker 설치 완벽 가이드

서론

도커(Docker)는 개발 환경을 구성하는 필수적인 도구입니다. 윈도우, WSL2, 우분투, 맥OS 등 다양한 환경에서 Docker를 설치하는 방법을 정리했습니다.

목차

  1. Windows
  2. WSL2
  3. Ubuntu 22.04
  4. macOS

Windows

WSL2 설치를 위한 사전 준비

Windows 설정 앱 → 제어판 → 프로그램 및 기능 → Windows 기능 켜기/끄기 → Linux용 Windows 하위 시스템

alt text

Ubuntu 22.04 설치

alt text

Docker 엔진 설치

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

# docker engine gpg 키 등록
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg

# Docker GPG 키 등록
sudo install -m 0755 -d /etc/apt/keyrings 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

# apt source 에 docker 관련 추가
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

sudo apt-get update

# docker engine 설치
sudo apt-get install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin docker-compose

# docker 그룹에 현재 계정을 등록하여 sudo 없이 docker 명령을 사용하게 함
sudo usermod -aG docker user
sudo service docker restart

새로운 터미널을 열고 확인

1
2
3
4
5

# docker version 확인
docker --version

# docker compose version 확인
docker-compose --version

Windows 에 Docker Desktop 설치

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

Windows Docker Desktop 설정

우측 상단 톱니바퀴 → 오른쪽 Resources → WSL Integration → Apply&Restart

alt text

WSL2

WSL2 환경에서는 Windows Docker Desktop의 WSL 통합 기능을 사용하는 것이 가장 편리합니다.

Ubuntu 22.04

위의 Windows 섹션의 Ubuntu 22.04 설치 과정을 참고하세요.

macOS

Homebrew를 이용한 Docker, Docker Compose 설치

https://brew.sh/ko

1
2
3

# 사전에 homebrew 설치 필요
# 커맨드 복사 및 붙여넣기
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

커맨드 복사 및 붙여넣기

1
2
3
4
5

# docker for mac설치
brew install docker

# docker compose 설치
brew install docker-compose

버전 확인

1
2
3
4
5

# docker version 확인
docker --version

# docker compose version 확인
docker-compose --version

macOS 특정 도구

https://subicura.com/mac/dev/apple-silicon.html#command-line-tools

Docker 공식 사이트에서 Docker Desktop 다운로드 및 설치

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

설치 완료 후 확인

Docker 실행 테스트

1
2
3
4
5
6
7
8

# hello world 컨테이너 실행
docker run hello-world

# 현재 실행 중인 컨테이너 확인
docker ps

# Docker 시스템 정보 확인
docker info

Docker Compose 테스트

1
2
3
4
5
6
7
8
9
10

# docker-compose.yml 생성
echo 'version: "3.8"
services:
  web:
    image: nginx:latest
    ports:
      - "80:80"' > docker-compose.yml

# 서비스 시작
docker-compose up -d

문제 해결

WSL2에서 Docker가 실행되지 않을 때

1
2
3
4
5

# WSL2 버전 확인
wsl --version

# Docker Desktop 설정 확인
# Windows Docker Desktop → Settings → WSL Integration

Linux에서 권한 문제

1
2
3
4
5

# docker 그룹에 사용자 추가
sudo usermod -aG $USER docker

# sudo 없이 docker 실행
newgrp docker

macOS에서 M1/M2 칩셋 아키텍처 문제

1
2

# Apple 실리콘용 Docker Desktop 설치
# 일반 intel 버전 대신 Apple Silicon 버전 사용

참고 자료

결론

이 가이드를 따라 하면 다음과 같이 할 수 있습니다:

  • 윈도우 환경에서 Docker 설치
  • WSL2를 통한 Linux 환경 설정
  • 우분투 서버에 Docker 설치
  • macOS에서 Docker 사용

Docker는 개발 환경을 표준화하고 일관성을 유지하는 강력한 도구입니다. 설치 후 다양한 프로젝트에서 사용해 보세요!

TIL
docker installation
This post is licensed under CC BY 4.0 by the author.