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:
@@ -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
|
||||||
|
|
||||||
|
|||||||
24
AGENTS.md
24
AGENTS.md
@@ -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"
|
||||||
|
|||||||
@@ -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
|
||||||
|
|||||||
Reference in New Issue
Block a user