Stevedore

수동 설치

GitHub 릴리스 페이지에서 MSI 설치 프로그램을 다운로드한 후 실행합니다. 설치 마법사의 안내에 따라 진행하고, 설치가 완료된 후 컴퓨터를 재부팅해야 합니다. 재부팅은 Windows 컨테이너 기능 설치와 사용자를 docker-users 그룹에 추가하기 위해 필요합니다.

패키지 관리자 설치

Chocolatey가 설치된 경우 관리자 권한 PowerShell에서 다음 명령어를 실행합니다:

choco install stevedore

WinGet을 사용하는 경우 다음 명령어를 실행합니다:

winget install stevedore

패키지 관리자로 설치한 후에도 재부팅이 필요합니다.

고급 명령줄 설치 옵션

MSI 설치 프로그램은 다양한 명령줄 옵션을 지원합니다. 무인 설치를 위해 /quiet 옵션을 사용할 수 있습니다. 특정 기능만 설치하려면 ADDLOCAL=Feature1,Feature2 구문을 사용합니다. Hyper-V 지원을 설치하려면 FeatureHyperV를 지정합니다.

설치 경로를 지정하려면 INSTALLDIR=%ProgramFiles%Stevedore와 같은 MSI 속성을 사용할 수 있습니다.

기본 사용법

설치 및 재부팅 후 docker 명령어가 PATH에 추가되어 즉시 사용 가능합니다. 터미널에서 docker run –rm hello-world를 실행하여 정상 설치를 확인할 수 있습니다.

Docker Compose 사용

Stevedore는 Docker Compose V2와 V1 호환 모드를 모두 지원합니다. 새로운 docker compose 명령어를 사용하거나 기존 docker-compose 명령어를 사용할 수 있습니다.

nerdctl 사용 (실험적 기능)

Docker 없이 컨테이너를 실행하고 싶다면 nerdctl을 사용할 수 있습니다. 다음 명령어로 테스트할 수 있습니다:

nerdctl run –rm -it hello-world

nerdctl 빌드 시 write /dev/stdout 오류가 발생하면 –progress=plain 옵션을 추가합니다.

이런 경우에 유용합니다

• Windows에서 컨테이너 기술을 간편하게 시작하고 싶을 때
• Docker Desktop을 대체하는 가벼운 솔루션이 필요할 때
• Windows 컨테이너 기반 애플리케이션을 개발하거나 테스트할 때
• 企业 환경에서 컨테이너 배포를 자동화할 때

지원 환경 및 시스템 요구사항

Stevedore는 다음 Windows 버전을 지원합니다:

• Windows 10 (1809 빌드 17763 이상)
• Windows 11
• Windows Server 2019, 2022, 2025

참고: Windows 컨테이너만 지원하며, Linux 컨테이너는 지원하지 않습니다.

제한 사항 및 확인 사항

Stevedore는 Windows 컨테이너만 지원합니다. Linux 컨테이너를 실행하려면 Rancher Desktop이나 Container Desktop과 같은 대체 솔루션을 사용해야 합니다. nerdctl을 사용할 때 일부 기능은 실험적 단계이며, 관리자 권한이 필요할 수 있습니다.