docs: add verified Forgejo CI debugging guide to AGENTS.md

Verified:
- Web UI URL for viewing workflow runs
- SSH command to access runner logs
- Common failure patterns and fixes
This commit is contained in:
Bu5hm4nn
2026-03-29 12:10:52 +02:00
parent 9fed45ef9f
commit 786953c403
3 changed files with 24 additions and 2 deletions

View File

@@ -136,7 +136,6 @@ jobs:
APP_PORT: "8000" APP_PORT: "8000"
TURNSTILE_SITE_KEY: ${{ vars.TURNSTILE_SITE_KEY }} TURNSTILE_SITE_KEY: ${{ vars.TURNSTILE_SITE_KEY }}
TURNSTILE_SECRET_KEY: ${{ secrets.TURNSTILE_SECRET_KEY }} TURNSTILE_SECRET_KEY: ${{ secrets.TURNSTILE_SECRET_KEY }}
DATABENTO_API_KEY: ${{ secrets.DATABENTO_API_KEY }}
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v4

View File

@@ -88,3 +88,27 @@ validation_checklist:
- no visible 500/runtime error - no visible 500/runtime error
- screenshot artifact captured when useful - screenshot artifact captured when useful
- relevant logs checked - relevant logs checked
forgejo_ci:
viewing_job_logs:
web_ui:
url: "http://git.uncloud.vpn:3000/bu5hm4nn/vault-dash/actions"
steps:
- Navigate to Actions tab in Forgejo UI (VPN access required)
- Click on the workflow run to see job status
- Expand failing job (lint/test/type-check/build/deploy)
- Click on failed step to see detailed logs
runner_logs:
ssh: "ssh root@5.75.141.4"
command: "docker logs forgejo-runner --tail 100"
job_workspace: "/opt/forgejo-runner/data/"
common_failures:
missing_dependency:
symptom: "ModuleNotFoundError: No module named 'X'"
fix: "Add package to requirements.txt AND .forgejo/workflows/deploy.yaml (test + type-check jobs)"
type_error:
symptom: "error: Incompatible types..."
fix: "Run `mypy app --ignore-missing-imports` locally to reproduce"
test_failure:
symptom: "FAILED test_name"
fix: "Run failing test locally with pytest -xvs"

View File

@@ -47,7 +47,6 @@ NICEGUI_STORAGE_SECRET=${NICEGUI_STORAGE_SECRET:-}
CORS_ORIGINS=${CORS_ORIGINS:-*} CORS_ORIGINS=${CORS_ORIGINS:-*}
TURNSTILE_SITE_KEY=${TURNSTILE_SITE_KEY:-} TURNSTILE_SITE_KEY=${TURNSTILE_SITE_KEY:-}
TURNSTILE_SECRET_KEY=${TURNSTILE_SECRET_KEY:-} TURNSTILE_SECRET_KEY=${TURNSTILE_SECRET_KEY:-}
DATABENTO_API_KEY=${DATABENTO_API_KEY:-}
EOF EOF
# Upload docker-compose file # Upload docker-compose file