143 lines
3.6 KiB
Markdown
143 lines
3.6 KiB
Markdown
# Git-Workflow: Remotes, Branches, Merges
|
|
|
|
Letzte Aktualisierung: 2026-06-23
|
|
|
|
Dieses Projekt hat zwei Git-Remotes mit unterschiedlichen Rollen:
|
|
|
|
| Remote | URL | Zweck |
|
|
|--------|-----|-------|
|
|
| `github` | `https://github.com/theurj/breadcrumb-the-shire.git` | CI/CD (GitHub Actions) — hier wird deployed |
|
|
| `origin` | `https://onion.breadcrumb-online.de/fa/...` | Gitea — internes Repo, Pull Requests von Kollegen |
|
|
|
|
Alle Deployments laufen über `github`. Auf `origin` (Gitea) wird **nicht automatisch gepusht**.
|
|
|
|
---
|
|
|
|
## Remotes anzeigen
|
|
|
|
```bash
|
|
git remote -v
|
|
```
|
|
|
|
Ausgabe:
|
|
```
|
|
github https://github.com/theurj/breadcrumb-the-shire.git (fetch)
|
|
github https://github.com/theurj/breadcrumb-the-shire.git (push)
|
|
origin https://fa:TOKEN@onion.breadcrumb-online.de/fa/breadcrumb-the-shire.git (fetch)
|
|
origin https://fa:TOKEN@onion.breadcrumb-online.de/fa/breadcrumb-the-shire.git (push)
|
|
```
|
|
|
|
---
|
|
|
|
## Änderungen auf GitHub deployen
|
|
|
|
```bash
|
|
git push github main
|
|
```
|
|
|
|
Löst GitHub Actions aus (CI + Deploy). Niemals `git push` ohne `github` — sonst landet es nur in Gitea.
|
|
|
|
---
|
|
|
|
## Pull Request eines Kollegen aus Gitea übernehmen
|
|
|
|
### 1. Offene PRs in Gitea anzeigen
|
|
|
|
```bash
|
|
curl -s "https://fa:TOKEN@onion.breadcrumb-online.de/api/v1/repos/fa/breadcrumb-the-shire/pulls?state=open" \
|
|
| python -c "import sys,json; [print(f'PR #{p[\"number\"]}: {p[\"title\"]} | branch: {p[\"head\"][\"label\"]} | by: {p[\"user\"][\"login\"]}') for p in json.load(sys.stdin)]"
|
|
```
|
|
|
|
### 2. Fork des Kollegen als Remote hinzufügen
|
|
|
|
```bash
|
|
git remote add tbh "https://fa:TOKEN@onion.breadcrumb-online.de/tbh/breadcrumb-the-shire.git"
|
|
```
|
|
|
|
Den Remote-Namen (`tbh`) einmalig hinzufügen — bei weiteren PRs desselben Kollegen entfällt dieser Schritt.
|
|
|
|
### 3. Branch holen und Commits prüfen
|
|
|
|
```bash
|
|
git fetch tbh feature/security-checks
|
|
git log tbh/feature/security-checks --oneline --not origin/main
|
|
```
|
|
|
|
### 4. Geänderte Dateien im Überblick
|
|
|
|
```bash
|
|
git diff origin/main...tbh/feature/security-checks --stat
|
|
```
|
|
|
|
### 5. Branch in main mergen
|
|
|
|
```bash
|
|
git merge tbh/feature/security-checks --no-ff -m "feat(security): merge security checks module"
|
|
```
|
|
|
|
`--no-ff` erzwingt einen Merge-Commit, damit der Branch-Ursprung im Log sichtbar bleibt.
|
|
|
|
### 6. Auf GitHub pushen
|
|
|
|
```bash
|
|
git push github main
|
|
```
|
|
|
|
---
|
|
|
|
## Eigene Änderungen committen und pushen
|
|
|
|
```bash
|
|
# Bestimmte Dateien stagen (nie git add -A, könnte .env miterfassen)
|
|
git add modules/helpdesk/pages/helpdesk/handovers/_form.phtml
|
|
|
|
# Committen
|
|
git commit -m "fix(helpdesk): describe what and why"
|
|
|
|
# Deployen
|
|
git push github main
|
|
```
|
|
|
|
---
|
|
|
|
## Status und Log
|
|
|
|
```bash
|
|
# Aktueller Zustand (geänderte / ungetrackte Dateien)
|
|
git status
|
|
|
|
# Letzte Commits
|
|
git log --oneline -10
|
|
|
|
# Alle Branches (lokal + remote)
|
|
git branch -a
|
|
|
|
# Änderungen zwischen lokalem main und GitHub
|
|
git diff github/main...main --stat
|
|
```
|
|
|
|
---
|
|
|
|
## Neuen Kollegen-Fork als Remote hinzufügen
|
|
|
|
```bash
|
|
git remote add <name> "https://fa:TOKEN@onion.breadcrumb-online.de/<username>/breadcrumb-the-shire.git"
|
|
```
|
|
|
|
Beispiel für Benutzer `mia`:
|
|
```bash
|
|
git remote add mia "https://fa:TOKEN@onion.breadcrumb-online.de/mia/breadcrumb-the-shire.git"
|
|
git fetch mia feature/my-feature
|
|
git merge mia/feature/my-feature --no-ff -m "feat(...): merge ..."
|
|
git push github main
|
|
```
|
|
|
|
---
|
|
|
|
## Wichtige Regeln
|
|
|
|
- **Niemals** `git push` ohne Remote-Angabe — Standard-Remote ist `origin` (Gitea), nicht `github`.
|
|
- **Niemals** `git add .` oder `git add -A` — immer Dateien explizit benennen (verhindert, dass `.env` oder `db_export.sql` committet wird).
|
|
- Jede Änderung sofort committen, nicht sammeln.
|
|
- `db_export.sql` ist gitignored (oder sollte es sein) — nicht committen.
|