Docker Sandboxes 설치
Docker Sandboxes 설치 (Install Docker Sandboxes)
sbx CLI를 설치해서 로컬 또는 클라우드 샌드박스에서 AI 코딩 에이전트를 실행하는 방법을 알아볼게요.
출처: 문서
본문
로컬 또는 클라우드 샌드박스에서 AI 코딩 에이전트를 실행하려면 sbx CLI를 설치하세요. sbx를 사용하는 데 Docker Desktop이나 Docker Engine은 필요하지 않아요. 클라우드 샌드박스는 이 가이드의 워크플로우에 버전 0.45.0 이상이 필요해요.
사전 요구 사항 (Prerequisites)
운영 체제와 프로세서 요구 사항은 CLI 설치에 적용돼요. 하이퍼바이저와 KVM 설정은 로컬 샌드박스를 실행할 때만 필요해요. 클라우드 계정 요구 사항은 클라우드 샌드박스를 참고하세요.
macOS
- macOS Sonoma 버전 14 이상
- Apple silicon
Windows
- Windows 11
- 64비트 Intel 또는 AMD 프로세서
- 로컬 샌드박스를 위한 Windows Hypervisor Platform
로컬 샌드박스를 실행하려면 관리자 PowerShell 프롬프트를 열고 Windows Hypervisor Platform을 켜세요:
Enable-WindowsOptionalFeature -Online -FeatureName HypervisorPlatform -All
Linux
- Ubuntu 24.04 이상
- 64비트 Intel 또는 AMD 프로세서, 또는 64비트 Arm 프로세서
- 로컬 샌드박스용: CPU가 지원하고 켠 KVM 하드웨어 가상화, 그리고
kvm그룹의 사용자 계정
가상 머신 또는 가상 데스크톱 인프라 환경 안에서 로컬 샌드박스를 실행하려면 그 환경이 중첩 가상화(nested virtualization)를 지원해야 해요. 클라우드 샌드박스는 이 설정이 필요하지 않아요.
로컬 샌드박스에서 KVM이 사용 가능한지 확인하세요:
$ lsmod | grep kvm
제대로 된 설정이면 출력에 kvm_intel, kvm_amd, kvm_arm64, 또는 kvm이 보여요. 출력이 비어 있으면 kvm-ok으로 진단하세요. 로컬 샌드박스 런타임은 시작에 KVM이 필요해요.
kvm 그룹에 사용자를 추가하세요:
$ sudo usermod -aG kvm $USER
로그아웃 후 다시 로그인하거나 newgrp kvm을 실행해야 그룹 변경이 적용돼요.
macOS에 설치
Homebrew로 sbx를 설치하세요:
$ brew trust docker/tap
$ brew install docker/tap/sbx
Windows에 설치
현재 사용자용 설치
Windows Package Manager로 sbx를 설치하세요:
winget install -h Docker.sbx
WinGet은 %LOCALAPPDATA%\DockerSandboxes에 사용자별 DockerSandboxes.msi 패키지를 설치하고 그 bin 디렉터리를 사용자 PATH에 추가해요. 관리자 권한 없이 설치할 수 있어요.
모든 사용자용 설치
관리자 관리 배포의 경우 Docker Sandboxes 릴리스에서 DockerSandboxesMachine.msi를 다운로드하세요. 관리자 PowerShell 프롬프트에서 패키지를 조용히 설치하세요:
msiexec.exe /i DockerSandboxesMachine.msi /quiet
머신 전체 패키지는 %ProgramFiles%\DockerSandboxes에 설치되고 그 bin 디렉터리를 시스템 PATH에 추가해요.
머신 전체 업그레이드는 다른 사용자 세션의 sbx 데몬이 설치된 파일을 사용 중이면 Windows 재시작이 필요할 수 있어요.
Ubuntu에 설치
[!NOTE] Docker는 Linux Mint, Pop!_OS 같은 Ubuntu 파생판에서 Docker Sandboxes를 테스트하거나 지원하지 않아요. 편의 스크립트가 이 배포판에 잘못된 패키지 저장소를 구성할 수 있어요.
Docker Engine과 함께 sbx를 설치하거나 sbx 패키지만 설치할 수 있어요.
Docker Engine과 SBX 설치
SBX=1과 함께 Docker의 편의 스크립트를 실행해 Docker Engine과 docker-sbx 패키지를 함께 설치하세요:
$ curl -fsSL https://get.docker.com | sudo SBX=1 sh
SBX만 설치
호스트에 Docker Engine 없이 sbx를 설치하려면 Docker의 apt 저장소를 추가하고 docker-sbx 패키지를 설치하세요:
$ curl -fsSL https://get.docker.com | sudo REPO_ONLY=1 sh
$ sudo apt install docker-sbx
릴리스 아티팩트에서 설치
패키지나 아카이브에서 sbx를 설치하려면 수동 설치 지침을 따르세요. Linux 릴리스 아티팩트가 있다고 해서 Docker가 해당 배포판을 테스트하거나 지원한다는 뜻은 아니에요.
로그인 (Sign in)
Docker에 로그인하세요:
$ sbx login
명령은 Docker OAuth용 브라우저를 엽니다. 로그인이 왜 필요한지, Docker가 데이터를 어떻게 처리하는지는 FAQ를 참고하세요.
로그인 후에는 첫 로컬 샌드박스 실행 또는 클라우드 샌드박스 시작으로 진행하세요.