실전 가이드
앱을 배포하는 가장 쉬운 방법.
노트북에 있는 Docker 컨테이너를 세 개의 명령으로 안전한 공개 HTTPS URL로 가져가세요. Kubernetes도, YAML도, DevOps 팀도 필요 없습니다. 예제는 bootload CLI를 사용하지만, 동일한 빌드 → 인증 → 배포 흐름은 어디서나 똑같이 동작합니다.
# 1 · 이미지 빌드 $ docker build -t myapp . # 2 · 호스트에 인증 $ bootload login --email you@example.com # 3 · 배포 → HTTPS URL 받기 $ bootload deploy --image myapp --port 3000:http 🔒 SSL 인증서 발급 중 완료 실행 중 https://myapp-4f2a.bootload.io
시작하기 전에
필요한 것
세 가지면 되고, 모두 무료로 시작할 수 있습니다.
빠른 시작
Dockerfile에서 SSL이 적용된 실행 URL까지
순서대로 따라 하세요. 3단계 이후는 모두 선택적인 마무리 작업입니다.
이미지를 로컬에서 빌드하고 테스트하기
배포하기 전에 컨테이너가 실제로 실행되고 포트에서 서비스되는지 확인하세요.
CLI 설치, 계정 생성 & 인증
호스트 CLI를 설치하세요 (curl -fsSL https://my.bootload.io/v1/cli/install.sh | sh). 그런 다음 bootload signup으로 CLI에서 가입하거나, my.bootload.io에서 브라우저로 시작하세요. bootload login은 토큰을 로컬에 저장합니다. 배포가 실행될 수 있도록 약간의 크레딧을 추가하세요. 전체 안내: 시작하기.
배포하고 URL 받기
명령 하나로 격리된 VM이 부팅되고, TLS 인증서가 발급되며, https:// URL이 반환됩니다. --port로 컨테이너의 포트를 매핑하세요.
직접 보유한 도메인 연결하기 (선택)
커스텀 도메인을 추가하세요. 호스트가 DNS 레코드를 출력하고, 도메인이 해석되면 SSL이 자동으로 발급됩니다. 커스텀 도메인을 참고하세요.
# 호스트 CLI 설치 $ curl -fsSL https://my.bootload.io/v1/cli/install.sh | sh $ docker build -t myapp . $ docker run --rm -p 3000:3000 myapp # 테스트 $ bootload signup --email you@example.com → 받은 편지함의 링크로 확인하세요 $ bootload login --email you@example.com $ bootload wallet topup --amount 10
$ bootload deploy --image myapp \ --port 3000:http --name myapp VM 부팅 중 ...... 완료 · tls 발급됨 실행 중 https://myapp-4f2a.bootload.io $ bootload domain add app.example.com 이 DNS 레코드를 추가하면 SSL은 자동으로 처리됩니다 → CNAME app myapp-4f2a.bootload.io
한 걸음 더
실제로 자주 다시 쓰게 될 몇 가지 명령
데이터 유지하기
암호화된 볼륨을 연결해 재시작 후에도 상태가 유지되도록 하세요: volume create data --size 5 후 --volume data:/var/lib로 배포합니다. 볼륨 & 백업 →
시크릿 & 비공개 이미지
쓰기 전용 시크릿(secret set)으로 설정을 이미지 밖에 두고, 호스트 레지스트리나 자체 레지스트리에서 가져오세요(image push, registry add). 자체 이미지 푸시하기 →
운영 & 롤백
scale --replicas N으로 확장하고, --replicas 0으로 일시 중지하여 비용을 멈추며, logs -f / metrics / status를 관찰하고, 어떤 배포든 rollback하세요.
안전한 이유
여기서 "쉬움"과 "안전함"은 맞바꾸는 관계가 아닙니다
각 컨테이너는 자체 경량 VM 안에서 실행됩니다. 이웃과 커널을 공유하는 것이 아니라 진짜 경계가 존재합니다.
모든 경로에 HTTPS가 자동으로 적용됩니다. 커스텀 도메인은 DNS로 검증되고 인증서는 스스로 갱신됩니다.
자격 증명은 입력만 가능하고 다시 읽어올 수 없으므로, 터미널 기록이 유출되어도 시크릿이 새어 나가지 않습니다.
에이전트로 자동화하기
더 쉬운 방법: 에이전트에게 배포를 맡기세요.
동일한 세 개의 명령 흐름은 결정론적이고 완전하게 문서화되어 있어, AI 코딩 에이전트에게 넘기기가 쉽습니다. 아래 스킬을 넣어 두면 에이전트가 실제 문서와 CLI 레퍼런스를 읽어 가며 스스로 빌드하고, 배포하고, SSL을 연결하고, 실행 URL을 보고할 수 있습니다.
# 에이전트에게 요청합니다: "이 앱을 api.acme.dev에 배포해 줘" ▸ CLI 문서 읽는 중 ▸ docker build · bootload login ▸ bootload deploy --image acme/api \ --port 8080:http --name api ✓ 실행 중 https://api-7c1d.bootload.io ✓ tls 발급됨 · 상태 정상 (1/1)
스킬
컨테이너 배포를 위한 에이전트 스킬
스킬은 AI 코딩 에이전트가 필요할 때 불러오는, 프런트매터가 있는 작은 Markdown 파일(SKILL.md)입니다. 에이전트에게 레퍼런스 문서, 명령 규약, 안전한 배포 루프를 가르쳐 줍니다. 스킬을 이해하는 모든 에이전트에서 동작합니다:
- Claude Code
- Cursor
- Codex CLI
- Gemini CLI
- GitHub Copilot
- OpenCode
- Windsurf
- …그리고 그 밖의 에이전트형 코딩 도구들
에이전트가 스킬을 찾는 위치에 저장하세요 — Claude Code의 경우 ~/.claude/skills/container-deploy/SKILL.md(전역)이거나 저장소 내의 .claude/skills/…입니다.
--- name: container-deploy description: Deploy a Docker container to a secure HTTPS URL on an isolated VM. Use when the user wants to ship/host/deploy a container, add a custom domain, scale a service, or check a live deployment. --- # container-deploy Build a Docker image and deploy it to a public, SSL'd URL. These examples use the bootload CLI as the host. ## Reference docs — read before acting - Guides: https://bootload.io/docs/ - Getting started: https://bootload.io/docs/getting-started/ - Custom domains: https://bootload.io/docs/custom-domains/ - CLI reference: https://bootload.io/docs/cli/ (source of truth for flags) Fetch the CLI page first; never guess a flag. ## Install the CLI `curl …/v1/cli/install.sh | sh` · `bootload version` ## Account `signup` / `login` / `wallet topup` (real money) ## Deploy loop `docker build` → `bootload deploy` → `status` → report URL ## Custom domain `domain add <d>` → add DNS record → automatic TLS ## Operate `logs · metrics · scale --replicas 0 · rollback` ## Guardrails confirm image+port · wallet check · secrets write-only # 전체 파일 → 위의 "보기 / 다운로드" 링크
설치
에이전트에 스킬 추가하기
2분이면 됩니다: SKILL.md를 스킬 폴더에 다운로드한 다음, 그냥 요청하세요.
$ mkdir -p ~/.claude/skills/container-deploy # 위의 다운로드 버튼을 사용하거나, curl로 받으세요: $ curl -o ~/.claude/skills/container-deploy/SKILL.md \ https://dockerdeploy.com/skills/container-deploy/SKILL.md
파일 저장하기
SKILL.md를 ~/.claude/skills/container-deploy/(또는 에이전트가 스킬을 불러오는 위치) 아래에 두거나, 저장소 안의 .claude/skills/에 두세요.
그냥 요청하기
“이 컨테이너를 api.acme.dev에 배포해 줘.” 에이전트가 설명을 보고 스킬을 매칭한 뒤 배포 루프를 따릅니다.
보고 받기
에이전트가 이미지 & 포트를 확인하고, 배포하고, 정상 + TLS 상태를 기다린 뒤, 실행 중인 https:// URL을 반환합니다.