Projekte in ISO Mate bündeln Vorgänge unter einem gemeinsamen Schlüsselpräfix und ermöglichen es, Git-Repositories zu verbinden, sodass Branches, Commits und Pull Requests den richtigen Vorgängen zugeordnet werden. Sie verwalten Projekte über die Seite Projekte in der Gruppe DevOps der linken Seitenleiste und verbinden Repositories über die Einstellungen jedes Projekts. Nach dem Verbinden hält ISO Mate die Repository-Aktivität automatisch synchron.
Ein Projekt erstellen
- Projekte öffnen: Klappen Sie in der linken Seitenleiste die Gruppe DevOps auf und wählen Sie Projekte.
- Neues Projekt beginnen: Wählen Sie Neues Projekt.
- Grunddaten eingeben: Geben Sie dem Projekt einen Namen und einen Schlüssel aus 2 bis 10 Großbuchstaben oder Ziffern. Der Schlüssel wird bei der Erstellung festgelegt und kann danach nicht mehr geändert werden.
- Optionale Vorgaben festlegen: Sie können eine Projektleitung, einen Standard-Vorgangstyp, eine standardmäßig zugewiesene Person und ein Standardmuster für Branch-Namen wählen.
- Erstellen: Wählen Sie Erstellen, um zu speichern. ISO Mate öffnet die Projekteinstellungen, damit Sie als Nächstes ein Repository verbinden können.
Vorgänge, die unter dem Projekt erstellt werden, übernehmen dessen Schlüssel als Präfix, sodass ein Projekt mit dem Schlüssel PROJ die Schlüssel PROJ-1, PROJ-2 und so weiter erzeugt.
Ein Repository verbinden
- Projekteinstellungen öffnen: Öffnen Sie in der Liste der Projekte die Einstellungen eines Projekts über dessen Einstellungsaktion.
- Verbindung hinzufügen: Wählen Sie in der Karte Repositories die Option Verbindung hinzufügen.
- Anbieter wählen: Wählen Sie GitHub, GitLab oder Bitbucket.
- Details eingeben: Geben Sie die Repository-URL, einen Anzeigenamen und ein Zugriffstoken an.
- Verbinden: Wählen Sie Verbinden. ISO Mate prüft das Token und erkennt, ob die Verbindung Nur-Lesen- oder Lesen-und-Schreiben-Zugriff hat.
Zugriffstokens der Anbieter
Jeder Anbieter verwendet einen eigenen Token-Typ, und ISO Mate liest die Token-Bereiche, um zu entscheiden, ob die Verbindung schreiben darf. Der Dialog zeigt eine Anleitung für den gewählten Anbieter, hier zusammengefasst.
GitHub
Verwenden Sie ein klassisches Personal Access Token mit dem Bereich repo oder ein fein granuliertes Token, bei dem Contents und Pull requests beide auf Lesen und Schreiben gesetzt sind. Für Nur-Lesen-Zugriff genügt ein Token mit Contents auf Lesen.
GitLab
Verwenden Sie ein Personal oder Project Access Token mit dem Bereich api für vollen Zugriff oder die Bereiche read_api und read_repository für Nur-Lesen-Zugriff.
Bitbucket
Erstellen Sie ein Repository Access Token mit dem Bereich pullrequest:write für vollen Zugriff, der die Erstellung von Branches und Pull Requests einschließt, oder mit dem Bereich repository für Nur-Lesen-Zugriff.
Git-Aktivität ansehen
Sobald ein Repository verbunden ist, synchronisiert ISO Mate Branches, Commits und Pull Requests alle 15 Minuten und gleicht Vorgangsschlüssel ab, zum Beispiel PROJ-42, die in Branch-Namen, Commit-Nachrichten und Pull-Request-Titeln vorkommen, um die Aktivität dem richtigen Vorgang zuzuordnen.
Öffnen Sie einen beliebigen Vorgang und gehen Sie zu seinem Abschnitt Git-Aktivität, um die verknüpften Branches, Commits und Pull Requests nach Repository gruppiert zu sehen, jeweils mit einem Link zum Anbieter. Sie können den Abschnitt zudem bei Bedarf über seine Synchronisierungsaktion aktualisieren.
Branches und Pull Requests erstellen
Wählen Sie im Abschnitt Git-Aktivität eines Vorgangs die Option Branch erstellen, um einen Branch in einem verbundenen Repository anzulegen, wobei der Branch-Name aus dem Vorgang vorbelegt wird. Wählen Sie MR/PR erstellen, um einen Pull Request zu öffnen, der den Vorgangsschlüssel im Titel trägt.
Der Pull-Request-Dialog beginnt als Entwurf und fügt dem Titel ein Präfix “Draft:” hinzu. Schalten Sie das Kontrollkästchen Als Entwurf markieren um, um dieses Präfix hinzuzufügen oder zu entfernen. Beide Aktionen benötigen eine Verbindung mit Schreibzugriff, daher sind die Schaltflächen bei einer Nur-Lesen-Verbindung deaktiviert und ein Tooltip erklärt den Grund.
Verknüpfte Branches und Pull Requests verwalten
Jeder Branch und jeder Pull Request im Abschnitt Git-Aktivität hat ein Aktionsmenü mit den folgenden Optionen.
- Branch trennen: Entfernt die Verknüpfung zwischen dem Branch und dem Vorgang. Der Branch bleibt im Repository.
- Branch löschen: Löscht den Branch nach einer Bestätigung aus dem entfernten Repository. Dies erscheint nur, wenn die Verbindung Schreibzugriff hat.
- Pull Request trennen: Entfernt die Verknüpfung zwischen dem Pull Request und dem Vorgang. Der Pull Request bleibt beim Anbieter offen.
- Pull Request schließen: Schließt den Pull Request nach einer Bestätigung beim Anbieter und ist für offene Pull Requests verfügbar.
Sie können außerdem von jedem Branch den Branch-Namen oder einen fertigen Checkout-Befehl kopieren, um schnell in Ihren lokalen Arbeitsablauf zu wechseln.
Verbindungen verwalten
Auf der Seite mit den Projekteinstellungen zeigt jede Verbindung ihren Status (Aktiv, Fehler oder Synchronisierung) und ihre Berechtigung (Nur Lesen oder Lesen und Schreiben). Sie können eine Verbindung bearbeiten, um ihr Token zu aktualisieren, eine Verbindung im Fehlerzustand neu prüfen lassen oder eine Verbindung vollständig löschen.