이미지와 레이어
이미지는 게스트의 출발점입니다. 레이어는 별도로 보관하는 파일 집합으로, 일반 VM 경로에서는 SquashFS 형식의 읽기 전용 계층입니다. 여러 VM에서 같은 입력을 참조할 수 있습니다.
저장소의 sha256:… digest는 바이트의 식별자입니다. 이름이나 태그만 신뢰하는 대신 실제 내용이 예상한 digest와 맞는지 확인합니다.
클라우드 목표는 외부 Palimpsest 제어가 레이어를 고르고, Manila 관리 CephFS의 읽기 전용 바이트를 워크로드 VM에 연결하는 구조입니다. Hub DB는 메타데이터를, VM은 최소 마운트와 실행만 맡습니다.
주 경로는 클라우드 목표입니다. DB의 기록과 공유 저장소의 실제 바이트를 분리해 읽으세요.
외부 제어 → 공유 RO → 워크로드
위 네 칸은 책임을 읽는 순서이며 DB를 통과해 바이트가 흐른다는 뜻은 아닙니다. 아래 전체 구조도와 시퀀스에 실제 관계와 RW/RO 경계를 표시했습니다.
VM을 통째로 복사하는 대신, 어떤 파일이 원본이고 어떤 파일이 실행 중 바뀌는지 구분합니다.
이미지는 게스트의 출발점입니다. 레이어는 별도로 보관하는 파일 집합으로, 일반 VM 경로에서는 SquashFS 형식의 읽기 전용 계층입니다. 여러 VM에서 같은 입력을 참조할 수 있습니다.
저장소의 sha256:… digest는 바이트의 식별자입니다. 이름이나 태그만 신뢰하는 대신 실제 내용이 예상한 digest와 맞는지 확인합니다.
OverlayFS는 읽기 전용 lower 레이어와 별도의 쓰기 가능한 upper를 합쳐 하나의 파일 트리처럼 보여줍니다. 변경은 upper에 남고 원본 lower는 그대로 유지됩니다.
로컬 상태에는 아티팩트뿐 아니라 VM 실행 기록, 프로젝트, 빌드 기록도 있습니다. 콘텐츠 바이트와 실행 상태는 같은 것이 아닙니다.
아래는 현재 로컬 구현입니다. 클라우드 Manila 목표의 구현 증거가 아닙니다. 탭을 바꿔 게스트 파일시스템의 차이를 보세요.
Ubuntu 같은 부팅 가능한 cloud image로 VM을 시작합니다. 실행별 쓰기 가능한 디스크가 OS 변경을 담고, 별도로 연결한 SquashFS 레이어는 게스트 안에서 합쳐집니다.
게스트의 /와 레이어가 합쳐지는 /opt/layers/merged는 서로 다른 경로입니다. libvirt 경로는 cloud-init으로 레이어 활성화와 준비 신호를 설정합니다. Lima는 VM 시작 후 레이어를 복사·마운트합니다.
OCI 이미지의 manifest와 레이어를 검증·변환하고, 읽기 전용 lower와 VM 전용 쓰기 계층으로 게스트의 실제 /를 만듭니다. stage-1이 루트를 조립한 뒤 워크로드를 감독합니다.
이 경로는 Linux amd64 KVM으로 제한됩니다. 일반 cloud-image의 --layer 연결과 같은 경로가 아닙니다.
외부 클라이언트·Hub API·오케스트레이터가 레이어 선택, mount 명세, 접근권한·lease와 Nova 수명주기를 맡습니다. 아래 그림은 목표 계약이며 아직 Manila 기반 구현·실기 검증은 아닙니다.
아래 두 그림은 기존 Archify JSON에서 정식 생성·SVG export한 동일 산출물입니다. 작은 화면에서는 그림 안만 좌우로 이동할 수 있습니다.
외부 클라이언트가 빌드를 요청하면 별도 worker가 레시피를 실행하고 /opt/hello-vm/message.txt를 포함한 새 SquashFS를 검증·발행합니다. Hub DB에는 digest·size·순서·출처를 기록합니다. 외부 제어는 실행 요청에 맞는 공유 RO 접근과 mount 명세를 확정합니다. 게스트 helper가 해당 lower들을 RO로 조립하면 워크로드가 병합 뷰에서 파일을 읽습니다. 실행 중 파일 변경은 VM 전용 upper로 갑니다. 이는 의미를 설명하는 예시이며 새 API 이름이나 실행 성공을 주장하지 않습니다.
아래로 갈수록 시간이 흐릅니다. Hub DB는 메타데이터, CephFS는 바이트입니다. 끝의 helper와 워크로드는 같은 VM 안에 있습니다.
977c4f2) 중 hub/src/palimpsest_hub/services/instance_bootstrap.py의 게스트 bootstrap은 레이어를 HTTPS로 내려받은 뒤 RO loop mount합니다. 이미 게스트 Palimpsest CLI는 없지만 Manila 공유 기반 실행 경로는 아닙니다. 이 체크아웃의 Nova capture/Cinder ext4 RW → 별도 봉인·RO 연결 프로토타입도 별개입니다. 과거 소스와 벤치마크는 보존하며 새 목표의 구현·성능 검증으로 보지 않습니다. 목표와 현재 구현 차이에서 근거와 남은 전환을 확인하세요.기준: 2026-10-29 소유자 목표 계약 · 역사적 별도 경로: Nova capture · 외부 계층 마운트. Torch·TensorFlow·CUDA 파일을 담을 수 있다는 설명은 GPU·드라이버·프레임워크 동작 증거가 아닙니다.
아래는 기존 로컬·Hub 구현의 소스 안내입니다. 위 클라우드 목표의 Manila 전환이나 실제 RO 권한 검증을 뜻하지 않습니다.
Palimpsestfile에서 시작하는 대표 경로
근거: build.py · Hello VM 예제
서버에 별도로 구성된 경우의 경로
다른 입력 경로: Dockerfile 빌드는 BuildKit을 사용해 OCI 출력을 만드는 별도 경로입니다. --executor nova 역시 명시적으로 선택하는 클라우드 빌드 경로이며 위 로컬 게스트 빌드와 동일하지 않습니다. Hub는 Docker/OCI /v2 레지스트리가 아닌 별도의 /v1 API입니다.
각 경로를 열어 실제 구현을 확인할 수 있습니다. 링크는 이 HTML과 같은 체크아웃의 파일을 가리킵니다.
palimpsest CLI 진입점/v1 라우터 구성Hello VM은 기존 로컬 이미지·레이어 빌드와 VM 실행을 설명합니다. Manila 클라우드 목표의 실행 예제는 아닙니다.