ecb5e1bd22
- Eltern-Ordner ist jetzt EIN Git-Repo (statt getrennter Repos). - root .gitignore haelt Secrets (.env), node_modules, DB und Build-Artefakte raus. - release.ps1: manueller Release (ZIP bauen + ans Backend laden). - root README mit Struktur und Release-Ablauf. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
42 lines
1.5 KiB
Markdown
42 lines
1.5 KiB
Markdown
# Gitea Act Runner – Einrichtung
|
||
|
||
Einmalig nötig, damit der Release-Workflow (Tag `v*`) automatisch baut + hochlädt.
|
||
|
||
## 1. Registrierungs-Token holen
|
||
Gitea → Repo **GDPR-Content-Blocker** → **Settings → Actions → Runner** →
|
||
Button **„Neuen Runner erstellen"**. Es erscheint ein **Registration Token**
|
||
(eine lange Zeichenkette). Kopieren.
|
||
|
||
(Alternativ instanzweit: Admin-Bereich → Actions → Runners → Create new Runner.)
|
||
|
||
## 2. Token eintragen
|
||
In `docker-compose.yml` bei `GITEA_RUNNER_REGISTRATION_TOKEN` einsetzen.
|
||
|
||
## 3. Runner starten (auf dem Server, wo Docker läuft)
|
||
```bash
|
||
cd /pfad/zu/gitea-runner
|
||
docker compose up -d
|
||
docker compose logs -f # "runner registered successfully" abwarten
|
||
```
|
||
|
||
Danach in Gitea unter Settings → Actions → Runner taucht „hub-runner" mit
|
||
Status **idle/online** auf. Ab jetzt laufen Workflows automatisch.
|
||
|
||
## 4. Testen
|
||
Im Plugin-Repo:
|
||
```bash
|
||
git tag v1.0.1
|
||
git push origin v1.0.1
|
||
```
|
||
Gitea → Repo → Tab **Actions** zeigt den Lauf. Bei Erfolg ist die ZIP im Backend:
|
||
```bash
|
||
curl https://hub.lucas-orth.de/api/v1/releases/gdpr-content-blocker -H "X-Admin-Token: TOKEN"
|
||
```
|
||
|
||
## Hinweise
|
||
- Der Runner braucht Zugriff auf den Docker-Socket (startet die Job-Container).
|
||
- Erstes Image (catthehacker/ubuntu) wird beim ersten Lauf gezogen → dauert kurz.
|
||
- Das `data/`-Verzeichnis enthält nach der Registrierung die Runner-Identität
|
||
(`.runner`). Nicht löschen, sonst neu registrieren.
|
||
- Token wird nur einmal gebraucht; nach erfolgreicher Registrierung ignoriert.
|