Repository verbinden: Agile Git und GitHub
So verbinden Sie Ihr Git-Konto mit Agile Deploy und was Sie bei GitHub-Tokens einstellen müssen.
Welche Anbieter gibt es?
Agile Deploy baut Repositorys aus Agile Git (git.agiledeveloper.de) und GitHub. Beim Anlegen eines Projekts legt Agile Deploy beim Anbieter einen Webhook an, damit jeder Push automatisch baut.
Ihre Konten verwalten Sie unter Einstellungen → Git-Verbindungen. Beim Anlegen eines Projekts lässt sich ein Konto auch direkt im ersten Schritt verbinden.
Agile Git verbinden
- Klicken Sie auf Mit Agile Git verbinden.
- Melden Sie sich bei Agile Git an und bestätigen Sie den Zugriff.
- Sie kommen zurück zu Agile Deploy und sehen die Meldung „Agile Git ist verbunden.“
GitHub verbinden
GitHub verbinden Sie mit einem fein granulierten Token.
- Klicken Sie auf GitHub per Token verbinden.
- Öffnen Sie auf GitHub Settings → Developer settings → Fine-grained tokens und wählen Sie Generate new token.
- Wählen Sie bei Repository access die Repositorys, die Agile Deploy bauen soll.
- Setzen Sie unter Repository permissions:
- Contents: Read-only
- Webhooks: Read and write
- Commit statuses: Read and write
- Metadata: Read-only, ist automatisch dabei
- Erzeugen Sie das Token, fügen Sie es bei Fein granuliertes Token ein und klicken Sie auf Mit GitHub verbinden.
Tokens speichert Agile Deploy verschlüsselt. Sie sind nicht wieder lesbar. Agile Deploy nutzt sie nur für Ihre Builds, Webhooks und Commit-Status.
Wer darf eine Verbindung nutzen?
Eine Git-Verbindung nutzt nur, wer sie angelegt hat. Andere Mitglieder des Teams verbinden ihr eigenes Konto, um Repositorys zu importieren. Bestehende Projekte bauen unabhängig davon weiter.
Verbindung trennen
Unter Einstellungen → Git-Verbindungen trennen Sie ein Konto über das Papierkorb-Symbol. Das dürfen die Person, die es angelegt hat, und Team-Admins. Nutzt noch ein Projekt die Verbindung, lehnt Agile Deploy das Trennen ab. Löschen Sie dann zuerst das Projekt oder verbinden Sie es neu.
Wenn etwas nicht klappt
- Plakette „Token prüfen“: Mit dem Zugang stimmt etwas nicht. Verbinden Sie das Konto unter Einstellungen → Git-Verbindungen neu.
- „Keine Repositorys gefunden“: Prüfen Sie, ob das Token Zugriff auf Ihre Repositorys hat.
- „Kein Webhook: Builds nur von Hand.“: Dieser Hinweis steht im Tab Einstellungen des Projekts, wenn der Webhook fehlt. Bauen Sie dann von Hand über Neu deployen.