Repositories und Gruppen verbinden

Ein Team arbeitet an den Repositories, die du ihm gibst. Du kannst sie einzeln hinzufügen, mehrere auf einmal auswählen oder eine ganze GitLab-Gruppe oder GitHub-Organisation verbinden, und kanman hält diese Liste selbst aktuell. Alles auf dieser Seite findest du unter Team > Repositories > Repositories. Owner, Admins und die Leads des Teams können es ändern; alle anderen sehen es.

Repositories aus der Liste auswählen

Die Liste zeigt die Repositories, die kanman erreicht: die, die die GitHub- oder GitLab-Verbindung deines Workspace sieht, oder, wenn alles auf deinen eigenen Runnern läuft, die Projekte, die dein Runner sieht. Sie sind nach Owner, Organisation oder Gruppe sortiert, die mit der jüngsten Aktivität zuerst.

• Suche grenzt die Liste beim Tippen ein. Jedes Wort zählt, fm api findet also fm/backend/api.
• Klick auf ein Repository fügt es mit seinem Standard-Branch hinzu. Hinzugefügte sind markiert.
• Alle hinzufügen an der Überschrift einer Gruppe fügt in einem Schritt jedes Repository der Gruppe und ihrer Untergruppen hinzu, das zu deiner Suche passt. Repositories, die das Team schon hat, bleiben außen vor.
• Nicht in der Liste? Gib den Pfad des Repositorys ein oder füge eine Liste von Pfaden ein, um viele auf einmal hinzuzufügen.

Dieselbe Liste gibt es in der Team-Einrichtung, dort kannst du also auch eine ganze Gruppe auswählen.

Eine ganze Gruppe oder Organisation verbinden

Unter Gruppen und Organisationen verbindest du eine GitLab-Gruppe (mit ihren Untergruppen) oder eine GitHub-Organisation:

1. Wähle GitLab-Gruppe oder GitHub-Organisation.
2. Gib die Adresse deines Code-Hosts ein, zum Beispiel https://gitlab.example.com, und den Pfad der Gruppe wie in ihrer URL, zum Beispiel platform oder platform/backend. Bei GitHub den Namen der Organisation.
3. Wähle Verbinden.

kanman versucht zuerst den Zugriff, den dein Workspace schon hat. Erreicht der die Gruppe, nimmt kanman ihre Repositories auf:

• Aktive Repositories kommen ins Team.
• Ruhende Repositories, ohne Aktivität seit 12 Monaten, stehen unter der Gruppe, werden aber nicht hinzugefügt oder gelesen. Du kannst eines trotzdem aus der Liste oben hinzufügen.
• Archivierte Repositories werden übersprungen.
• Sehr große Gruppen liest kanman bis zu ihren 1.000 aktivsten Projekten; die Gruppe sagt das dann.

Jede Stunde schaut kanman die Gruppe erneut an. Ein Repository, das inzwischen dazugekommen ist, nimmt kanman selbst auf und sagt es dem Team im Chat in einer kurzen Zeile, zum Beispiel „Neues Repository fm/xyz in fm aufgetaucht. Ich schaue es mir an.“ Ein Repository, das jemand aus dem Team entfernt hat, kommt nicht wieder dazu.

Repositories oder Untergruppen ausnehmen

Öffne Ausnahmen unter der Gruppe und gib ein Repository oder eine Untergruppe ein, zum Beispiel platform/legacy. kanman schlägt beim Tippen die Untergruppen und Projekte der Gruppe vor. Ausgenommene Repositories verlassen das Team sofort und kommen nicht wieder dazu. Entfernst du eine Ausnahme, kommen neue Repositories aus diesem Pfad wieder herein.

Wenn kanman die Gruppe nicht erreicht

Steht an der Gruppe Braucht Zugriff, zeigt kanman zwei Wege hinein und wann welcher passt.

Den kanman-Benutzer zur Gruppe hinzufügen. Jemand mit der Rolle Owner in der Gruppe fügt das Konto, mit dem dein Workspace verbunden ist, als Reporter hinzu, oder als Developer, wo kanman Änderungen pushen soll. Dann wähle Erneut prüfen.

Ein Gruppen-Zugriffstoken verwenden. Kommen die Mitgliedschaften der Gruppe aus LDAP (oder einem anderen Verzeichnisabgleich), kann der kanman-Benutzer kein Mitglied bleiben. Dann legt ein Owner der Gruppe stattdessen ein Gruppen-Zugriffstoken an:

1. Öffne die Gruppe in GitLab und dort die Seite Access tokens in den Einstellungen der Gruppe.
2. Füge ein neues Token hinzu: Name kanman, Rolle Reporter, Scopes read_api und read_repository, und ein Ablaufdatum.
3. Kopiere das Token, füge es in kanman unter der Gruppe ein und wähle Token speichern.

kanman speichert das Token verschlüsselt und nutzt es nur, um die Repositories dieser Gruppe zu lesen. Es zeigt es nie wieder an. Mit einem Token, das nur lesen darf, kann kanman lesen, lernen und vorschlagen, aber in dieser Gruppe keine Branches pushen oder Merge Requests öffnen; dafür braucht sein eigenes Konto Developer-Zugriff.

Zwei Wochen und drei Tage bevor das Token abläuft, sagt kanman es den Leads des Teams im Team-Chat, mit den Schritten für ein neues Token. Füge das neue Token mit Token ersetzen ein.

Für eine GitHub-Organisation installierst du die kanman GitHub App in der Organisation (alle Repositories oder die, die kanman lesen soll), oder du verbindest GitHub mit einem Konto, das Mitglied ist. Eine über die App verbundene Organisation zeigt die Repositories, die der Installation gegeben wurden.

Entfernst du eine Gruppe, bleiben ihre Repositories im Team; kanman nimmt nur keine neuen mehr daraus auf.

Wann kanman zu lesen beginnt

Bekommt ein neues Team seine Repositories, lernt kanman sie kennen und schlägt im Team-Chat ein paar kleine erste Stories vor. Oft fügt ein Team mehrere Repositories nacheinander hinzu, deshalb wartet kanman, bis die Einrichtung zur Ruhe gekommen ist:

• Während du noch Repositories hinzufügst, sagt der Team-Chat, wie viele verbunden sind und dass kanman loslegt, sobald du die Einstellungen schließt. Jetzt starten legt sofort los.
• kanman beginnt, wenn du die Team-Einstellungen verlässt, oder von selbst fünf Minuten nach der letzten Änderung.
• Es braucht Modellzugang und mindestens ein Repository, das es lesen kann; der Team-Chat sagt, was davon noch fehlt.
• Später hinzugefügte Repositories bekommen einen kurzen eigenen Blick, nie eine zweite Vorstellung. Mehrere, die kurz nacheinander dazukommen, schaut kanman zusammen an.

Dasselbe gilt, wenn du eine Gruppe verbindest: Ihre erste Erkundung ist ein Einrichtungsschritt, und kanman legt los, sobald du fertig bist.

Verwandte Seiten

• Ein Team einrichten
• GitLab hinter VPN oder Firewall
• Alles auf deinen Runnern ausführen
• GitHub verbinden