설치 방식 고르기

팀이 함께 쓸 Werft 서버의 설치 경로를 고른다. 운영 설치는 영속 object store를 사용한다. Compose test-ops는 AWS S3만 지원하며 사용자 endpoint를 받지 않는다. Kubernetes는 보호 계약을 충족하는 S3 호환 endpoint를 설정할 수 있다. LocalStack과 kind는 시험 환경이다.

방식	실행 기반	전제	페이지
단일 서버	Linux 서버 한 대, Docker Compose. 세션마다 worker 컨테이너. HA는 범위 밖	Docker 28 이상, Compose 2.24.6 이상, Docker 데이터 루트가 `prjquota`로 mount된 XFS, 저장소 checkout, 영속 AWS S3 bucket	단일 서버 설치
Kubernetes	게시된 Helm chart. 세션마다 worker Pod	NetworkPolicy를 강제하는 CNI, `helm` 3, PostgreSQL 16, S3 호환 object store(기본 보호 모드는 versioning, Object Lock, SSE-S3가 켜진 bucket을 요구한다). 저장소 checkout은 필요 없다	Kubernetes 설치

고르는 기준은 단순하다. 서버 한 대에 올리고 scripts/test-ops.sh로 운영하려면 단일 서버, 이미 클러스터와 PostgreSQL, object store가 있고 chart로 올리려면 Kubernetes다. 두 방식 모두 ghcr.io에서 게시 패키지를 로그인 없이 받을 수 있어야 한다. 이미 설치했다면 Compose 업그레이드 또는 Kubernetes 업그레이드를 선택한다.

어느 방식이든 서버는 API(웹 콘솔 포함), scheduler, reconciler, egress proxy, PostgreSQL, S3 호환 object store로 이뤄진다. Git 서버는 없으므로 세션이 쓸 GitHub 저장소는 설정 문서나 콘솔로 더한다.

목적	먼저 읽을 곳
Linux 서버 한 대에 운영 설치	단일 서버 설치
기존 클러스터에 운영 설치	Kubernetes 설치
노트북에서 chart 시험	kind 시험
Linux에서 Compose 시험	LocalStack 시험