Files
QuantEngineByItz/docs/GITEA_TOKEN_HOME_RUNBOOK.md
T
kjh2064 a5493142f9
Quant Engine CI/CD Pipeline / validate-core (push) Failing after 13s
Quant Engine CI/CD Pipeline / validate-ui-and-storage (push) Has been skipped
Deploy to Production / Build & Deploy to Production (push) Failing after 2m27s
docs/tools: Gitea token home & PR harness 검증 도구 개선
- docs/GITEA_TOKEN_HOME.md: 토큰 홈 설정 문서 업데이트
- docs/GITEA_TOKEN_HOME_RUNBOOK.md: 런북 보완
- docs/GITEA_VARIABLES_FAILURE_ANALYSIS.md: 실패 분석 문서 수정
- docs/GITEA_VARIABLES_RUNBOOK.md: 변수 런북 수정
- tools/validate_gitea_pr_harness_v1.py: PR 하네스 검증 스크립트 개선
- tools/validate_gitea_token_home_v1.py: 토큰 홈 검증 스크립트 개선
2026-07-06 17:15:21 +09:00

1.5 KiB

GITEA_TOKEN_TAXBAIK Runbook

1. Confirm presence

Check that GITEA_TOKEN_TAXBAIK is set in the shell that runs the harness.

2. Validate read-only access

python tools/validate_gitea_token_home_v1.py

Expected:

  • gate = PASS
  • repo access works
  • workflow metadata is readable

3. Dispatch smoke test

python tools/validate_gitea_token_home_v1.py --dispatch --workflow kis_data_collection.yml --ref main

Expected:

  • dispatch returns 204 or 201
  • latest run is visible in the API
  • run status becomes visible in the response payload

4. If it fails

  • GITEA_TOKEN_TAXBAIK missing or empty: environment is not configured
  • 401 Unauthorized: token is wrong or lacks repo scope
  • 404 Not Found: repo or workflow path mismatch
  • latest_run_missing: dispatch accepted, but run listing lagged behind
  • queued or long in_progress: runner is busy or the job is waiting for the self-hosted runner slot

5. Evidence to capture

  • Harness JSON output
  • Workflow run URL
  • Failing step name if the dispatched run fails
  • Runner status from the API if the job stays queued

Current run 161 finding

  • Checkout Code failed before Python started.
  • The repository checkout did not contain GatherTradingData.json.
  • This means the next fix is not token-related; it is seed-file availability at workflow runtime.
  • The workflow is now updated to regenerate the JSON from GatherTradingData.xlsx when possible and to fail with explicit recovery instructions when both are missing.