85 lines
1.8 KiB
Markdown
85 lines
1.8 KiB
Markdown
# Gitea-Import
|
|
|
|
## Repo-Name
|
|
|
|
Empfohlen: `alan-agents-workstation`
|
|
|
|
## Schnellweg
|
|
|
|
```bash
|
|
cd /pfad/zu/alan
|
|
|
|
git init
|
|
git branch -M main
|
|
git add .
|
|
git commit -m "Initial workstation stack for Hermes + OpenClaw coexistence"
|
|
|
|
git remote add origin ssh://git@<dein-gitea-host>/<dein-user>/alan-agents-workstation.git
|
|
git push -u origin main
|
|
```
|
|
|
|
## Branching
|
|
|
|
Einfach und robust fuer Single-Workstation-Infra:
|
|
|
|
- `main` fuer den stabilen Stand
|
|
- `feat/...` fuer lokale Erweiterungen
|
|
- Tags fuer getestete Snapshots, z. B. `v0.1.0`
|
|
|
|
## Was ins Repo gehoert
|
|
|
|
- Compose-Dateien
|
|
- Skripte
|
|
- Doku
|
|
- Beispiel-Env-Dateien
|
|
- systemd-User-Units
|
|
|
|
## Was nicht ins Repo gehoert
|
|
|
|
- echte API-Keys
|
|
- echte Hermes-Daten aus `state/hermes`
|
|
- Backup-Archive
|
|
- lokale Debug-Logs
|
|
|
|
|
|
## Empfohlene Zusatzdateien fuer Gitea
|
|
|
|
Dieses Repo bringt bereits mit:
|
|
|
|
- `CHANGELOG.md`
|
|
- `CONTRIBUTING.md`
|
|
- `.gitea/ISSUE_TEMPLATE/*`
|
|
- `.gitea/pull_request_template.md`
|
|
- `.gitea/workflows/repo-check.yml`
|
|
- `docs/release-process.md`
|
|
- `docs/upgrade-policy.md`
|
|
|
|
Damit bekommst du in Gitea:
|
|
|
|
- strukturierte Fehlermeldungen und Feature-Wuensche
|
|
- einheitliche PR-Checklisten
|
|
- einfache serverseitige Grundpruefungen fuer das Repo
|
|
- nachvollziehbare Releases mit Tagging und Upgrade-Hinweisen
|
|
|
|
## Release-Empfehlung
|
|
|
|
Fuer jedes verteilte Repo-Update:
|
|
|
|
1. `CHANGELOG.md` pflegen
|
|
2. `./scripts/release-check` ausfuehren
|
|
3. Release-Tag setzen, z. B. `v0.1.1`
|
|
4. in Gitea Release Notes mit Upgrade-Hinweisen anlegen
|
|
|
|
## Beispiel fuer Release Notes
|
|
|
|
```text
|
|
Neu:
|
|
- robusteres br0-Uplink-Handling
|
|
- verbesserter Rollback-Workflow
|
|
|
|
Wichtig fuer bestehende Installationen:
|
|
- `.env.example` geaendert: neuer Key XYZ
|
|
- vor Upgrade bitte `./scripts/alanctl backup` ausfuehren
|
|
- Rollback bleibt ueber `./scripts/alanctl rollback-hermes` moeglich
|
|
```
|