51 lines
3.6 KiB
Markdown
51 lines
3.6 KiB
Markdown
# TREX REL-012 운영팀 배포 요청 근거
|
|
|
|
- 대상: 운영팀 (`trex-op`)
|
|
- 작성일: 2026-07-17
|
|
- 상태: **긴급 배포 사전 근거 및 실행 요청 준비 — source publication / production approval 대기**
|
|
|
|
> 이 문서는 운영팀용 요약이다. 실제 실행은 immutable remote source에 존재하는 REL-012 및 deployment runbook만 따른다. 이 문서는 deployment approval 또는 execution completion이 아니다.
|
|
|
|
## 1. 결론
|
|
|
|
BAT-058은 independent QC-7 `PASS-WITH-NOTES`를 수용해 batch verification을 완료했고, REL-012 긴급 릴리즈 초안을 준비했다. 코드가 현재 delivery worktree에만 존재하여 **배포 가능한 immutable target SHA는 아직 없다**. 따라서 운영팀은 지금 배포를 시작하지 말고, 아래 source-publication gate가 해소된 뒤에만 preflight를 시작한다.
|
|
|
|
## 2. 배포 전 근거와 원본
|
|
|
|
| 순서 | Release | 배포 대상 source/artifact | 비운영 근거 | 실행 전 남은 gate | immutable 원본 링크 |
|
|
| --- | --- | --- | --- | --- | --- |
|
|
| 1 | REL-012 / BAT-058 | `PENDING_COMMIT_AND_PUSH` | QC-7: focused `113 passed`, full `833 passed, 47 skipped`; release-prep full regression `833 passed, 47 skipped`; focused Ruff/compileall PASS | immutable SHA publish·remote tree 확인·release execution approval·window·host preflight | **PENDING** — git-ops 검증 후 commit-URL만 삽입 |
|
|
|
|
원본 문서(현재 release candidate worktree):
|
|
|
|
- REL draft: [`REL-012`](../releases/rel-012_20260717_cost-basis-safe-sync-seed-hotfix.md)
|
|
- 운영 runbook: [`REL-012 deployment runbook`](rel-012-cost-basis-safe-sync-seed-deployment.md)
|
|
- batch verification: [`BAT-058 verification`](../batches/bat-058_20260716_cost-basis-safe-sync-seed/verification.md)
|
|
|
|
## 3. 승인 후 실행 순서
|
|
|
|
1. **Git-ops / lead** — reviewed source와 REL/runbook을 commit·push하고 exact remote SHA 및 immutable commit URLs를 검증·전달한다.
|
|
2. **운영팀** — 승인된 장외 window에 `ROLLBACK_REVISION`, clean checkout, unchanged config/credential mode, dependency/migration delta를 preflight에 기록한다.
|
|
3. **운영팀** — approved supervisor로 동일 config의 trex-core daemon을 target SHA로 재기동한다.
|
|
4. **운영팀** — startup acceptance 후 `sync --all --dry-run --json` 및 `verify --json`만 수행하고 runbook evidence template을 반환한다.
|
|
5. **팀장** — evidence를 검토해 `confirm-release` 여부를 판정한다.
|
|
|
|
어느 단계에서든 stop condition이면 즉시 rollout을 멈추고 captured `ROLLBACK_REVISION`으로 되돌린다. `sync --live`는 이 배포 요청의 범위가 아니다.
|
|
|
|
## 4. 핵심 주의사항 / 중단 조건
|
|
|
|
- 허용 범위: daemon restart, startup/log inspection, `sync --dry-run`, `verify`.
|
|
- 금지 범위: `sync --live`, `--yes` live write, 자동 remediation, 주문 명령, DB/스키마 변경, config/credential/break-glass 변경, AMQP topology 변경.
|
|
- target SHA가 정확하지 않거나 dirty checkout, dependency/migration delta, startup error/traceback, unexpected write indication, fail-closed 위반, unsafe empty-balance 해석이 있으면 **중단 및 rollback**.
|
|
- token, secret, account number, DSN, raw broker/portfolio payload를 전달서 또는 증적에 기록하지 않는다.
|
|
|
|
## 5. 운영팀 반환 증적
|
|
|
|
runbook의 evidence template을 작성해 아래만 전달한다.
|
|
|
|
- approver/window/operator 및 redacted host/instance identifier
|
|
- target SHA와 `ROLLBACK_REVISION`
|
|
- clean-checkout·dependency/migration preflight 결과
|
|
- daemon restart/startup·dry-run·verify의 secret-free 결과
|
|
- no-write/fail-closed 관찰 결과, rollback 여부와 사유/복구 SHA
|