115 lines
3.2 KiB
Markdown
115 lines
3.2 KiB
Markdown
# 🔗 Coolify mit GitHub App konfigurieren
|
|
|
|
## ✅ GitHub App erstellt
|
|
|
|
Du hast bereits eine GitHub App erstellt:
|
|
- **App Name:** `hyggecraftery-app`
|
|
- **App Id:** `2575909`
|
|
- **Installation Id:** `102151662`
|
|
|
|
---
|
|
|
|
## 📋 Schritt 1: Application konfigurieren
|
|
|
|
### 1.1 Application öffnen
|
|
|
|
1. Gehe zu Coolify Dashboard
|
|
2. Öffne deine Application: **APP_hgyyecraftery**
|
|
3. Klicke auf **"Settings"** oder **"Configuration"**
|
|
|
|
### 1.2 Source konfigurieren
|
|
|
|
1. Gehe zu **"Source"** oder **"Repository"**
|
|
2. **Source Type**: Wähle **"Private Repository (with GitHub App)"**
|
|
3. **GitHub App**: Wähle **"hyggecraftery-app"** (deine erstellte App)
|
|
4. **Repository URL**: `https://github.com/Timborimbo/hyggecraftery_APP.git`
|
|
- ODER: Wähle das Repository aus der Dropdown-Liste (falls verfügbar)
|
|
5. **Branch**: `main`
|
|
6. **Speichern**
|
|
|
|
---
|
|
|
|
## 📋 Schritt 2: Repository zu GitHub App hinzufügen (falls nötig)
|
|
|
|
Falls das Repository nicht in der Dropdown-Liste erscheint:
|
|
|
|
1. Gehe zurück zu **GitHub App Settings** (wo du die App erstellt hast)
|
|
2. Klicke auf **"Update Repositories"** (Button mit externem Link)
|
|
3. Oder: Gehe direkt zu GitHub → Settings → GitHub Apps → hyggecraftery-app
|
|
4. Stelle sicher, dass `hyggecraftery_APP` Repository ausgewählt ist
|
|
5. Gehe zurück zu Coolify und klicke auf **"Sync Name"** oder **"Update Repositories"**
|
|
|
|
---
|
|
|
|
## 📋 Schritt 3: Deployen
|
|
|
|
1. Gehe zurück zu deiner Application
|
|
2. Klicke auf **"Deploy"** oder **"Redeploy"**
|
|
3. Coolify wird jetzt:
|
|
- Code von GitHub holen (über die GitHub App)
|
|
- Dockerfile bauen
|
|
- App deployen
|
|
|
|
---
|
|
|
|
## ✅ Vorteile der GitHub App
|
|
|
|
- ✅ **Sicherer** als Deploy Keys (bessere Berechtigungen)
|
|
- ✅ **Einfacher** (kein manuelles Hinzufügen von Keys)
|
|
- ✅ **Mehrere Repositories** möglich
|
|
- ✅ **Automatische Updates** bei Repository-Änderungen
|
|
|
|
---
|
|
|
|
## 🔍 Troubleshooting
|
|
|
|
### Problem: Repository erscheint nicht in der Liste
|
|
|
|
**Lösung:**
|
|
1. Gehe zu GitHub App Settings in Coolify
|
|
2. Klicke auf **"Update Repositories"**
|
|
3. Prüfe in GitHub, ob das Repository der App zugewiesen ist:
|
|
- GitHub → Settings → GitHub Apps → hyggecraftery-app → Repository access
|
|
|
|
### Problem: "Repository not found" oder "Permission denied"
|
|
|
|
**Lösung:**
|
|
1. Prüfe, ob das Repository in der GitHub App konfiguriert ist
|
|
2. Prüfe die Repository-URL (muss genau sein)
|
|
3. Prüfe, ob die GitHub App Installation aktiv ist
|
|
|
|
### Problem: Code wird nicht aktualisiert
|
|
|
|
**Lösung:**
|
|
- Pushe neue Änderungen zu GitHub:
|
|
```bash
|
|
git add .
|
|
git commit -m "Update"
|
|
git push
|
|
```
|
|
- Dann in Coolify: **"Redeploy"** klicken
|
|
|
|
---
|
|
|
|
## ✅ Checkliste
|
|
|
|
- [ ] GitHub App erstellt: `hyggecraftery-app` ✅
|
|
- [ ] Application: Source Type = "Private Repository (with GitHub App)"
|
|
- [ ] Application: GitHub App = "hyggecraftery-app"
|
|
- [ ] Application: Repository URL = `https://github.com/Timborimbo/hyggecraftery_APP.git`
|
|
- [ ] Application: Branch = `main`
|
|
- [ ] Repository in GitHub App konfiguriert
|
|
- [ ] Deploy gestartet
|
|
- [ ] Build erfolgreich
|
|
|
|
---
|
|
|
|
## 🎯 Zusammenfassung
|
|
|
|
1. ✅ GitHub App erstellt
|
|
2. **Application konfigurieren**: Private Repository + GitHub App
|
|
3. **Deployen**: Fertig! 🎉
|
|
|
|
Die GitHub App ist die beste Lösung für private Repositories - viel einfacher als Deploy Keys!
|
|
|