Skip to content

관리자 발행 SHA·재실행 artifact·응답 유실 복구 계약 명확화 - #28

Merged
wlsdnd2367 merged 1 commit into
mainfrom
docs/publication-retry-contract
Oct 26, 2026
Merged

wlsdnd2367 merged 1 commit into
mainfrom
docs/publication-retry-contract

Conversation

@wlsdnd2367

Copy link
Copy Markdown
Collaborator

작업 설명

Backend 관리자 발행 연동 요청의 최종 계약 세 항목을 기존 문서에 명확히 추가했습니다. 문서 한 파일만 수정했으며 workflow·입력·검사 코드·운영 설정은 변경하지 않습니다.

보완 내용

  1. 새 발행의 expected_source_sha == workflow_run.head_sha == bundle.source_sha 검증과 기존 성공본 수집의 차이를 명시했습니다. 소스 SHA와 DevSecOps·workflow 정의 SHA를 구분합니다.
  2. 재실행 시 run ID·run number·revision은 유지되고 run_attempt는 증가한다는 기준을 기록했습니다. artifact 이름의 scope attempt는 validate job 시점의 값이며 업로드 attempt라고 단정하지 않도록 설명했습니다. 명시적 artifact ID, 출처 검증, 다중 후보 충돌, 기존 revision 덮어쓰기 금지를 구분합니다.
  3. dispatch 전에 저장한 요청 UUID를 전체 run 제목과 receipt에 연결하고, 응답 유실 시 공식 workflow·main·SHA·시간대·정확한 제목으로 복구하는 기준을 기록했습니다. 미확인 요청을 즉시 재전송하거나 최신 run을 추측하지 않습니다.

역할·적용 범위

  • PR #27은 병합 완료입니다.
  • 실제 caller 적용은 문제 저장소 PR #99입니다. 운영 관리자 발행은 caller 적용·Backend 연결 검증 전까지 비활성으로 유지합니다.
  • 이 PR은 문서 전용이므로 #99의 승인된 도구 SHA 참조 7곳을 다시 바꾸지 않습니다.
  • Backend 요청 DB의 중복 방지·접수 미확인 상태·응답 유실 복구는 Backend 구현·통합 테스트 항목입니다. 이번 변경으로 구현 완료했다고 표시하지 않습니다.
  • 기존 성공본 GET 수집과 기존 main push CI를 끄지 않습니다. 새 발행·활성화·노드 다운로드·이미지 삭제는 실행하지 않았습니다.

검증

  • 기존 요청 검사 단위 테스트 14개 통과
  • 문서 JSON 예시 2개의 구문·필수 입력 필드 확인
  • 실제 중앙 workflow의 validate scope 생성, run_number revision 연결과 #99의 request ID 전달을 대조
  • GitHub 공식 재실행·context 정의와 대조
  • git diff --check 통과
  • 문서만 변경되어 기존 workflow의 paths 조건상 새 build·scan CI를 요구하지 않습니다. 기존 중앙 251개·caller 19개 통과 기록을 새 실행 결과로 재표기하지 않습니다.

@jongcoding jongcoding left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

요청 SHA 검증이랑 재실행·응답 유실 처리까지 현재 caller·백엔드 코드와 맞는 것 확인했습니다
문서 쪽 추가 수정 사항은 못 찾았습니다 실제 운영 발행은 별도 검증이 필요합니다

@wlsdnd2367
wlsdnd2367 merged commit 733457f into main Oct 26, 2026
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