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"
|
||||
TURNSTILE_SITE_KEY: ${{ vars.TURNSTILE_SITE_KEY }}
|
||||
TURNSTILE_SECRET_KEY: ${{ secrets.TURNSTILE_SECRET_KEY }}
|
||||
DATABENTO_API_KEY: ${{ secrets.DATABENTO_API_KEY }}
|
||||
steps:
|
||||
- uses: actions/checkout@v4
|
||||
|
||||
|
||||
24
AGENTS.md
24
AGENTS.md
@@ -88,3 +88,27 @@ validation_checklist:
|
||||
- no visible 500/runtime error
|
||||
- screenshot artifact captured when useful
|
||||
- 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:-*}
|
||||
TURNSTILE_SITE_KEY=${TURNSTILE_SITE_KEY:-}
|
||||
TURNSTILE_SECRET_KEY=${TURNSTILE_SECRET_KEY:-}
|
||||
DATABENTO_API_KEY=${DATABENTO_API_KEY:-}
|
||||
EOF
|
||||
|
||||
# Upload docker-compose file
|
||||
|
||||
Reference in New Issue
Block a user