Docker와 Docker Compose 설치 방법: 초보자도 쉽게 따라 하는 가이드

안녕하세요! 오늘은 개발자라면 꼭 알아야 할 도구, Docker와 Docker Compose 설치 방법에 대해 자세히 알아볼게요.

Docker는 컨테이너 기술을 활용해 애플리케이션을 쉽게 배포하고 관리할 수 있게 해주는 도구예요. Docker Compose는 여러 컨테이너를 한 번에 관리할 수 있게 도와주는 유용한 도구고요. 이 두 가지를 설치하면 개발 환경 설정이 훨씬 간편해진답니다. 초보자도 쉽게 따라 할 수 있도록 Ubuntu 환경을 기준으로, apt-get 명령어를 사용해 단계별로 설명드릴게요. Windows나 macOS 사용자도 비슷한 방식으로 진행할 수 있으니 참고해주세요! 지금부터 Docker와 Docker Compose 설치 방법, 함께 시작해볼까요?

---

1. Docker란? Docker Compose란?

Docker

먼저 Docker와 Docker Compose가 무엇인지 간단히 알아볼게요.

• Docker: 컨테이너 기반 가상화 플랫폼이에요. 애플리케이션과 그 실행 환경(라이브러리, 의존성 등)을 컨테이너라는 단위로 묶어 어디서나 동일하게 실행할 수 있게 해줘요. 예를 들어, 개발 환경과 배포 환경이 달라서 생기는 문제를 해결할 수 있죠.
• Docker Compose: 여러 컨테이너를 정의하고 실행할 수 있는 도구예요. YAML 파일을 사용해 컨테이너 설정을 관리하며, 복잡한 멀티 컨테이너 환경을 쉽게 구성할 수 있어요. 예를 들어, 웹 서버, 데이터베이스, 캐시 서버를 한 번에 띄울 때 유용해요.

이제 본격적으로 설치 방법을 알아볼게요!

---

2. Docker 설치 방법 (Ubuntu 기준)

Ubuntu 20.04 또는 22.04를 기준으로 Docker를 설치하는 방법을 단계별로 설명드릴게요. 다른 리눅스 배포판이나 Windows/macOS에서도 비슷한 방식으로 진행할 수 있어요. 여기서는 apt-get 명령어를 사용해 설치 과정을 진행합니다.

2.1. 시스템 업데이트

먼저 시스템 패키지를 최신 상태로 업데이트해요. 터미널을 열고 다음 명령어를 실행하세요.

sudo apt-get update && sudo apt-get upgrade -y

 

2.2. 필수 패키지 설치

Docker 설치를 위해 필요한 패키지를 설치해요.

sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common

2.3. Docker 공식 GPG 키 추가

Docker의 공식 저장소를 사용하기 위해 GPG 키를 추가해요.

curl -fsSL <https://download.docker.com/linux/ubuntu/gpg> | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg

2.4. Docker 저장소 추가

Docker 저장소를 시스템에 추가해요.

echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/docker-archive-keyring.gpg] <https://download.docker.com/linux/ubuntu> $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

2.5. Docker 설치

저장소를 추가한 후, 다시 패키지 목록을 업데이트하고 Docker를 설치해요.

sudo apt-get update
sudo apt-get install -y docker-ce docker-ce-cli containerd.io

2.6. Docker 서비스 시작 및 활성화

Docker 서비스를 시작하고, 부팅 시 자동으로 실행되도록 설정해요.

sudo systemctl start docker
sudo systemctl enable docker

2.7. 설치 확인

Docker가 잘 설치되었는지 확인하기 위해 버전을 확인해봐요.

docker --version

출력 예시: Docker version 24.0.7, build afdd53b

2.8. 일반 사용자로 Docker 실행 권한 부여 (선택)

루트 권한 없이 Docker를 실행하려면 현재 사용자를 Docker 그룹에 추가해요.

sudo usermod -aG docker $USER

이후 로그아웃 후 다시 로그인하거나, 새 터미널을 열어 권한을 적용하세요.

2.9. 테스트: Hello World 컨테이너 실행

Docker가 제대로 작동하는지 확인하기 위해 테스트 컨테이너를 실행해봐요.

docker run hello-world

"Hello from Docker!" 메시지가 출력되면 설치가 성공적으로 완료된 거예요!

---

3. Docker Compose 설치 방법

Docker가 설치되었다면, 이제 Docker Compose를 설치할 차례예요. Docker Compose는 별도로 설치해야 하는 도구로, 멀티 컨테이너 환경을 쉽게 관리할 수 있어요.

3.1. Docker Compose 바이너리 다운로드

Docker Compose의 최신 버전을 다운로드해요. 2025년 3월 기준으로 최신 버전은 2.24.7이에요. 버전은 변경될 수 있으니 Docker Compose 공식 GitHub 페이지에서 확인하세요:

sudo curl -L "<https://github.com/docker/compose/releases/download/v2.24.7/docker-compose-$>(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

3.2. 실행 권한 부여

다운로드한 파일에 실행 권한을 부여해요:

sudo chmod +x /usr/local/bin/docker-compose

3.3. 설치 확인

Docker Compose가 잘 설치되었는지 버전을 확인해봐요.

docker-compose --version

출력 예시: Docker Compose version v2.24.7

3.4. 테스트: 간단한 Docker Compose 파일 실행

Docker Compose가 잘 작동하는지 확인하기 위해 간단한 예제를 실행해볼게요. 먼저, docker-compose.yml 파일을 생성해요.

mkdir test-compose
cd test-compose
nano docker-compose.yml

다음 내용을 docker-compose.yml 파일에 붙여넣어요.

version: '3'
services:
  web:
    image: nginx:latest
    ports:
      - "8080:80"

파일을 저장하고 닫은 후, 다음 명령어로 실행해요.

docker-compose up -d

브라우저에서 http://localhost:8080에 접속하면 Nginx 환영 페이지가 표시되면 성공이에요! 실행이 끝나면 컨테이너를 종료해요.

docker-compose down

---

4. Windows/macOS에서 설치하기 (간단 요약)

Ubuntu 외의 환경에서도 Docker와 Docker Compose를 설치할 수 있어요.

• Windows: Docker Desktop을 다운로드해 설치하면 Docker와 Docker Compose가 함께 설치돼요. Docker 공식 사이트에서 다운로드하세요.
• macOS: 마찬가지로 Docker Desktop을 설치하면 됩니다. 설치 후 터미널에서 docker와 docker-compose 명령어를 바로 사용할 수 있어요.

Docker Desktop은 GUI 환경도 제공해서 초보자에게 더 편리할 수 있어요.

---

5. 설치 후 다음 단계는?

Docker와 Docker Compose 설치가 완료되었다면, 이제 본격적으로 컨테이너를 활용해볼 차례예요! 예를 들어, 웹 서버와 데이터베이스를 함께 띄우는 Docker Compose 파일을 작성하거나, 기존 프로젝트를 컨테이너화해볼 수 있어요. Docker Hub에서 다양한 이미지를 검색해 활용하는 것도 추천드려요.

---

결론: Docker와 Docker Compose로 개발 환경 혁신

오늘은 apt-get 명령어를 사용해 Docker와 Docker Compose 설치 방법을 Ubuntu를 기준으로 자세히 알아봤어요. 단계별로 따라 하다 보면 초보자도 쉽게 설치할 수 있죠. Docker를 활용하면 개발 환경 설정이 훨씬 간편해지고, Docker Compose로 멀티 컨테이너 환경도 손쉽게 관리할 수 있어요.

 

끝.