Du wirst gebeten, eine Organisation für dein Konto auszuwählen:

Du wirst dann aufgefordert, monday.com in deinem GitHub-Konto zu autorisieren:

Sobald diese installiert ist, können Benutzer neue Vorlagen hinzufügen und werden automatisch mit deinem GitHub-Konto authentifiziert.

Klicke hier, um zu erfahren, was diese Berechtigungen bedeuten

Bitte beachte, dass monday.com nur auf die Daten zugreift, die zur Gewährleistung der Funktionalität notwendig sind, wie z. B. Namen und Speicherorte deiner Daten. Zu diesen Berechtigungen gehören:

• Zugriff auf deinen Code – Speziell für die TO-DO-Vorlage liest monday.com die Änderungen am PR, ohne den Code zu speichern, um ihn mit deinem Element von monday zu verbinden. 
• Probleme - monday.com benötigt Zugriff auf Informationen zu Problemen, um die entsprechende monday  Automatisierung auszulösen
• Metadaten – monday.com benötigt Zugriff auf eine Sammlung von schreibgeschützten Endpunkten mit Metadaten, um die entsprechende monday Automatisierung auszulösen. Diese Endpunkte stellen keine sensiblen, privaten Repository-Informationen zur Verfügung.
• Pull Requests – monday.com muss Änderungen im PR lesen und Zugriff auf die Schreibberechtigungen für Pull Requests haben, um die entsprechenden Automatisierungen und Vorlagen für die Zwei-Wege-Synchronisierung von monday auszulösen

Deinem Workflow hinzufügen 

Um die Vorlagen für die Integration in GitHub zu deinem gewünschten Board hinzuzufügen, rufe dieses Board auf und klicke oben rechts auf Integrieren:

Sobald du auf der Seite Board-Automatisierungen bist, suche in der Suchleiste nach GitHub: 

Klicke auf das Banner „GitHub“, um die Vorlagen zu sehen, die unsere Integration bietet:

Dann kannst du die Vorlagen auswählen, die du zu deinem Board hinzufügen möchtest.

Die von monday.com unterstützten Integrationsvorlagen sind:

• Wenn ein Problem mit etwas in diesem Repository gekennzeichnet ist, erstelle ein Element
• Wenn ein Pull Request in den Repositories zusammengeführt wird und die Element-ID darin erwähnt wird, ändere den Status in etwas
• Wenn ein Problem in diesen Repositories erstellt wird, erstelle ein Element
• Wenn ein Pull Request in diesen Repositories erstellt wird und die Element-ID darin erwähnt wird, ändere den Status in etwas
• Wenn ein Pull Request in diesen Repositories erstellt wird und die Element-ID darin erwähnt wird, füge den Link zum Pull Request zur Link-Spalte hinzu
• Wenn ein Zweig in diesen Repositories erstellt wird, erstelle ein Element
• Wenn sich der Status eines Problems in etwas in diesen Repositories ändert und die Element-ID darin erwähnt wird, setze den Status auf etwas
• Wenn ein Benutzer von github einen TODO-Kommentar in diese Repositories einstellt, erstelle ein Element
• Wenn ein Problem in diesen Repositories erstellt wird und die Element-ID darin erwähnt wird, füge einen Link zu dieser Link-Spalte hinzu
• Wenn sich der Status eines Pull Requests in etwas in diesen Repositories ändert und die Element-ID darin erwähnt wird, setze den Status auf etwas
• Wenn ein Problem in diesem Repository mit einem Label etwas versehen ist und die Element-ID darin erwähnt wird, setze den Status auf etwas
• Wenn sich der Status eines Pull Requests in etwas in diesen Repositories ändert und die Element-ID darin erwähnt wird, erstelle eine Aktualisierung
• Wenn ein Pull Request in diesem Repository mit einem Label von etwas versehen ist und die Element-ID darin erwähnt wird, setze den Status auf etwas
• Wenn ein Problem in diesen Repositories erstellt wird, erstelle ein Element und synchronisiere zukünftige Änderungen
• Wenn ein Problem mit diesen Labels in diesem Repository erstellt wird, erstelle ein Element und synchronisiere zukünftige Änderungen
• Wenn ein Pull Request in diesen Repositorys erstellt oder aktualisiert wird, erstelle ein Element und synchronisiere zukünftige Änderungen
• Wenn ein Element erstellt oder aktualisiert wird, erstelle ein Problem in diesem Repository mit diesen Feldern und synchronisiere zukünftige

Zwei-Wege-Synchronisation erstellen

Eine Zwei-Wege-Synchronisierung findet statt, wenn Daten sowohl von monday.com nach GitHub als auch von GitHub nach monday.com gesendet werden. Auf diese Weise stimmen deine Daten auf beiden Plattformen überein und bleiben aktuell.

Um eine Zwei-Wege-Synchronisierung zu erstellen, wähle beide Wege im Drop-down-Menü aus.

Wenn du z. B. die Spalte Verantwortlicher deines Elements auf monday.com dem Feld Zuständige Person auf GitHub zuordnen möchtest, wählst du diese Felder in den jeweiligen Drop-down-Menüs aus. Wähle dann unter dem Drop-down-Menü Richtung wählen beide Wege aus.

Was ist die Element-ID?

Einige der Vorlagen für die Integration benötigen eine „eindeutige Verbindung“ zwischen monday.com und GitHub, um die beiden Plattformen zu synchronisieren, und die Element-ID dient als eindeutige Nummer für das Element.

Nehmen wir die Integrationsvorlage als Beispiel: „Wenn ein Pull Request in diesem Repository erstellt und die Element-ID im Pull-Request-Namen erwähnt wird, ändere den Status in etwas.“

Sobald der Pull Request in GitHub erstellt wurde, identifiziert das System anhand der Element-ID in monday.com, welches Element es ändern muss.

Tipp: Du kannst auf die Spalte mit der Element-ID klicken, um den Wert automatisch von deinem Board zu übernehmen.

Diese Erwähnung funktioniert auch mit der benutzerfreundlichen Element-ID (z. B. TASK-12)

Sprintelemente nachverfolgen

Erhalte sofort eine Statusaktualisierung in monday dev, sobald ein Zweig erstellt wird und ein PR zusammengefasst wird. Dafür empfehlen wir die Verwendung der folgenden Formel für GitHub, mit der du Sprints nachverfolgen kannst:

• Wenn ein Zweig in diesen Repositories erstellt wird und die Element-ID darin erwähnt wird, definiere den Status als etwas.

Diese Formel verbindet Elemente über die Element-ID mit GitHub. Füge die Element-ID in den Zweignamen ein und lege los!

Diese Verbindung ermöglicht es dir, Sprints über beide Plattformen hinweg nachzuverfolgen.

GitHub Actions

GitHub Actions ist ein in GitHub integriertes Tool, mit dem du Aufgaben innerhalb deines Workflows zur Softwareentwicklung automatisieren kannst. Dadurch entfallen sich wiederholende Aufgaben, was wiederum den Entwicklungsprozess strafft und ihn effizienter macht.

Was kann GitHub Actions leisten?

• CI/CD-Pipeline automatisieren: Damit kannst du automatische Prozesse einrichten, um deinen Code zu erstellen, zu testen und bereitzustellen, sobald es Änderungen gibt. So werden Fehler frühzeitig erkannt und der Release-Prozess gestrafft.
• Workflows auf der Grundlage von Ereignissen ausführen: Mit GitHub Actions kannst du Workflows auf der Grundlage verschiedener Ereignisse in deinem Repository auslösen. Du kannst zum Beispiel einen Workflow erstellen, der automatisch Tests durchführt, sobald ein Pull Request vorliegt.
• Eine große Anzahl von Aktionen nutzen: Es gibt eine umfassende Auswahl an vorgefertigten Aktionen, die du für verschiedene Aufgaben nutzen kannst. Dabei kann es sich um alles Mögliche handeln, von der Bereitstellung deines Codes auf verschiedenen Plattformen bis zum Erstellen von Tickets in Projektmanagement-Tools. Du kannst auch deine eigenen benutzerdefinierten Aktionen erstellen.

Hier kannst du die Vorlage für unsere GitHub-Integration finden, die ein Element zu bestimmten Workflows öffnet, die mit bestimmten Schlussfolgerungen enden. Das Element kann mit Workflow-Daten versehen werden.

Um die Vorlage zu verwenden, gehe zur Seite Board-Automatisierungen und suche nach GitHub. Dort klickst du auf die Vorlage wie unten. 

Hinweis: Um GitHub Actions nutzen zu können, muss der Admin der GitHub-Organisation die Einstellung „Actions Read Permission“ zulassen. Solltest du dabei auf Probleme stoßen, kontaktiere uns bitte. 

Was musst du sonst noch wissen?

Funktioniert die Integration auch, wenn die Anwendung nicht in GitHub installiert wird?

• Nein, die Integration ist nicht möglich, ohne dass die Anwendung in GitHub installiert ist.

Kann das monday.com Konto mit mehreren Organisationen auf GitHub verbunden werden?

• Ja! Du kannst deine monday.com Konten mit mehreren GitHub Organisationen verbinden.

Um die monday.com Anwendung von GitHub zu deinstallieren, gehe zu deinem GitHub-Konto > Einstellungen > Anwendungen und suche monday.com. Scrolle nach unten zur Gefahrenzone und klicke auf Deinstallieren.