WSL의 Ubuntu 환경에서 Docker Compose를 설치하는 방법

WSL의 Ubuntu 환경에서 Docker Compose를 설치하려면 아래 단계를 따라 진행하면 됩니다. Docker Compose는 Docker 컨테이너를 정의하고 실행하기 위한 도구로, 단일 명령어로 여러 컨테이너를 관리할 수 있게 해줍니다. 최신 버전인 Docker Compose v2를 설치하는 방법을 중심으로 설명하겠습니다.

---

1. 사전 요구 사항 확인

Docker가 이미 설치되어 있어야 합니다. 설치 여부를 확인하려면:

docker --version

출력이 나오면 Docker가 설치된 상태입니다. 설치되지 않았다면 이전 답변을 참고해 설치하세요.

• WSL에서 Ubuntu가 실행 중인지 확인하세요.

---

2. Docker Compose 설치

Docker Compose는 독립적인 바이너리 파일로 제공되며, 공식 GitHub 릴리스에서 다운로드해 설치합니다. 아래는 최신 버전을 설치하는 방법입니다.

(1) 최신 버전 확인 및 다운로드

Docker Compose의 최신 버전을 GitHub에서 가져옵니다. 2025년 3월 기준으로 최신 안정 버전을 사용하지만, 필요 시 Docker Compose GitHub Releases에서 최신 버전을 확인하세요.

다음 명령어를 실행:

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

• 설명:
  • $(uname -s): 운영 체제 이름(Linux).
  • $(uname -m): 머신 아키텍처(예: x86_64).
  • /usr/local/bin/: 시스템 전체에서 실행 가능한 경로.

(2) 실행 권한 부여

다운로드한 파일에 실행 권한을 추가합니다:

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

(3) 설치 확인

Docker Compose가 제대로 설치되었는지 확인합니다:

docker-compose --version

• 예: Docker Compose version v2.24.7 같은 출력이 나오면 성공입니다.

---

3. Docker Compose v2 사용 (권장)

최신 Docker에서는 docker-compose standalone 대신 Docker 플러그인 형태의 docker compose (띄어쓰기 주의)가 기본으로 권장됩니다. 이 경우 별도 바이너리 설치 없이 Docker와 함께 제공됩니다.

(1) Docker Compose v2 확인

Docker가 최신 버전이라면 이미 포함되어 있을 수 있습니다. 다음 명령어로 확인:

docker compose version

• 출력이 나오면 별도 설치 없이 바로 사용 가능합니다.

(2) 기존 docker-compose와의 차이

• docker-compose (하이픈 포함): 독립형 설치.
• docker compose (띄어쓰기): Docker 내장 플러그인.
• v2를 선호한다면 명령어에서 docker compose를 사용하세요.

---

4. 테스트

Docker Compose가 잘 작동하는지 간단한 예제로 확인합니다:

테스트용 docker-compose.yml 파일 생성:

echo -e "version: '3'\nservices:\n web:\n image: nginx\n ports:\n - '80:80'" > docker-compose.yml

실행:

docker-compose up

또는 v2 플러그인 사용 시:

docker compose up

1. 브라우저에서 http://localhost에 접속해 Nginx 환영 페이지가 보이면 성공입니다.

종료하려면 Ctrl+C를 누르고, 컨테이너 정리:

docker-compose down

---

5. 문제 해결

• "command not found" 오류:

/usr/local/bin/docker-compose가 PATH에 포함되었는지 확인:

echo $PATH

포함되지 않았다면 추가:

export PATH=$PATH:/usr/local/bin

영구 적용하려면 ~/.bashrc에 추가하세요.

권한 문제: sudo 없이 실행하려면 Docker 그룹에 사용자를 추가하세요:

sudo usermod -aG docker $USER

---

결론

• 독립형 설치: docker-compose 바이너리를 수동으로 다운로드해 설치.
• 플러그인 방식: Docker와 함께 제공되는 docker compose 사용 (권장). 필요에 따라 원하는 방식을 선택하세요.