Git: GitHub und Agile Git verbinden, hochladen, aktualisieren, ZIP-Download
Ihren Code mit Agile Git oder GitHub verbinden, Änderungen hochladen und holen, oder als ZIP herunterladen.
Ihr Code gehört Ihnen. Agile Vibes speichert jede Änderung als Git-Commit. Sie können das Projekt mit Agile Git (git.agiledeveloper.de, Server in Nürnberg) oder GitHub verbinden oder den Code jederzeit als ZIP herunterladen.
Git-Verbindung einrichten
Verbindungen gelten für Ihr Team und liegen unter Einstellungen › Git-Verbindungen.
Agile Git:
- Mit Agile Git verbinden klicken.
- Bei Agile Git anmelden und den Zugriff erlauben.
- Sie landen wieder in Agile Vibes; die Verbindung steht als Verbunden in der Liste.
GitHub:
- Erstellen Sie bei GitHub ein fein granuliertes Token (Fine-grained personal access token) für die gewünschten Repositorys mit Lese- und Schreibrecht auf „Contents“. Zum Anlegen neuer Repositorys braucht das Token zusätzlich das Recht dazu.
- In Agile Vibes unter GitHub oder anderen Server verbinden den Anbieter GitHub wählen, das Token einfügen und Verbinden.
Anderer Git-Server: Anbieter Anderer Server, Adresse des Servers (zum Beispiel https://git.firma.de) und ein persönliches Zugangstoken mit Repository-Rechten. Repositorys legen Sie dort selbst an.
Tokens speichern wir verschlüsselt. Sie werden nur für Git-Befehle dieses Teams verwendet und nie in ein Repository geschrieben.
Projekt mit einem Repository verbinden
- Im Editor oben auf das Git-Symbol (Zweig) klicken, dann Mit Git verbinden.
- Gibt es noch keine Verbindung, wählen Sie Mit Agile Git verbinden oder GitHub verbinden.
- Verbindung wählen und dann entweder Neues Repository (Name, Sichtbarkeit Privat oder Öffentlich) oder Vorhandenes wählen.
- Verbinden und hochladen. Der aktuelle Stand wird hochgeladen.
Hochladen und aktualisieren
Das Git-Menü zeigt je Repository:
- Hochladen (Push): schickt alle Versionen seit dem letzten Hochladen an den Git-Server. Die Meldung nennt den Commit.
- Aktualisieren (Pull): holt Änderungen, die jemand direkt im Repository gemacht hat. Sie erscheinen als Version der Art Git.
- Repository öffnen: öffnet das Repository im Browser.
Bei Projekten mit mehreren Repositorys (Frontend und Backend) steht jedes Repository mit eigenem Namen im Menü.
Code als ZIP herunterladen
Kopfzeile › Download-Symbol › Code herunterladen (ZIP):
- Gesamter Code bzw. bei mehreren Repositorys Alle Repositories oder ein einzelnes Repository.
- Auch über die Befehlspalette („Code als ZIP herunterladen“) und auf dem Handy unter Mehr › Code herunterladen.
- Die ZIP-Datei enthält den Quellcode ohne node_modules, .next, .venv und
__pycache__. Mitnpm installbzw.pip install -r requirements.txtrichten Sie sie woanders wieder ein.
Tipps
- Verbinden Sie wichtige Projekte früh mit Git. So haben Sie eine Kopie außerhalb von Agile Vibes.
- Ändern Sie möglichst nicht gleichzeitig im Repository und in Agile Vibes. Wenn doch: zuerst Aktualisieren, dann weiterarbeiten, dann Hochladen.
- Während die KI arbeitet, sind Git-Aktionen gesperrt („Gerade arbeitet die KI an diesem Projekt“).
Typische Fehler und Meldungen
- „Im Repository gibt es neuere Änderungen. Bitte zuerst aktualisieren.“: Erst Aktualisieren (Pull), dann Hochladen.
- „Konflikt: Das Repository und dieses Projekt haben sich unabhängig voneinander verändert …“: Automatisches Zusammenführen ist nicht möglich. Laden Sie Ihren Stand in einen neuen Branch hoch oder setzen Sie das Repository zurück.
- „Der Git-Server lehnt den Zugang ab …“: Token abgelaufen oder ohne Schreibrecht. Verbindung unter Einstellungen › Git-Verbindungen neu anlegen.
- „Die Verbindung zu Agile Git ist abgelaufen.“: Erneut Mit Agile Git verbinden.
- „GitHub lehnt das Token ab.“: Token falsch kopiert oder abgelaufen.
- „Dieses Repository ist noch mit keinem Git-Server verbunden.“: Zuerst Mit Git verbinden.
- „Mit dieser Git-Verbindung lassen sich keine neuen Repositorys anlegen.“: Repository beim Anbieter anlegen und Vorhandenes wählen.
Häufige Fragen
Kann ich das Projekt woanders weiter betreiben?
Ja. Der Code ist ein normales Projekt (bei neuen Apps Next.js mit TypeScript und Tailwind CSS). Variablen und Geheimnisse übertragen Sie selbst.
Werden Geheimnisse mit hochgeladen?
Nein. Geheimnisse liegen verschlüsselt bei Agile Vibes, nicht im Repository.
Was ist Agile Git?
Der Git-Server von Agile Developer unter git.agiledeveloper.de, gehostet in Nürnberg.