Honey buns

Windows에서 WSL(Windows Subsystem for Linux)을 통해 Ubuntu에 Docker를 설치하려면 아래 단계를 따라 진행하면 됩니다. 

1. WSL 및 Ubuntu 확인

먼저 WSL이 설치되어 있고 Ubuntu가 제대로 실행되는지 확인하세요.

Windows PowerShell 또는 명령 프롬프트에서 다음 명령어를 실행해 WSL이 설치되어 있는지 확인:

결과에 Ubuntu(예: Ubuntu-20.04)가 보이면 됩니다. 없으면 Microsoft Store에서 Ubuntu를 설치하세요.

Ubuntu를 실행:

또는 시작 메뉴에서 "Ubuntu"를 검색해 실행합니다.

2. Ubuntu 업데이트

Ubuntu 터미널에서 시스템 패키지를 최신 상태로 업데이트합니다:

3. Docker 설치에 필요한 패키지 설치

Docker 설치를 위해 몇 가지 필수 패키지를 설치합니다:

4. Docker 공식 GPG 키 추가

Docker의 공식 저장소를 추가하려면 GPG 키를 설정해야 합니다:

키가 추가되면 아래와 같이 'OK' 를 확인할 수 있습니다. 

5. Docker 저장소 추가

Ubuntu에 Docker의 공식 저장소를 추가합니다:

6. Docker 설치

이제 Docker를 설치합니다:

7. Docker 서비스 시작 및 확인

Docker가 제대로 설치되었는지 확인하고 서비스를 시작합니다:

Docker 서비스 시작:

Docker 버전 확인:

예: Docker version 20.10.24 같은 출력이 나오면 성공입니다.

8. sudo 없이 Docker 사용 (선택)

Docker 명령어를 sudo 없이 실행하려면 현재 사용자를 Docker 그룹에 추가합니다:

이후 WSL(Ubuntu) 터미널을 재시작하거나 로그아웃 후 다시 로그인하세요.

9. 테스트

Docker가 잘 작동하는지 확인하려면 다음 명령어를 실행:

"Hello from Docker!" 메시지가 출력되면 설치가 완료된 것입니다.

추가 참고

• WSL에서는 Docker Desktop을 설치할 필요가 없습니다. 위 방법은 Ubuntu 내에서 네이티브 Docker를 설치하는 방식입니다.
• 만약 WSL과 Docker Desktop을 함께 사용하고 싶다면, Windows에 Docker Desktop을 설치하고 WSL 통합 옵션을 활성화하는 방법도 있습니다. 이 경우 Docker Desktop 설정에서 "Use WSL 2 based engine"과 Ubuntu 통합을 체크하세요.

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

1. 사전 요구 사항 확인

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

출력이 나오면 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) 실행 권한 부여

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

(3) 설치 확인

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

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

3. Docker Compose v2 사용 (권장)

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

(1) Docker Compose v2 확인

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

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

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

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

4. 테스트

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

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

실행:

또는 v2 플러그인 사용 시:

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

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

5. 문제 해결

• "command not found" 오류:

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

포함되지 않았다면 추가:

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

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

결론

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

1. Docker Swarm

"Docker의 친형제" 같은 느낌이에요. Docker를 쓰다 보면 자연스럽게 "스웜 모드"로 몇 대 서버를 묶어서 관리할 수 있어요. 간단히 말하면, "쉽고 빠르게 클러스터 만들기"에 초점.

• 정의: Docker에서 제공하는 기본 오케스트레이션 도구로, Docker와 통합되어 있습니다.
• 특징:간단함: Docker 명령어만 알면 쉽게 시작 가능(docker swarm init, docker service create 등).

• • 설치: 별도 설치 없이 Docker만 있으면 "스웜 모드" 활성화로 바로 사용.
  • 규모: 소규모 또는 중간 규모 클러스터에 적합.
  • 기능: 기본적인 로드 밸런싱, 서비스 스케일링, 노드 간 장애 복구 제공.
  • 비유: "집에서 가족끼리 간단히 밥상 차리는 느낌" – 빠르고 직관적.
• 장점:
  
  • Docker와 바로 연동되니 학습 곡선이 완만함.
  • 설정이 간단해서 빠르게 띄울 수 있음.
• 단점:
  
  • 복잡한 환경(예: 수백 개 노드)에서는 기능이 부족.
  • 커뮤니티와 생태계가 Kubernetes에 비해 작음.

2. Kubernetes (K8s)

• 정의: Google에서 개발한 오픈소스 오케스트레이션 플랫폼으로, 현재 업계 표준으로 자리잡음.
• 특징:
  
  • 복잡함: 설정과 개념(Pod, Deployment, Service 등)을 익혀야 함.
  • 설치: 별도 설치 필요(Minikube로 로컬 테스트 가능, 실제론 클러스터 구축 필요).
  • 규모: 대규모, 복잡한 환경에 최적화.
  • 기능: 자동 스케일링(HPA), 셀프 힐링, 롤링 업데이트, 네트워크 정책, 모니터링 통합 등 풍부.
  • 비유: "대규모 레스토랑에서 주방, 서빙, 재고까지 체계적으로 관리하는 느낌" – 강력하지만 준비가 필요.
• 장점:
  
  • 거의 무한한 확장성과 세밀한 제어 가능.
  • 거대한 커뮤니티와 생태계(Helm, Prometheus 등).
• 단점:
  
  • 초기 설정과 학습이 어려움.
  • 소규모 프로젝트엔 과도할 수 있음(오버킬).

간단 비교

• 시작 난이도: Swarm은 "바로 시작", Kubernetes는 "공부하고 시작".
• 규모: Swarm은 소규모 팀, Kubernetes는 대기업급 프로젝트.
• 기능: Swarm은 기본 제공, Kubernetes는 끝없는 확장성.
• 유연성: Swarm은 단순함, Kubernetes는 세밀함.

주요 차이점 정리

실제 예시

• Docker Swarm: "5대 서버로 웹 앱을 띄우고 트래픽 분산만 하면 돼" → Swarm으로 간단히 해결.
• Kubernetes: "100대 서버에 데이터베이스, 웹 앱, 캐시를 나눠 배포하고, 트래픽 급등 시 자동 확장해야 해" → Kubernetes가 적합.

결론 - 뭐 쓸까? 

• Docker Swarm은 간단하고 빠르게 오케스트레이션을 시작하고 싶을 때 좋습니다. Docker를 이미 쓰고 있다면 자연스럽게 확장할 수 있는 선택지.
  • "작은 팀, 빠른 배포 필요" → Docker Swarm.
• Kubernetes는 복잡하고 대규모 시스템을 관리해야 하거나, 장기적으로 탄탄한 인프라를 구축하고 싶을 때 강력한 선택입니다. 대신 초기 투자(시간, 학습)가 필요.
  • "큰 시스템, 장기적인 안정성 필요" → Kubernetes.
    
    
     

상황에 따라 선택하면 되는데, 소규모라면 Swarm, 대규모거나 미래 확장을 고려한다면 Kubernetes를 추천.

티스토리 블로그에서 첨부파일당 20메가 용량 제한이 있어 2개로 분할 압축함. 
모두 다운받아서 '반디집' 등을 통해 압축해제하고 사용하면 됨. 

Windows 11 pro 환경에서 virtual box 설치 후 아래와 같은 오류가 발생했을 때, 조금 삽질하다가 해결방법을 찾았다

D:\k8s>vagrant up
Bringing machine 'master-node' up with 'virtualbox' provider...
==> master-node: Checking if box 'rockylinux/8' version '8.8-20230518.0' is up to date...
==> master-node: Clearing any previously set forwarded ports...
==> master-node: Clearing any previously set network interfaces...
==> master-node: Preparing network interfaces based on configuration...
    master-node: Adapter 1: nat
    master-node: Adapter 2: hostonly
==> master-node: Forwarding ports...
    master-node: 22 (guest) => 2222 (host) (adapter 1)
==> master-node: Running 'pre-boot' VM customizations...
==> master-node: Booting VM...
There was an error while executing `VBoxManage`, a CLI used by Vagrant
for controlling VirtualBox. The command and stderr is shown below.

Command: ["startvm", "7fbdc99a-dae7-432f-88dd-e52069f688c6", "--type", "headless"]

Stderr: VBoxManage.exe: error: The virtual machine 'k8s_master' has terminated unexpectedly during startup with exit code 1 (0x1).  More details may be available in 'C:\Users\minipc\VirtualBox VMs\k8s_master\Logs\VBoxHardening.log'
VBoxManage.exe: error: Details: code E_FAIL (0x80004005), component MachineWrap, interface IMachine

초기에 설치 시도했던 것은 아래와 같다.
- Virtualbox 7.0.8-156879.exe
- Vagrant 2.3.4 windows_amd64.msi

해결방법은 아래 oracle page에서 7.0.22 버전(현재 최신버전)을 설치하고 나서 vagrant up 명령어를 실행하니 바로 에러 없이 실행되었다.

Oracle VM VirtualBox - Downloads | Oracle Technology Network | Oracle