docker-local-setup
가이드 목록

로컬 Docker 환경 구축

입문20분

Docker는 애플리케이션을 컨테이너로 패키징하여 어디서든 동일하게 실행할 수 있게 해주는 플랫폼입니다. 이 가이드에서는 로컬 환경에 Docker를 설치하고 기본 명령어를 실습합니다.

Docker는 컨테이너 기반 실습 코스(ECS, Fargate, Kubernetes)의 사전 요구사항입니다. 해당 코스를 수강하기 전에 반드시 로컬 Docker 환경을 구축해 주세요.

Docker Desktop 설치

코드
# Homebrew를 사용한 설치
brew install --cask docker
# 설치 후 Applications에서 Docker Desktop 실행

Windows 사전 요구사항: Docker Desktop은 WSL 2 (Windows Subsystem for Linux 2) 가 필요합니다.

WSL 2가 설치되지 않았다면 먼저 PowerShell(관리자)에서 실행하세요:

코드
wsl --install

설치 후 PC를 재시작해야 합니다. 재시작 후 Docker Desktop을 설치하세요.

코드
# https://www.docker.com/products/docker-desktop/ 에서 다운로드
# Docker Desktop Installer.exe 실행
# WSL 2 백엔드 사용 옵션 체크 (권장) → 설치 완료 후 재부팅
코드
# Ubuntu/Debian
sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-compose-plugin
sudo usermod -aG docker $USER

sudo usermod -aG docker $USER 실행 후 반드시 로그아웃 후 다시 로그인해야 그룹 변경이 적용됩니다. 로그아웃하지 않으면 docker 명령 실행 시 권한 오류가 발생합니다.

코드
# 현재 세션에 즉시 적용하려면:
newgrp docker
# 또는 완전한 로그아웃/로그인 권장

설치 확인

코드
# Docker 버전 확인
docker --version
 
# hello-world 컨테이너 실행으로 정상 동작 확인
docker run hello-world
# "Hello from Docker!" 메시지가 출력되면 성공

기본 명령어

코드
docker pull nginx:latest                              # 이미지 다운로드
docker run -d -p 8080:80 --name my-nginx nginx:latest # 컨테이너 실행
docker ps                                             # 실행 중인 컨테이너 목록
docker stop my-nginx                                  # 컨테이너 중지
docker rm my-nginx                                    # 컨테이너 삭제
docker images                                         # 로컬 이미지 목록
docker rmi nginx:latest                               # 이미지 삭제

Docker Compose 설치 확인

Docker Compose는 여러 컨테이너를 동시에 실행하는 도구이며, Docker Desktop에 기본 포함되어 있습니다.

코드
docker compose version

실습 환경 테스트

진행률 0/4
  1. 1터미널에서 docker run -d -p 8080:80 --name test-nginx nginx:latest 실행
  2. 2브라우저에서 http://localhost:8080 접속
  3. 3Welcome to nginx! 페이지가 표시되면 성공
  4. 4테스트 완료 후 정리: docker stop test-nginx && docker rm test-nginx

Docker Desktop의 Dashboard에서 실행 중인 컨테이너를 GUI로 관리할 수 있습니다. 로그 확인, 터미널 접속, 리소스 모니터링 등을 시각적으로 수행할 수 있어 초보자에게 유용합니다.