Dokumentation · Anbindung
GitHub per App-Installation, GitLab und Bitbucket per OAuth — eine Verbindung je Organisation, genutzt von vielen Projekten, jederzeit trennbar.
Anvil Coder arbeitet in deinen eigenen Repositories. Damit die Fabrik dort planen, bauen und Pull Requests eröffnen kann, verbindest du deine Organisation einmal mit deinem Code-Hosting — per OAuth beziehungsweise App-Installation, ohne Tokens von Hand zu verwalten.
Alle Bildschirmfotos zeigen eine Demo-Umgebung mit Beispieldaten.
Das Prinzip: eine Verbindung, viele Projekte
Verbindungen gehören der Organisation, nicht einzelnen Personen oder Projekten. Unter Organisation → Integrationen verbindest du einen Anbieter einmal; danach kann jedes Projekt deiner Organisation diese Verbindung nutzen — welches Repository ein Projekt konkret verwendet, wählst du erst im Projekt-Dialog.
Jede Karte zeigt, was der Anbieter kann (Code-Hosting, Ticket-Tracking), wer verbunden hat und seit wann. Trennen ist jederzeit möglich — solange keine Projektbindung mehr darauf zeigt.
GitHub: per App-Installation
GitHub verbindet sich über eine App-Installation in deiner GitHub-Organisation — der empfohlene Weg von GitHub selbst: Du bestimmst bei der Installation, welche Repositories die App sehen darf, und kannst das jederzeit in GitHub ändern oder widerrufen.
- Auf der GitHub-Karte Verbinden wählen — du wirst zu GitHub geführt.
- Dort die Organisation wählen und die Repositories freigeben (alle oder eine Auswahl).
- Zurück im Cockpit zeigt die Karte Verbunden mit dem Namen deiner GitHub-Organisation.
GitLab und Bitbucket: per OAuth
GitLab (gitlab.com) und Bitbucket Cloud verbinden sich per OAuth: Verbinden wählen, beim Anbieter anmelden und den Zugriff bestätigen. Webhooks für den Rückkanal richtet die Fabrik automatisch ein. Bei GitLab zeigt die Karte zusätzlich den gewährten Scope und das Ablaufdatum — die Verbindung erneuert sich automatisch, solange sie aktiv ist.
Ticket-Tracker: Jira und YouTrack
Auf derselben Seite verbindest du auch Ticket-Tracker: Jira Cloud per OAuth (du wählst die Jira-Site deiner Organisation), YouTrack über URL und Token. Auch GitHub- und GitLab-Issues können als Tracker dienen — welchen Tracker ein Projekt nutzt, entscheidet sich wieder im Projekt-Dialog. Mehr dazu im Kapitel über Projekte.
Trennen und Sicherheit
- Trennen entfernt die Verbindung der Organisation. Zeigen noch Projekte darauf, lehnt das Cockpit ab und nennt die betroffenen Projekte — nichts bricht still.
- Es werden keine persönlichen Zugangs-Tokens gespeichert: GitHub läuft über die App-Installation, GitLab/Bitbucket/Jira über OAuth-Verbindungen der Organisation.
- Jede Verbindung protokolliert, wer sie wann hergestellt hat.
Wie es weitergeht
Mit verbundenem Code-Hosting legst du dein erstes Projekt an und wählst dabei Repository und Tracker — das nächste Kapitel führt durch den Projekt-Dialog.