Skip to content

Challenge Registry publish bundle 계약 강화 - #7

Merged
wlsdnd2367 merged 8 commits into
mainfrom
registry-integration
Sep 7, 2026
Merged

wlsdnd2367 merged 8 commits into
mainfrom
registry-integration

Conversation

@wlsdnd2367

@wlsdnd2367 wlsdnd2367 commented Sep 1, 2026 •

Copy link
Copy Markdown
Collaborator

작업 내용

  • publish bundle의 공식 파일인 artifact-v2.json에 registry_revision, 전체 containers, isolation_profile, 선택형 internal_connections를 보존합니다.
  • 최종 이미지는 ghcr.io/msg-ctf/challenges/<slug>/<container>@sha256:<digest> 형식으로 고정하며 tag와 latest를 허용하지 않습니다.
  • Actions artifact 이름을 -publish-bundle suffix로 발행해 Backend poller가 수집할 수 있게 합니다.
  • registry-publish.json은 수동 검증용 { "artifact": <artifact-v2> } wrapper로만 생성합니다.
  • Runtime smoke 요청에도 internal_connections를 손실 없이 보존합니다.

운영 계약

  • DevSecOps는 검증된 GHCR digest image와 artifact-v2.json publish bundle 발행까지만 담당합니다.
  • Backend poller가 성공한 Actions artifact를 수집해 challenge 매핑, release 등록, 같은 registry_revision의 중복 처리를 담당합니다.
  • active release 전환과 rollback은 Backend/admin이 별도로 담당합니다.
  • reusable workflow에는 Backend 직접 API 호출, publish_registry, Registry URL/token, Idempotency-Key, 자동 활성화가 없습니다.
  • 혼합 public/private port와 internal_connections는 소비자 계약이 확정될 때까지 bundle 원형을 유지합니다.

검증 결과

  • GitHub Actions: 문제 공급망 파이프라인 자체 검증 #33977329275 성공
  • Python 단위 테스트: 67개 PASS
  • Python 문법 검사: PASS
  • Gitleaks: PASS
  • info.yaml 및 Docker build context 검증: PASS
  • web build image의 Trivy vulnerability/secret scan과 CycloneDX SBOM 생성: PASS
  • helper 외부 image pull 및 파이프라인 실행: PASS
  • helper image의 Trivy vulnerability 결과는 지원되는 검사 대상이 없어 Not scanned로 기록됐으므로 취약점 검증 완료로 간주하지 않음
  • feature branch 실행이므로 main 전용 GHCR publish job은 의도적으로 skipped

후속 연동

  • 이 PR 병합 후 2026_MSG_CTF caller의 reusable workflow SHA와 devsecops_ref를 병합 커밋으로 갱신합니다.
  • 같은 caller에서 삭제된 publish_registry, CHALLENGE_REGISTRY_URL, CHALLENGE_REGISTRY_TOKEN 전달을 제거합니다.
  • Backend에는 internal_connections 검증·DB 저장·조회·Scheduler 전달 지원이 필요합니다.
  • 운영 E2E는 GHCR publish, 최초 release 등록, 동일 bundle 재수집 중복 방지, 새 revision 등록 후 기존 active 유지, Runtime 배포까지 확인해야 완료입니다.

이 PR은 자동 병합하지 않습니다.

@jongcoding

Copy link
Copy Markdown
Contributor

지금은 머지 보류가 맞습니다
현재 workflow는 registry-publish.json을 그대로 보내지만 백엔드 PR #26은 challenge_id가 들어간 URL과 artifact wrapper를 요구합니다
직접 대조했을 때 workflow 본문은 백엔드에서 거절됐고 artifact wrapper만 통과했습니다
activate true도 백엔드의 등록·활성화 분리 명세와 맞지 않고 Idempotency-Key도 백엔드가 아직 처리하지 않습니다
URL, challenge_id, 본문, 인증, 재전송, 활성화 방식을 백엔드와 한 계약으로 먼저 맞춰주세요
포트 공개 범위도 info.yaml과 Runtime은 컨테이너 단위인데 Registry는 포트 단위라 8080 공개, 9090 비공개 같은 구성을 현재는 손실 없이 전달할 수 없습니다
혼합 포트 한 건을 기준으로 Backend 등록과 Runtime 변환이 모두 통과하는 계약 테스트까지 있어야 합니다

@wlsdnd2367

wlsdnd2367 commented Sep 2, 2026 •

Copy link
Copy Markdown
Collaborator Author

리뷰 기준으로 Backend PR #26과 Runtime dev 계약을 다시 대조했습니다.

확인된 등록 계약은 다음과 같습니다.

  • URL: POST /api/v1/admin/challenges/{challenge_id}/releases
  • 본문: {"artifact": <artifact-v2.json>, "note": ...}
  • 인증: 현재 PR 문제 이미지 사전 다운로드 목록과 전체 취합·변경 검증 #26 구현 기준 관리자 Bearer access token
  • 재전송: 같은 registry_revision은 409 RELEASE_DUPLICATED; Idempotency-Key 처리는 없음
  • 활성화: 등록 API와 분리된 POST .../releases/{release_id}/activate

따라서 PR #7에서는 registry-publish.json 직접 전송, activate: true, Idempotency-Key, POST 자동 재시도를 제거하고 위 계약으로 맞추겠습니다. CI는 릴리스 등록까지만 수행하고 활성화는 운영자 단계로 남기겠습니다.

다만 구현 전에 두 계약이 추가로 필요합니다.

  1. 현재 문제 저장소 info.yaml과 publish bundle에는 Backend UUID challenge_id가 없습니다. 출제자 파일에 Backend UUID를 넣는 방식, 별도 slug-to-UUID 운영 매핑, Backend의 slug 기반 등록/poller 중 어떤 방식을 기준으로 할지 결정이 필요합니다.
  2. Registry는 ports[].public을 지원하지만 Runtime dev 계약은 ports: [int]와 컨테이너 단위 expose입니다. 같은 컨테이너의 8080 public/9090 private를 손실 없이 변환하려면 Runtime 계약 확장이 필요합니다. DevSecOps에서 Runtime DTO를 임의로 변경하지 않고, 확정된 DTO를 받은 뒤 혼합 포트 Backend 등록 및 Runtime 변환 계약 테스트를 추가하겠습니다.

위 두 항목의 기준이 정해지면 PR #7에 테스트부터 반영하겠습니다.

@wlsdnd2367

Copy link
Copy Markdown
Collaborator Author

Backend poller 방식으로 PR을 최신화했습니다.

변경 사항

  • reusable workflow의 Backend 직접 API push job과 URL/token 입력 제거
  • artifact-v2.json을 Backend poller의 공식 수집 입력으로 유지
  • registry-publish.json을 { "artifact": artifact-v2 } 수동 호환 wrapper로 단순화
  • 문제 저장소 caller와 self-test에서 publish_registry 및 Registry secret 전달 제거
  • release 등록/중복 처리는 Backend poller, active 전환/롤백은 Backend/admin 소유로 문서화
  • 혼합 public/private 포트는 Runtime DTO 확정 전까지 bundle에 원형 보존
  • 문서 계약 회귀 테스트 추가

검증 결과

  • Python unittest: 67개 PASS
  • python3 -m py_compile scripts/*.py: PASS
  • git diff --check: PASS
  • Gitleaks: 61 commits scanned, no leaks
  • publish wrapper/digest/PASS gate 계약 테스트: PASS
  • 최종 독립 리뷰: Approved, P0-P3 finding 없음

운영 E2E에서 남은 확인

  • Backend poller가 실제 Actions artifact를 수집해 최초 release 등록
  • 같은 registry_revision 재수집 시 duplicate 처리
  • 등록만으로 active release가 바뀌지 않는지 확인
  • Runtime의 혼합 public/private 포트 DTO 확정 후 smoke 계약 보강

자동 merge는 하지 않았습니다.

@jongcoding

Copy link
Copy Markdown
Contributor

백엔드 직접 전송과 자동 활성화를 빼고, 백엔드가 Actions 산출물을 가져가는 방식으로 변경한 부분 확인했고 로컬 단위 테스트도 67개 통과했습니다
아래 내용만 같이 정리 부탁드립니다

  1. 실제 문제 저장소에도 새 방식 적용 필요
    2026_MSG_CTF 저장소의 워크플로는 아직 이전 DevOps 커밋을 사용하고 있고, 삭제된 publish_registry 입력과 Registry URL/token도 남아 있습니다
    Challenge Registry publish bundle 계약 강화 #7 머지만으로 실제 문제 빌드에 새 방식이 적용되지는 않으니, 병합 후 사용하는 커밋과 devsecops_ref를 같이 갱신해주세요
    이때 삭제된 입력과 시크릿 전달도 함께 제거해야 합니다
    별도 PR로 진행해도 되니 적용 작업을 연결해주시면 좋겠습니다
    현재 문제 저장소 워크플로
  2. 컨테이너 간 연결 설정은 백엔드 쪽 수정 필요
    이번 코드로 만든 산출물을 백엔드 검증 함수에 넣어보니 containers와 revision은 유지되는데, internal_connections는 처리 결과에서 빠지는 걸 확인했습니다
    DevOps 산출물과 Runtime 요청에는 해당 값이 들어가므로, 이 부분은 DevOps 생성 로직 문제가 아니라 백엔드에서 수정할 내용입니다
    백엔드 담당자와 연결해서 검증, DB 저장, Scheduler 전달까지 이어지도록 확인 부탁드립니다
    수정 후에는 web → db 연결 설정이 포함된 산출물을 등록하고, DB에서 다시 읽어도 같은 설정이 남아 있는지 테스트가 필요합니다
    백엔드에서 연결 설정이 빠지는 부분
  3. PR 설명과 최신 CI 결과 정리
    PR 본문에는 아직 백엔드 직접 전송, Idempotency-Key, publish_registry 설명이 남아 있어서 현재 코드와 다르게 읽힙니다
    본문도 백엔드가 산출물을 수집하고, 활성화는 관리자가 별도로 하는 방식으로 맞춰주세요
    현재 커밋 기준 GitHub Actions 결과도 한 번 남겨주시면 좋겠습니다
    로컬 테스트는 통과했지만, 실제 산출물 수집과 DB 등록까지 검증된 상태는 아닙니다
    연동 확인할 때는 정상 등록, 같은 산출물 재수집 시 중복 방지, 새 revision 등록 후 기존 active 유지까지 같이 보면 될 것 같습니다

@wlsdnd2367

Copy link
Copy Markdown
Collaborator Author

리뷰 기준으로 정리했습니다.

  • PR 본문을 Backend poller가 Actions artifact의 artifact-v2.json을 수집하고 Backend/admin이 active release를 별도 전환하는 현재 계약으로 수정했습니다.
  • Backend 직접 전송, publish_registry, Registry URL/token, Idempotency-Key, 자동 활성화 설명을 제거했습니다.
  • 현재 HEAD 9163902로 GitHub Actions 자체 검증을 실행했습니다. 67개 단위 테스트, Python 문법 검사, Gitleaks, 명세 검증, web/helper build·Trivy·SBOM이 통과했습니다. feature branch라 main 전용 publish job은 의도적으로 skipped 됐습니다.
  • internal_connections의 Backend validator·DB·Scheduler 전달 누락은 Backend PR #26에 재현 형태와 수용 기준을 전달했습니다.

2026_MSG_CTF caller는 이 PR의 병합 커밋이 확정된 뒤 별도 PR에서 reusable workflow SHA와 devsecops_ref를 함께 갱신하고, 삭제된 입력과 Registry secret 전달을 제거하겠습니다. 현재는 PR #7이 미병합이라 임시 branch SHA로 운영 caller를 고정하지 않았습니다.

운영 poller E2E인 최초 등록, 동일 revision 재수집, 새 revision 등록 후 active 유지 검증은 Backend 수정·병합 후 이어서 확인하겠습니다.

@jongcoding

Copy link
Copy Markdown
Contributor

DevOps는 이미지와 배포 정보를 만들고, 백엔드는 수집·등록을 담당하는 것으로 본문 정리된 것 확인했습니다
최신 커밋 기준 CI와 테스트 67개 통과, 백엔드에 연결 설정 관련 요구사항 전달한 것도 확인해서 기존 설명과 CI 관련 요청은 해결로 볼게요
남은 건 아래처럼 후속 작업으로 챙겨주시면 됩니다

  1. PR Challenge Registry publish bundle 계약 강화 #7 병합 후 문제 저장소 적용
    호출 워크플로의 커밋과 devsecops_ref를 같이 변경하고, 더 이상 받지 않는 publish_registry 입력과 Registry 관련 시크릿 전달도 같이 정리해주세요
  2. 백엔드 연결 정보 보존
    internal_connections가 백엔드 처리 과정에서 빠지는 부분은 아직 남아 있습니다
    이건 백엔드 쪽 수정 사항이고, 전달하신 기준대로 저장부터 Scheduler 요청까지 유지되는지 확인이 필요합니다
  3. 실제 배포 연동 확인
    이번 CI에서는 이미지 발행 단계가 건너뛰어져서 GHCR 발행부터 백엔드 수집·등록, Runtime 배포까지 확인된 건 아닙니다
    문제 저장소 적용 후 이 흐름이 연결되는 실행 결과를 남겨주세요
    추가로 helper 이미지 취약점 검사에는 Not scanned가 찍혀 있어서, 이 부분은 취약점 검증 완료로 기록하지 않으면 됩니다
    이번 PR에서 요청드렸던 보완은 확인됐고, 위 후속 작업까지 끝나면 전체 연동 기준으로 다시 확인할게요

@wlsdnd2367

Copy link
Copy Markdown
Collaborator Author

후속 작업 범위를 확인했습니다.

  • PR 본문의 helper 이미지 검증 결과를 실제 로그에 맞게 정정했습니다. helper 파이프라인 단계는 성공했지만 Trivy vulnerability 결과는 Not scanned이므로 취약점 검증 완료로 기록하지 않습니다.
  • PR Challenge Registry publish bundle 계약 강화 #7 병합 후 2026_MSG_CTF에 별도 PR을 올려 reusable workflow SHA와 devsecops_ref를 갱신하고, 삭제된 publish_registry 입력 및 Registry URL/token 전달을 제거하겠습니다.
  • internal_connections는 Backend 수정 후 DB 보존과 Scheduler 전달까지 연동 확인하겠습니다.
  • 이후 GHCR publish -> Backend poller 수집/등록 -> Runtime 배포 실행 결과를 남기겠습니다.

현재 PR은 자동 병합하지 않고 리뷰/병합을 기다립니다.

@wlsdnd2367

Copy link
Copy Markdown
Collaborator Author

최신 head 9163902 기준 문제 공급망 자체 검증을 다시 실행했고 성공했습니다.

  • 실행 결과: https://github.com/MSG-CTF/msgctf-devsecops/actions/runs/34079636611
  • 단위 테스트·Python 문법 검사 성공
  • info.yaml/build context/Gitleaks 검증 성공
  • web/helper image build·Trivy vulnerability/secret scan·CycloneDX SBOM 생성 성공
  • sample/KOTH publish job은 branch 수동 실행이라 의도적으로 skipped

이 PR이 병합되면 stacked PR #6의 base를 main으로 변경해 Runtime 계약 변경분을 최종 검토할 수 있습니다. 자동 병합은 하지 않고 리뷰·병합을 기다리겠습니다.

@jongcoding

Copy link
Copy Markdown
Contributor

수정본 확인했습니다

공개 포트 목록 검사랑 exposed_ports 변환은 반영됐고, revision 확인이나 내부 연결 전달도 확인했습니다

두 군데만 더 봐주세요

첫 번째는 endpoint 응답 검사입니다
protocol이 문자열이 아닌 경우에는 타입 오류로 끝나면서 뒤에 있는 삭제 요청을 건너뜁니다
타입 검사 먼저 넣어주시고, 응답 검증에 실패해도 이미 생성된 workload는 삭제까지 진행되게 해주세요
현재 Runtime이 이런 응답을 준다는 뜻은 아니고, 이번에 추가한 잘못된 응답 처리에서 빠진 경우입니다

두 번째는 PWN 검증입니다
지금은 공개 컨테이너마다 포트가 1개인지만 보는데, 공개 컨테이너 자체도 정확히 1개여야 합니다
컨테이너 2개가 포트를 하나씩 공개하면 DevSecOps에서는 통과하고 Runtime에서 거절됩니다
기존에도 있던 부분이라 이번 PWN 검증 수정하면서 info 검증과 요청 변환 양쪽에 같이 넣어주시면 될 것 같습니다

추가로 로컬 테스트에서 삭제 제한이 50ms인 항목이 타임아웃 났습니다
테스트용 제한만 1초로 늘리면 통과해서 운영 버그보다는 테스트 시간 설정 문제로 보고 있습니다
이 부분도 환경 따라 흔들리지 않게 조정 부탁드립니다

실제 K3s 검증은 아직 안 한 것으로 확인했습니다
#7 먼저 머지하고 #6 base를 main으로 바꾼 뒤 최종 CI 다시 확인해주세요
smoke는 Runtime #39 반영 버전이 배포되고 노드 토큰 준비된 다음 켜면 될 것 같습니다

@wlsdnd2367
wlsdnd2367 merged commit ac5a5a8 into main Sep 7, 2026
12 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants