Files
kjh2064 5c94564c9f Gitea Act Runner — Synology 기동 스크립트 + 토큰 홈 검증 도구
로컬 워크스페이스에서 Gitea Actions를 검증·디스패치할 수 있는
GITEA_TOKEN_HOME API 토큰 계약과, Synology에서 act_runner를
기동하는 스크립트를 추가한다.

- validate_gitea_token_home_v1.py: 저장소 메타데이터 조회, 워크플로
  접근 확인, workflow_dispatch 트리거 + 최신 실행 결과 폴링
- start_act_runner_synology.sh: Synology 환경에서 act_runner 기동
- setup_act_runner.sh: 기동 절차 갱신
2026-06-22 01:44:22 +09:00

1.2 KiB

GITEA_TOKEN_HOME

GITEA_TOKEN_HOME 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:

python tools/validate_gitea_token_home_v1.py

To dispatch the KIS collector workflow as a smoke test:

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

Expected behavior

  • Without GITEA_TOKEN_HOME, the harness exits with GITEA_TOKEN_HOME 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.