Code aus GitHub oder GitLab mit Aufgaben verknüpfen

Entwickler können ihren Code mit Aufgaben verknüpfen, ohne GitHub oder GitLab zu verlassen. Wenn eine Commit-Nachricht, ein Branch-Name oder ein Pull Request (in GitLab ein Merge Request) die Nummer einer Aufgabe nennt, zum Beispiel CBS-74-T357, erscheint er im Tab Verknüpfter Code dieser Aufgabe. Das gehört zum Paket Business, und nur Administratoren können verbinden.

Ein Repository verbinden

1. Öffnen Sie Einstellungen und wählen Sie Integrationen.
2. Geben Sie unter GitHub und GitLab einen Namen ein (zum Beispiel Mobile app), wählen Sie GitHub oder GitLab und drücken Sie Verbinden.
3. Kaam360 zeigt eine Adresse und ein Geheimnis. Kopieren Sie beides jetzt: Das Geheimnis wird nur einmal angezeigt.
4. Öffnen Sie in GitHub das Repository (oder Ihre Organisation), dann Settings, Webhooks, Add webhook. Fügen Sie die Adresse in Payload URL ein, wählen Sie application/json, fügen Sie das Geheimnis in Secret ein, wählen Sie Let me select individual events, setzen Sie Häkchen bei Pushes und Pull requests und drücken Sie Add webhook.
5. Öffnen Sie in GitLab das Projekt (oder Ihre Gruppe), dann Settings, Webhooks, Add new webhook. Fügen Sie die Adresse in URL und das Geheimnis in Secret token ein, setzen Sie Häkchen bei Push events und Merge request events und drücken Sie Add webhook.

GitHub schickt sofort eine Testnachricht. Die Verbindung zeigt dann Aktiv und was die letzte Nachricht bewirkt hat.

Eine Aufgabe nennen

Kopieren Sie die Nummer der Aufgabe oben in der Aufgabe (zum Beispiel CBS-74-T357) in:

• eine Commit-Nachricht, etwa Fix the login button (CBS-74-T357);
• einen Branch-Namen, etwa feature/CBS-74-T357-login;
• den Titel oder die Beschreibung eines Pull Requests.

Die Nummer muss den Code ihres eigenen Projekts enthalten, damit nie versehentlich eine Nummer aus einem anderen Projekt verknüpft wird. Öffnen Sie die Aufgabe und wählen Sie den Tab Verknüpfter Code, um jeden verknüpften Commit, Branch und Pull Request mit Repository und Autor zu sehen, bei einem Pull Request auch, ob er offen, gemergt oder geschlossen ist. Drücken Sie auf eine Zeile, um sie in GitHub oder GitLab zu öffnen. Auch der Verlauf der Aufgabe zeigt, wann Code verknüpft wurde.

Aufgaben abschließen, wenn ein Pull Request gemergt wird

Setzen Sie bei einer Verbindung das Häkchen bei Die genannten Aufgaben als erledigt markieren. Wenn ein Pull Request gemergt wird, der eine Aufgabe nennt, wird die Aufgabe als erledigt markiert, so als hätte der Administrator, der die Verbindung angelegt hat, es getan.

Sicher bleiben

• Kaam360 prüft das Geheimnis bei jeder Nachricht und lehnt alles ohne es ab.
• Wenn das Geheimnis bekannt geworden sein könnte, drücken Sie die Schlüssel-Schaltfläche (Neues Geheimnis) und tragen Sie das neue Geheimnis in den Webhook-Einstellungen ein. Das alte funktioniert sofort nicht mehr.
• Drücken Sie Pausieren, um das Verknüpfen eine Zeit lang zu stoppen, oder Entfernen, um die Verbindung und die von ihr angelegten Verknüpfungen zu löschen. Entfernen Sie den Webhook auch in GitHub oder GitLab.

Wenn etwas nicht klappt

• Nichts wird verknüpft: Prüfen Sie, ob die Nummer den Code des Projekts und die richtige Aufgabennummer enthält und ob der Webhook Pushes und Pull Requests sendet.
• GitHub zeigt bei einer Zustellung eine rote Markierung: Die Adresse oder das Geheimnis ist falsch. Drücken Sie Neues Geheimnis und fügen Sie es erneut ein.