Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
16 changes: 9 additions & 7 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -53,18 +53,20 @@ Backend가 Challenge Registry의 active release를 조회해 확정 workload를
CI는 Kubernetes manifest, Namespace, Service, NetworkPolicy 또는 cleanup을 소유하지 않습니다. 해당 영역은 Runtime 및 격리보안팀의 책임입니다.

일반 K3s 문제의 main 발행 bundle에는 노드 사전 다운로드용 digest 목록도
포함합니다. 실제 노드 다운로드와 수집·적용 버튼 연결은 아직 구현 전이며,
포함합니다. 최초 대상은 현재 운영 버전의 전체 컨테이너이고, 업데이트 시 새 버전을
추가로 준비합니다. 최신 발행본을 현재 운영 버전으로 간주하지 않습니다.
[운영 버전 기준 정책](docs/active-release-prefetch-policy.md)과
[노드 이미지 사전 다운로드 연동](docs/node-image-prefetch.md)에 담당별 연결과
기존 참가자 인스턴스를 유지하는 전환 순서를 정리했습니다.

Runtime [B안 계약 초안 #70](https://github.com/MSG-CTF/secure-provisioner/pull/70)은
Backend가 준비를 요청하고 Runtime이 다운로드·관측을 관리하며 Scheduler가
준비된 target을 선호하는 제안입니다. 이번 목록은 실행 요청이나 준비 완료 증거가
아니며, 준비 실패만으로 활성화·생성을 막는 gate를 추가하지 않습니다.
Backend는 준비 요청과 운영 버전 선택을, Runtime은 실제 다운로드·관측을 담당합니다.
단일 WEB의 노드 시범 자료는 확인했지만 전체 운영 이미지 준비와 소비자 서버 설정,
준비 후 자동 전환은 별도 연동 검증이 필요합니다. 목록 생성은 준비 완료가 아닙니다.

전체 대상 취합과 이전 목록 비교는 `scripts/collect_node_image_plans.py` 및
읽기 전용 `node-image-prefetch-plan.yml`로 준비합니다. 문제 저장소의 수동 caller
예시를 제공하며 실제 노드 연결이나 caller 적용은 이번 변경에서 하지 않습니다.
읽기 전용 `node-image-prefetch-plan.yml`로 준비합니다. 문제 저장소의 수동 caller는
적용됐으며 최초 취합과 이전 artifact 재취합을 확인했습니다. 이 도구는 Backend의
active release를 선택하거나 Runtime 준비 API를 호출하지 않습니다.

GHCR 이미지 버전은 [삭제 없는 정리 후보 조회](docs/ghcr-cleanup.md)로 관리합니다.
active release·실행 중 digest와 KOTH의 별도 사용 목록을 확인하기 전에는 실제
Expand Down
1 change: 1 addition & 0 deletions docs/README.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
# 문서

- [운영 버전 기준 이미지 사전 다운로드](active-release-prefetch-policy.md): 최초 active release 전체 컨테이너, 업데이트 버전 추가 준비, K3s 선언 전환과 기존 인스턴스 보존 기준
- [노드 이미지 사전 다운로드 연동](node-image-prefetch.md): 문제별·전체 이미지 목록과 변경분 취합, 읽기 전용 Actions와 수집·다운로드·적용의 책임 경계
- [관리자 대시보드 검증·발행 연동](backend-publication-dispatch.md): 정확한 main SHA 발행 요청, run 추적·상태·산출물 조회, 기존 성공본 수집과 중복·재시도 책임
- [발행본 독립 Runtime 검증](published-runtime-smoke.md): 성공한 main 발행본의 출처 검증과 발행 실행에 영향을 주지 않는 단일 WEB 생성·삭제 시험
Expand Down
75 changes: 75 additions & 0 deletions docs/active-release-prefetch-policy.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,75 @@
# 운영 버전 기준 이미지 사전 다운로드

## 2026-10-27 운영 결정

최초 준비 대상은 **현재 운영 버전(active release)의 전체 컨테이너**입니다.
문제가 수정되면 검사·발행·등록한 새 버전의 전체 컨테이너를 추가로 준비합니다.
최신 발행본이라는 이유만으로 현재 운영 버전을 바꾸지 않습니다.

| 상황 | 사전 다운로드 대상 | 기존 버전 처리 |
|---|---|---|
| 최초 준비 | Backend가 확정한 문제별 active release의 전체 컨테이너 digest | 현재 active와 실행 중 인스턴스 유지 |
| 새 버전 등록 | 적용할 새 release의 전체 컨테이너 digest | 등록·준비만으로 active 변경하지 않음 |
| 새 버전 적용 | 승인된 대상 노드에서 준비를 확인한 새 release | 기존 참가자 인스턴스는 기존 release 유지 |
| 준비 실패·용량 부족 | 실패 원인과 노드별 결과를 표시하고 명시적으로 재시도 | 이번 자동 전환은 진행하지 않고 기존 운영 버전 유지 |
| 노드 추가·교체 | 해당 노드에 승인된 현재 운영 release와 적용 대기 release | 관측 전에는 준비 완료로 표시하지 않음 |

공개 컨테이너뿐 아니라 DB 등 비공개 보조 컨테이너도 포함합니다. `latest`나
tag를 노드에서 해석하지 않고, 해당 release에 저장된 GHCR digest를 그대로 사용합니다.
KOTH·Windows·정적 문제와 과거 전체 revision은 이번 일괄 준비 대상이 아닙니다.
별도로 승인한 롤백 버전을 추가 준비할 수 있지만, 과거 전체 이력을 받지는 않습니다.

## 최신 발행 목록과 운영 목록의 차이

`collect_node_image_plans.py`는 공식 main의 문제 소스와 일치하는 성공 발행본을
취합하는 **출처 대조 도구**입니다. Backend DB의 active release를 조회하지 않습니다.
따라서 이 도구가 만든 최신 목록을 그대로 현재 운영 버전 목록이라고 부르거나
일괄 활성화하지 않습니다. 기존 목록 형식이나 CI에 Backend 토큰을 추가하지 않습니다.

운영 대상 선택의 기준은 Backend의 실제 active release입니다. Backend는 자신의
release ID·revision과 원본 `artifact-v2.json`의 전체 컨테이너·architecture·실행
사양을 연결하고, Runtime이 허용한 target·용량 범위로 준비 요청을 구성합니다.
선택 범위와 기준 시각을 확인할 수 없으면 일괄 다운로드를 시작하지 않습니다.

보조 `plan.json`은 name·image 목록과 출처 대조에만 사용합니다. Runtime 요청이나
실제 현재 준비 상태, 실행 승인, Backend active 선택을 대신하지 않습니다.

## 업데이트와 적용 흐름

```text
문제 변경 -> main 검증·발행 -> GHCR digest + publish bundle
-> Backend가 새 release 등록 (기존 active 유지)
-> 승인된 새 release의 모든 컨테이너 준비 요청
-> Runtime이 대상 노드의 실행 CRI에서 다운로드·현재 상태 관측
-> 준비 결과를 확인한 관리자 적용 또는 승인된 준비 후 전환
-> 이후 새 인스턴스는 새 release 사용
-> 기존 인스턴스는 기존 release 사용
```

준비 후 자동 전환은 Backend [PR #178](https://github.com/MSG-CTF/msg-backend/pull/178)의
별도 선택 기능입니다. 이 문서만으로 해당 PR이 병합·배포되거나 운영 설정이 켜지지
않습니다. 원래 생성 경로의 미준비·관측 만료 시 pull fallback과, 이번 **자동 전환에
요구하는 준비 확인**은 서로 다른 조건입니다. 실제 실행의 승인·인증·격리는 계속 필수입니다.

여기서 무중단은 기존 인스턴스를 강제 종료하지 않는 버전 전환을 뜻합니다.
이미 실행 중인 프로세스나 TCP 세션까지 새 이미지로 교체하는 기능은 아닙니다.

## K3s 선언 전환

`misc-reqr`, `pwn-ghost-file`, `pwn-random6`도 K3s 운영 대상으로 전환합니다.
문제 저장소의 `info.yaml`을 `KUBERNETES`로 변경한 뒤 새 발행본을 등록해야 합니다.
과거 `DOCKER` bundle을 수정하거나 runtime_type 검사만 우회해 목록에 포함하지 않습니다.

PWN 문제는 `PWN` 격리 구분을 유지합니다. 선언 변경과 목록 생성만으로 PWN 실행을
승인하지 않습니다. FLAG, 실행 UID, 쓰기 경로, 시작 스크립트와 격리 조건은 문제별
Runtime 정책에서 확인해야 하며, CI가 임의로 root 실행이나 권한 완화를 추가하지 않습니다.

## 현재 확인 범위와 남은 연결

- DevSecOps의 전체 컨테이너 목록 생성·취합 caller는 병합됐습니다. 이는 운영 DB의 active 대조나 실제 전체 다운로드 완료를 뜻하지 않습니다.
- Runtime의 단일 WEB 시범에서는 실제 pull·Pod Ready·imageID·정리를 확인한 자료가 있습니다. 전체 운영 이미지와 Backend·Scheduler 운영 설정 설치 증거로 확대하지 않습니다.
- 실제 일괄 준비에는 Backend active 선택 결과, Runtime 준비 API 배포·전용 인증·허용 target·용량과 소비자 설정 적용 확인이 필요합니다.
- 새 버전 등록·추가 준비·기존 active 보존·준비 후 적용·기존 인스턴스 보존을 실제 환경에서 이어서 검증합니다.
- 다운로드나 목록 변경을 이유로 노드 캐시와 GHCR 이미지를 자동 삭제하지 않습니다. 실행·롤백·적용 대기 보호 목록을 합쳐 별도 리뷰한 삭제 절차만 사용합니다.

연결 책임과 파일 형식은 [노드 이미지 사전 다운로드 연동](node-image-prefetch.md)을 따릅니다.
62 changes: 37 additions & 25 deletions docs/node-image-prefetch.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,25 +2,31 @@

## 목표와 현재 범위

이번 변경은 검사를 통과한 publish bundle의 **이미지 목록·출처 대조 보조 도구**입니다.
이 저장소가 공급하는 것은 검사를 통과한 publish bundle의 **이미지 목록·출처 대조 보조 도구**입니다.
Backend 수집 버튼 연결, 준비 API 호출, 노드 작업, 준비 상태 저장은 구현하지 않습니다.
기존 수집·활성화 기능에 사전 다운로드 기능이 이미 있다고 가정하지 않습니다.

연동 기준은 Runtime [B안 계약 초안 PR #70](https://github.com/MSG-CTF/secure-provisioner/pull/70)의
`a7db66446c678e60bba49ee783d339de030e49a5`입니다. 이 PR도 Draft이며 문서·개발 검증
도구만 추가합니다. HTTP handler, worker, 노드 관측·pull, 새 설정의 구현·배포를
뜻하지 않습니다. 확정된 운영 API라고 표시하거나 제안 endpoint를 현재 서버에
호출하지 않습니다.
2026-10-27부터 최초 준비 범위는 **현재 운영 버전의 전체 컨테이너**, 업데이트 시에는
**승인된 새 버전의 전체 컨테이너 추가 준비**로 정리합니다.
[운영 버전 기준 정책](active-release-prefetch-policy.md)에 active 선택·기존 버전 보존과
K3s 선언 전환 기준을 기록했습니다. 이 취합 도구는 Backend active release를 조회하지
않으므로 최신 발행 목록을 현재 운영 목록으로 간주하지 않습니다.

Runtime [B안 계약 초안 PR #70](https://github.com/MSG-CTF/secure-provisioner/pull/70)을
기준으로 목록 계약을 만들었으며, 실제 준비 구현은
[Runtime PR #80](https://github.com/MSG-CTF/secure-provisioner/pull/80)에서 진행합니다.
단일 WEB의 실제 다운로드·실행 자료와 전체 운영 배포는 구분합니다. 준비 API의
운영 배포 SHA·전용 인증·허용 target·용량이 확인된 범위에서만 연결합니다.

B안에서 Backend는 승인된 release의 준비 요청·진행 추적을, Runtime은 실제
다운로드·관측·재시도를, Scheduler는 Broker 후보를 받은 뒤 준비 상태 일괄 조회와
준비된 target 우선순위를 담당합니다. Broker 후보·예약 API는 변경하지 않습니다.
DevSecOps는 기존 bundle과 보조 목록을 공급하며 노드 agent나 준비 API를 만들지 않습니다.

준비 상태는 성능 선호 조건이며, 준비 실패·미관측·만료·조회 장애만으로 release
활성화나 정상 생성을 차단하지 않습니다. 기존 생성·pull 경로를 유지하되, 실제
실행의 인증·digest 승인·격리·플랫폼·자원 검사는 계속 필수입니다. 별도 필수 준비
gate는 이번 계약에 포함하지 않습니다.
기존 생성 경로의 준비 상태는 성능 선호 조건입니다. 준비 실패·미관측·만료·조회
장애 시 기존 생성·pull 경로를 유지하되 실제 인증·digest 승인·격리·플랫폼·자원
검사는 필수입니다. 이와 별도로 Backend의 선택적 **준비 후 자동 활성화**는 현재
준비 확인 전까지 이전 active를 유지하는 계약이며, 기존 생성 fallback과 혼동하지 않습니다.

## 수집과 적용 흐름

Expand All @@ -29,10 +35,10 @@ gate는 이번 계약에 포함하지 않습니다.
-> GHCR digest 이미지 + publish bundle
-> 관리자 수집 또는 Backend Poller
-> 출처 검증과 새 release 등록 (기존 active 유지)
-> Backend가 Runtime에 승인된 release의 준비 작업 요청 [추가 구현·배포 필요]
-> Runtime이 노드별 다운로드·전체 이미지 검증·관측 [추가 구현·배포 필요]
-> Backend가 Runtime에 승인된 release의 준비 작업 요청 [운영 설정·연동 검증 필요]
-> Runtime이 노드별 다운로드·전체 이미지 검증·관측 [전체 운영 대상 검증 필요]

관리자 active 전환은 별도 운영 동작 (준비 실패만으로 차단하지 않음)
관리자 active 전환 또는 별도 승인한 준비 후 전환 (등록만으로 전환하지 않음)
-> Backend가 선택된 release의 실행 정보를 Scheduler에 전달
-> Broker 후보 조회와 기존 예약 경로 유지
-> Scheduler가 Runtime 준비 상태를 조회해 같은 위험도 안에서 준비 target 선호
Expand All @@ -41,7 +47,7 @@ gate는 이번 계약에 포함하지 않습니다.
```

수집 자체를 이미지 실행이나 자동 활성화로 해석하지 않습니다. 자동 다운로드는
위 연동 구현 후 수집에 연결하며, 참가자 문제 인스턴스를 미리 전부 생성하는
실제 배포된 연동과 승인 범위로 수집에 연결하며, 참가자 문제 인스턴스를 미리 전부 생성하는
기능이 아닙니다. 파일 생성이나 작업 접수만으로 준비 완료를 표시하지 않습니다.

## B안 요청과 보조 목록의 구분
Expand Down Expand Up @@ -182,7 +188,8 @@ python3 -B -m scripts.collect_node_image_plans \
문제 저장소에서 `.github/workflows/node-image-prefetch.yml`이라는 수동 caller로
호출하는 예시는 [caller 예시](node-image-prefetch-caller-example.yml)에 있습니다.
두 SHA placeholder는 리뷰·병합된 동일한 실제 commit으로 교체해야 합니다.
이번 PR은 예시만 제공하며 실제 문제 저장소의 caller를 수정하지 않습니다.
실제 문제 저장소의 caller는 [PR #101](https://github.com/MSG-CTF/2026_MSG_CTF/pull/101)로
적용됐습니다. 목록 caller 성공은 노드 다운로드 완료나 Backend active 조회 성공이 아닙니다.

공식 문제 저장소의 수동 main 호출만 허용하고, source 저장소 자신의
`GITHUB_TOKEN`에 `contents: read`, `actions: read`만 사용합니다. 별도 PAT,
Expand Down Expand Up @@ -217,8 +224,9 @@ CI에 SSH·root 권한, kubeconfig 또는 GHCR pull 토큰을 새로 전달하
4. 기존 인스턴스와 reset은 원래 release 계약을 유지합니다. 강제 재시작하지 않습니다.
5. A는 실행 중 인스턴스와 승인된 롤백이 참조하는 동안 삭제하지 않습니다.

준비가 실패했다는 이유만으로 3번을 막는 기능은 이번 범위에 넣지 않습니다.
실제 생성 시에는 캐시 여부와 무관하게 digest 승인과 실행 보안 조건을 검사합니다.
준비 후 자동 전환을 사용하는 경우에는 준비 실패 시 이전 active를 유지합니다.
이 전환 기능은 Backend PR #178의 별도 리뷰·배포·활성화가 필요합니다.
기존 생성의 pull fallback을 변경하지 않으며 캐시 여부와 무관하게 실행 보안 조건을 검사합니다.

이 방식은 기존 참가자 세션을 유지하는 버전 전환입니다. 이미 실행 중인
인스턴스까지 새 이미지로 실시간 교체하는 무중단 배포를 보장하지 않습니다.
Expand All @@ -235,7 +243,7 @@ CI에 SSH·root 권한, kubeconfig 또는 GHCR pull 토큰을 새로 전달하
| Scheduler | Broker 후보 조회 후 Runtime 준비 상태 일괄 조회, 준비 target 선호, 장애 시 기존 예약·생성 흐름 유지 |
| Broker | 기존 후보·예약 API 유지, 후보 target과 Runtime Registry 매핑 확인 |

다음은 #70 초안의 합의·구현·배포가 더 필요한 항목입니다. 다른 팀의 API나 privileged
다음은 각 담당 구현의 실제 배포·설정·통합 검증을 확인할 항목입니다. 다른 팀의 API나 privileged
에이전트를 DevSecOps 저장소에서 임의로 만들지 않습니다.

- 제안된 준비·조회·retry API와 Backend 전용 인증 권한. CI smoke 토큰을 준비 권한으로 재사용하지 않음
Expand Down Expand Up @@ -265,8 +273,11 @@ CI에 SSH·root 권한, kubeconfig 또는 GHCR pull 토큰을 새로 전달하
7. 인증 실패·디스크 부족·부분 실패·새 노드에서도 거짓 준비 완료가 나오지 않는지 확인합니다.
8. 미준비·만료·준비 조회 장애 시 기존 생성·pull 경로를 유지하고, 실제 보안 거절은 유지되는지 확인합니다.

현재는 위 노드 다운로드·자동 적용 연동을 수행한 상태가 아닙니다. 기존
Open House 생성·삭제 성공 기록은 cold pull이나 이번 자동화 검증으로 재사용하지 않습니다.
2026-10-27 수령한 Runtime 시범 자료에서는 단일 WEB의 실제 pull 3.786초,
Pod Ready·imageID 일치·캐시 재사용·시험 리소스 정리를 확인했습니다.
전체 현재 운영 버전의 일괄 준비, Backend·Scheduler 운영 설정 설치와 자동 전환은
이 시범으로 검증됐다고 계산하지 않습니다. 기존 Open House 생성·삭제 기록도
cold pull이나 새 자동화 검증으로 재사용하지 않습니다.

## 기존 목록 검증 기록

Expand All @@ -276,17 +287,18 @@ Open House 생성·삭제 성공 기록은 cold pull이나 이번 자동화 검
- 출력의 이미지가 원본 bundle의 정확한 digest와 일치하고 원본 파일 hash가 보존됨
- 실제 workflow의 목록 생성 셸 실행과 기존 Poller의 파일 선택 방식 호환 확인
- 실제 일반 동적 문제 18개 중 K3s 지원 15개·컨테이너 이미지 22개 취합
- `misc-reqr`, `pwn-ghost-file`, `pwn-random6`는 현재 `DOCKER` 선언이므로
K3s 목록에서 별도 분류하며 실행 방식을 임의로 바꾸지 않음
- 당시 `misc-reqr`, `pwn-ghost-file`, `pwn-random6`는 `DOCKER` 선언이어서 별도 분류함.
2026-10-27 K3s 전환 결정 이후에도 문제 저장소 변경과 새 bundle 발행 전까지 과거 목록은 그대로 보존
- 전체 일반 문제 30개와 정적 12개, KOTH·Windows 제외를 구분해 보고

위 결과는 기존 PR 검증 당시의 기록입니다. 현재 전체 문제·노드 상태를 다시
조회하거나 실제 다운로드한 결과로 재표기하지 않습니다. 최신 main 병합 후의
회귀 테스트와 CI는 PR 본문에 별도 기록합니다.

새 취합 workflow는 reusable 코드와 caller 예시만 준비한 상태입니다. 실제 문제
저장소의 수동 caller 적용과 해당 경로의 Actions 실행은 리뷰·병합 후 진행합니다.
PR 자체 CI와 로컬 실제 bundle 취합 성공을 새 caller의 운영 실행 성공으로 기록하지 않습니다.
이후 중앙 PR #26과 문제 저장소 PR #101이 병합됐고, 실제 수동 main 취합 run
`40333744581` 및 이전 artifact를 사용한 재취합 run `40334270971`이 성공했습니다.
당시 일반 K3s 문제 15개·이미지 22개를 대조했으며 추가·변경·제외는 0개였습니다.
이는 발행 목록 검증이며 Backend active 선택이나 현재 전체 노드 준비 완료는 아닙니다.

이 결과는 목록 생성 검증입니다. 실제 Backend 수집, 노드 다운로드, 캐시 hit,
Runtime HTTP 접속이나 무중단 교체 성공을 의미하지 않습니다.
Expand Down
Loading
Loading