Files
q-blog/docs/CI_TROUBLESHOOTING.md
2025-08-17 00:15:15 -04:00

42 lines
1.1 KiB
Markdown

# CI Troubleshooting
## 1) "Unable to pull refs/heads/v4: worktree contains unstaged changes"
The runner caches cloned **actions** (e.g., `actions/checkout@v4`). If those folders get modified, auto-update fails.
**Fix (on the runner host):** stop the runner, then clean caches.
```bash
# stop your gitea act runner first
# common cache locations (try any that exist)
CANDIDATES=(
"$HOME/.cache/act/actions"
"$HOME/.cache/actions"
"$HOME/_actions"
"/var/lib/act_runner/data/actions"
"/var/lib/act_runner/_actions"
)
for d in "${CANDIDATES[@]}"; do
if [ -d "$d" ]; then
echo "Cleaning $d"
rm -rf "$d"
fi
done
# start the runner again
```
## 2) npm errors during "Install dependencies"
- Ensure **package-lock.json** is committed.
- If you purposely avoid a lockfile, CI will run `npm install` as a fallback.
- Verify Node/npm versions (workflow sets Node 20).
## 3) Workflow not triggering
- In the repo: **Settings → Actions** must be enabled.
- Ensure the file lives at: **.gitea/workflows/ci-no-marketplace.yml**.
- The runner must advertise labels that the workflow requires.