kjh2064
a5493142f9
- 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: 토큰 홈 검증 스크립트 개선
44 lines
1.2 KiB
Markdown
44 lines
1.2 KiB
Markdown
# GITEA_TOKEN_TAXBAIK
|
|
|
|
`GITEA_TOKEN_TAXBAIK` is the local API token used to validate and optionally dispatch Gitea Actions from this workspace.
|
|
|
|
## Purpose
|
|
|
|
- Read repository metadata
|
|
- Confirm workflow access
|
|
- Optionally trigger a workflow dispatch
|
|
- Poll the latest run for evidence
|
|
|
|
## Harness
|
|
|
|
Use:
|
|
|
|
```bash
|
|
python tools/validate_gitea_token_home_v1.py
|
|
```
|
|
|
|
To dispatch the KIS collector workflow as a smoke test:
|
|
|
|
```bash
|
|
python tools/validate_gitea_token_home_v1.py --dispatch --workflow kis_data_collection.yml --ref main
|
|
```
|
|
|
|
## Expected behavior
|
|
|
|
- Without `GITEA_TOKEN_TAXBAIK`, the harness exits with `GITEA_TOKEN_TAXBAIK missing or empty`.
|
|
- With a valid token, the harness should return `gate: PASS`.
|
|
- With `--dispatch`, the harness posts a workflow dispatch and reports the latest run evidence.
|
|
|
|
## Security notes
|
|
|
|
- Do not print the token value.
|
|
- Do not commit the token into repo files.
|
|
- Treat the token as a repo-scoped write credential.
|
|
|
|
## Troubleshooting
|
|
|
|
- `401 Unauthorized`: token is missing, expired, or scoped to the wrong repository.
|
|
- `404 Not Found`: repo path or workflow filename is wrong.
|
|
- `latest_run_missing`: dispatch succeeded, but the workflow run did not appear in time; increase `--wait-seconds`.
|
|
|