배포 전략
Kube-Ready-Box는 .box 파일을 GitHub Release asset으로, Vagrant catalog JSON을 GitHub Pages(https://dasomel.github.io/kube-ready-box/boxes/<name>.json)로 배포합니다. 파일시스템(ext4, xfs)별로 Box를 분리하며 카탈로그 이름은 ubuntu-24.04-ext4, ubuntu-24.04-xfs, ubuntu-26.04-ext4, ubuntu-26.04-xfs, rocky-9-ext4, rocky-9-xfs, nixos-kube-ready입니다. 자세한 내용은 box-distribution.md를 참고하세요.
최신 릴리스는 v0.3.1(2026-11-02)입니다. Ubuntu 박스 0.3.1(v0.3.1 자산), Rocky 9 박스 0.1.1과 NixOS 박스 0.2.2(libvirt)(v0.3.0 자산)입니다. Ubuntu 0.3.1은 vmware_desktop arm64와 virtualbox amd64를 같은 카탈로그 버전에 함께 담고 있어, Vagrant가 호스트에 맞는 provider와 아키텍처를 고릅니다. Rocky는 vmware_desktop arm64, NixOS는 libvirt arm64입니다.
amd64 박스는 arm64 빌드 호스트에서 만들 수 없어 GitHub x86 러너(build-amd64.yml)에서 빌드하고, 같은 러너에서 VirtualBox로 띄워 설치 인자 제거, 실행 중 커널만 남음, 루트 디스크 확장, vagrant reload, verify_box.sh failures=0을 확인한 것만 배포합니다(2026-11-03 v0.3.1에 추가). 러너에서 VMware를 돌릴 수 없어 VMware amd64 박스는 없고, VirtualBox arm64 박스(빌드 호스트에서 SSH 검증 불가)와 Rocky/NixOS amd64 박스도 없습니다.
Vagrant Cloud 종료와 마이그레이션
HashiCorp가 HCP Vagrant(Vagrant Cloud)를 종료합니다. 신규 box/registry 생성은 2026-10-01에 중단됐고, 지원은 2026-11-02에 종료되며, 호스팅된 모든 box는 2026-12-31에 폐기됩니다(공지). 이전의 HCP Service Principal 인증과 vagrant cloud publish 기반 업로드 파이프라인은 더 이상 사용하지 않습니다.
Ubuntu 버전 라인은 0.3.0으로 초기화됐습니다. 1.1.0은 Vagrant Cloud에만 올라간 버전이며 Vagrant는 1.1.0을 0.3.x보다 높게 취급하므로, 기존 사용자는 vagrant box remove dasomel/<box> --box-version 1.1.0을 먼저 실행해야 합니다.
config.vm.box = "dasomel/ubuntu-24.04-ext4"
config.vm.box_url = "https://dasomel.github.io/kube-ready-box/boxes/ubuntu-24.04-ext4.json"배포 파이프라인
주간 CVE 스캔
.github/workflows/box-cve-scan.yml 워크플로우가 매주 실행되어 다음을 수행합니다.
- 카탈로그에서 배포된 박스를 내려받고 체크섬을 검증합니다.
- 박스에서 dpkg/rpm 패키지 DB를 추출해 Trivy로 스캔합니다(배포판이 수정한 CVE만 대상). Ubuntu는
vmware_desktoparm64와virtualboxamd64를 각각 스캔하며, 요청한 provider가 카탈로그에 없으면 다른 provider로 대신하지 않고UNKNOWN입니다. - CRITICAL/HIGH가 발견되면 실행이 실패하며, 이는 재빌드 신호입니다.
- NixOS 박스는 dpkg/rpm DB가 없어
UNKNOWN으로 보고됩니다.UNKNOWN은 정상으로 취급하지 않습니다.
v0.3.0과 v0.3.1(Ubuntu)은 릴리스 시점 Trivy 기준 모든 박스의 배포판 수정 가능 CVE가 0건입니다. 아직 수정이 없는 커널 CVE-2026-98432는 security-response.md에서 추적합니다.
배포 체크리스트
릴리스 전 (Pre-release)
- 로컬 빌드 검증 (
packer build및vagrant up테스트 성공) - CHANGELOG.md에 신규 버전 작성 및 Release Notes 갱신 (예: v0.3.0 - 2026-11-01 기준 최신, CVE 재빌드)
- Box 파일 크기 검증 (1–2 GiB 내외, root LV는 설치 시 16 GiB이며 첫 부팅 때 전체 디스크로 확장)
- 박스 버전이 기존에 배포된 버전보다 높은지 확인 (Vagrant는 높은 버전을 우선)
릴리스 후 (Post-release)
- GitHub Release에
.boxasset과 체크섬이 올라갔는지 확인 - GitHub Pages 카탈로그 JSON이 새 버전과 asset URL을 가리키는지 확인
-
config.vm.box_url로 로컬 다운로드 및 구동 테스트 - 주간
box-cve-scan워크플로우 결과 확인 (CRITICAL/HIGH 시 재빌드)