Wie können wir dir helfen?

Die GitHub-Integration

 

monday-dev-banner (2).png

 

 

Wir wissen, wie wichtig eine stabile Integration zwischen deinem Quellcode-Tool und monday.com ist, deshalb möchten wir dir die GitHub-Integration vorstellen.

Die einmalig zu installierende Integration mit GitHub bietet leistungsfähige Vorlagen, damit dein Team in einem nahtlosen Softwareentwicklungsprozess arbeiten kann, von der Planung und Nachverfolgung von Sprints auf monday dev bis zur Ausführung des perfekten Codes auf GitHub.

Bei der Integration handelt es sich um eine Integration von Berechtigungen auf Konto-Ebene. Sobald die Integration in nur wenigen Schritten vorinstalliert ist, kann jeder in deinem Team neue Vorlagen erstellen.

 

Tipp: Damit die GitHub-Integration erfolgreich synchronisiert werden kann, musst du zunächst die monday.com Anwendung auf GitHub installieren. Außerdem musst du Admin deines monday.com Kontos sein und die Admin-Berechtigung für die GitHub Organisation haben, um die Anwendung zu installieren.
Um zu beginnen, rufe github.com/apps/monday-com-github auf, und installiere die monday.com App auf GitHub:

Devs Install GitHub.png

 

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

Devs Choose Organization.png

 

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

Devs monday Permissions.png

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
  • Metadatenmonday.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 Requestsmonday.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:Group 64 (54).png

 

Sobald du in der Automatisierungszentrale bist, suche in der Suchleiste nach „GitHub“:Group 64 (55).png

 

Klicke auf das Banner „GitHub“, um die Vorlagen zu sehen, die unsere Integration bietet:Screenshot 2024-07-07 at 17.46.19 1.png

 

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.

Group 64 (56).png

 

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.

GitHub Two-Way Sync.gif

 

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.

 

Hinweis: Du musst ein „#“-Symbol vor die Nummer in GitHub setzen, damit die monday.com Spalte Element-ID die Verbindung erkennt. Beispiel: In GitHub muss es „#376479“ heißen, nicht „376479“. 

 

Group 64 (57) (1) 1.png

 

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.

 

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.Screenshot 2024-07-07 at 17.29.51 1.png

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, rufe die Automatisierungszentrale auf und suche nach GitHub. Dort klickst du auf die Vorlage wie unten. download (19).gif

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“.

 

Wenn du Hilfe bei der Erstellung von benutzerdefinierten Integrationen brauchst, bieten wir auch eine Option für kostenpflichtige Unterstützung über unser Netzwerk zertifizierter monday.com Partner an. Wenn du daran interessiert bist, fülle dieses Formular aus und jemand wird sich in Kürze mit dir in Verbindung setzen!

 

Wenn du Fragen hast, wende dich einfach hier an unser Team. Wir sind rund um die Uhr erreichbar und helfen gerne!