Schritt 5: Ersten Deploy auslösen
Jetzt ist alles bereit. Ein Push auf main startet den Workflow automatisch.
Anleitung
- Falls du seit dem letzten Push Änderungen gemacht hast, committe und pushe sie:
bash
git add .
git commit -m "Guides hinzugefügt"
git push
Falls nichts Neues zu pushen ist, kannst du den Workflow auch manuell auslösen (siehe unten).
- Beobachte den Workflow auf GitHub:
- Gehe zu github.com/chrisfinkh/docs-wiki → Actions.
- Du solltest einen laufenden Workflow „Deploy Docs to Cloudflare Pages" sehen.
-
Klicke drauf, um die Logs zu sehen.
-
Oder per CLI:
bash
gh run watch
- Nach Abschluss (ca. 1 Minute): Öffne https://interne-doku.pages.dev im Browser.
Workflow manuell auslösen
Falls du nichts pushen willst, kannst du den Workflow auch manuell starten:
gh workflow run deploy.yml
Oder im Dashboard: Actions → Deploy Docs to Cloudflare Pages → Run workflow.
Das funktioniert, weil der Workflow workflow_dispatch als Trigger hat.
Was passiert im Workflow?
- Checkout — GitHub klont das Repo.
- Build — Der MkDocs-Material-Docker-Container baut die Markdown-Dateien zu statischem HTML (
site/-Verzeichnis). - Deploy — Wrangler lädt das
site/-Verzeichnis zu Cloudflare Pages hoch.
Der --strict-Flag sorgt dafür, dass der Build bei kaputten Links oder Warnungen abbricht — so geht keine fehlerhafte Doku live.
Wichtig: wrangler-action Version
Nutze cloudflare/wrangler-action@v4, nicht @v3. Die v3-Version nutzt Node 20, das auf GitHub Actions deprecated ist und zu Fehlern führt (The process '/usr/local/bin/npx' failed with exit code 1). v4 nutzt Node 24 und Wrangler v4.
Typische Probleme
| Problem | Lösung |
|---|---|
The process '/usr/local/bin/npx' failed with exit code 1 |
wrangler-action@v3 → auf @v4 updaten (Node-20-Deprecation) |
Authentication error |
API-Token hat nicht die richtige Berechtigung — siehe Schritt 3 |
Project not found |
Projektname im Workflow stimmt nicht mit Cloudflare überein — siehe Schritt 2 |
| Build bricht ab mit Warnungen | --strict ist aktiv (gewollt) — die Warnungen im Log beheben |
| Workflow startet nicht | Prüfe ob der Workflow auf dem main-Branch liegt |