Verwenden von GitHub-Bereitstellungen auf WordPress.com

GitHub Deployments integriert deine GitHub-Repositorys direkt in deine WordPress.com-Website und ermöglicht einen versionsgesteuerten, automatisierten Workflow für die Bereitstellung von Plugins, Themes oder vollständigen Website-Änderungen. Dieser Ratgeber behandelt den Einrichtungsprozess und die Verwaltung der verbundenen Repositorys.

Diese Funktion ist auf Websites mit den WordPress.com-Tarifen Business und Commerce verfügbar. Wenn du einen Business-Tarif hast, aktiviere ihn unbedingt. Führe für kostenlose Websites und Websites mit Persönlich- und Premium-Tarif ein Tarif-Upgrade durch, um auf diese Funktion zuzugreifen.

Bevor du ein GitHub-Repository auf deiner WordPress.com-Website bereitstellen kannst, musst du zunächst eine Verbindung einrichten. Gehe dazu folgendenmaßen vor:

1. Besuche deine Websites-Seite unter https://wordpress.com/sites
2. Klicke auf den Namen deiner Website, um die Website-Übersicht anzuzeigen.
3. Klicke auf den Tab Bereitstellungen.
4. Klicke auf den Button Repository verbinden. Wenn du jetzt eine Liste mit Repositorys siehst, ist dein GitHub-Konto bereits verbunden. Fahre fort mit Schritt 11.
5. Klicke auf den Button WordPress.com-App installieren.
6. Ein neues Fenster öffnet sich und du wirst aufgefordert, dich bei deinem GitHub-Konto anzumelden, falls du das noch nicht getan hast. Dann siehst du diesen Bildschirm:

7. Klicke auf den Button WordPress.com für Entwickler autorisieren.
8. Wähle die GitHub-Organisation oder das GitHub-Konto aus, in der/dem sich dein Repository befindet.
9. Wähle aus, welche Repositorys du verbinden möchtest:
   • Alle Repositorys: Wenn du diese Option auswählst, erhält WordPress.com Zugriff auf alle aktuellen und zukünftigen Repositorys, die mit dem ausgewählten GitHub-Konto verbunden sind. Dies schließt öffentliche schreibgeschützte Repositorys ein.
   • Nur ausgewählte Repositorys: Wenn du diese Option auswählst, kannst du entscheiden, auf welche Repositorys WordPress.com im ausgewählten GitHub-Konto zugreifen kann. 
10. Sobald du eine Option ausgewählt hast, klicke auf den Button Installieren .
11. Das neue Fenster wird geschlossen und du wirst zu WordPress.com zurückgeleitet. Die von dir ausgewählten Repositorys sollten zusammen mit dem GitHub-Konto aufgelistet werden, das mit diesem Repository verknüpft ist:

12. Klicke neben dem Repository, das du verbinden möchtest, auf Auswählen.

Jetzt solltest du WordPress.com für Entwickler unter deinen Autorisierten GitHub-Apps und Installierten GitHub-Apps sehen.

Nachdem du ein Repository ausgewählt hast, musst du die Bereitstellungseinstellungen anpassen:

• Bereitstellungsbranch: Als Standard ist der Standardbranch des Repositorys festgelegt (üblicherweise main), du kannst den Branch aber nach Belieben ändern.
• Zielverzeichnis: Der Serverordner, in dem die Dateien bereitgestellt werden sollen. Für Plugins ist das /wp-content/plugins/my-plugin-name, für Themes /wp-content/themes/my-theme-name. Für eine teilweise Website-Bereitstellung (d. h. mehrere Plugins oder Themes) kannst du /wp-contentverwenden. Die Inhalte eines Repositorys werden mit den bestehenden Inhalten der WordPress-Website im angegebenen Verzeichnis zusammengeführt.
• Automatische Bereitstellungen: Es gibt zwei Möglichkeiten zur Bereitstellung auf WordPress.com:
  • Automatisch: Sobald der Code aktiviert ist, wird er auf deiner Website WordPress.com bereitgestellt. Automatische Bereitstellungen werden für Staging-Websites empfohlen.
  • Manuell: Der Code wird erst bereitgestellt, wenn du eine Bereitstellung anforderst. Die manuelle Bereitstellung wird für veröffentlichte Websites empfohlen.
• Bereitstellungsmodus: Es gibt zwei Arten von Bereitstellungen:
  • Einfach: In diesem Modus werden alle Dateien aus einem Branch des Repositorys auf die Website kopiert und ohne Nachbearbeitung bereitgestellt.
  • Erweitert: In diesem Modus kannst du ein Workflow-Skript verwenden, das individuelle Anpassungen des Builds ermöglicht, z. B. das Installieren von Composer-Abhängigkeiten, das Durchführen von Code-Tests vor der Bereitstellung und das Steuern der Dateibereitstellung. Ideal für Repositorys, die Composer- oder Node-Software benötigen. Weitere Informationen findest du unten unter „Erweiterte Bereitstellung“.

Sobald alle Einstellungen konfiguriert wurden, klicke auf den Button Verbinden. Dein Repository wird hinzugefügt:

Beachte, dass du die erste Bereitstellung entweder automatisch oder manuellauslösen musst. Du kannst dann jederzeit ein anderes Repository verbinden, indem du auf den Button Repository verbinden klickst.

Mit der erweiterten Bereitstellung kannst du ein Workflow-Skript bereitstellen, um Dateien in deinem Repository vor der Bereitstellung zu verarbeiten. Dies eröffnet dir viele Möglichkeiten, wie das Überprüfen des Codes, um sicherzustellen, dass er den Codierungsstandards deines Teams entspricht, das Ausführen von Komponententests, das Ausschließen von Dateien aus der Bereitstellung, das Installieren von Abhängigkeiten und vieles mehr. Sieh dir zunächst unsere Workflow-Rezepte an.

So richtest du die erweiterte Bereitstellung ein:

1. Ein Formular wird angezeigt, in dem du die Bereitstellung konfigurieren kannst.
2. Klicke auf den Namen des Repositorys, um die Verbindung zu verwalten.
3. Wähle auf der rechten Seite unter Bereitstellungsmodus auswählen die Option Erweitert.

4. Wenn das Repository bereits eine Workflow-Datei enthält, kannst du sie hier auswählen. Das System prüft die Datei auf Fehler. Wenn keine Fehler gefunden werden, fahre mit Schritt 7 fort.
5. Du kannst auch die Option Neuen Workflow erstellen auswählen, um eine vorkonfigurierte Workflow-Datei hinzuzufügen. Wenn du diese Option auswählst, wird die Workflow-Datei wpcom.yml überschrieben, falls sie bereits in deinem Repository existiert.
6. Klicke auf den Button Workflow für mich installieren, um die Workflow-Datei in das Repository zu übernehmen.
7. Sobald ein Workflow hinzugefügt und verifiziert wurde, klicke auf Aktualisieren. Dein Repository verwendet ab jetzt erweiterte Bereitstellungen.

Nachdem du dein GitHub-Repository mit einer Website verbunden hast, besteht der nächste Schritt darin, deinen Code bereitzustellen. Es sind zwei Bereitstellungsmethoden verfügbar: Automatisch und Manuell.

Automatische Bereitstellungen werden für aktive veröffentlichte Websites nicht empfohlen, da alle Codeänderungen im Repository von GitHub automatisch auf der aktiven Website bereitgestellt werden. Du könntest allerdings stattdessen eine automatische Bereitstellung auf einer Staging-Website einrichten und sie mit der aktiven Website synchronisieren, sobald du so weit bist.

Manuelle Bereitstellungen geben dir mehr Kontrolle darüber, wann deine Codeänderungen aktiv werden, da du jede Bereitstellung manuell auslösen musst. Wir empfehlen manuelle Bereitstellungen, wenn du keine Staging-Website verwenden möchtest.

Manuelle Bereitstellung auslösen

1. Besuche deine Websites-Seite unter https://wordpress.com/sites
2. Klicke auf den Namen deiner Website, um die Website-Übersicht anzuzeigen.
3. Klicke auf den Tab Bereitstellungen.
4. Klicke im Repository, das du bereitstellen möchtest, auf das Ellipsenmenü (⋮).
5. Wähle Manuelle Bereitstellung auslösen. Es sollte eine Bannerbenachrichtigung mit der Aufschrift „Bereitstellungsausführung erstellt“ angezeigt werden, und der Bereitstellungsstatus wird in „In Warteschlange“ geändert.
6. Warte, bis die Bereitstellung abgeschlossen ist (der Status wird in „Bereitgestellt“ geändert).

7. Klicke erneut auf das Ellipsenmenü (⋮) und wähle Bereitstellungsausführungen anzeigen. 
8. Im Bereitstellungsprotokoll werden der Autor und der bereitgestellte Commit angezeigt. Wenn du auf den Eintrag „Bereitstellungsausführung“ klickst, kannst du weitere Informationen anzeigen.

So verwaltest du deine bestehenden GitHub-Repository-Verbindungen:

1. Besuche deine Websites-Seite unter https://wordpress.com/sites
2. Klicke auf den Namen deiner Website, um die Website-Übersicht anzuzeigen.
3. Klicke auf den Tab Bereitstellungen.
4. Dann sollte dir die Verbindungsliste angezeigt werden. 

Die Verbindungsliste wird angezeigt, wenn mindestens eine Verbindung zwischen einem GitHub-Repository und deiner Website besteht. Die Liste enthält relevante Informationen für jede Verbindung, z. B. den Repository-Namen und die Verzweigung, den letzten Commit, der auf einer Website bereitgestellt wurde, den Zeitpunkt, zu dem der Code platziert wurde, die Dauer der Bereitstellungsausführung und den Status.

Nach einem Klick auf das Ellipsenmenü (⋮) stehen dir weitere Aktionen zur Verfügung:

• Manuelle Bereitstellung auslösen: Startet eine Bereitstellungsausführung für den letzten Commit des konfigurierten Branch.
• Bereitstellungsausführungen ansehen: Öffnet die Ansicht Protokolle für die Bereitstellungsausführung für das verbundene Repository.
• Verbindung konfigurieren: Öffnet die Ansicht Verbindung verwalten für das Repository.
• Repository trennen: Entfernt die Verbindung zwischen dem Repository und der Website.

Die Ausführungsprotokolle der Bereitstellung bieten eine detaillierte, Schritt-für-Schritt-Aufzeichnung jeder Bereitstellung, unabhängig davon, ob sie automatisch oder manuell ausgelöst wird. Diese Protokolle helfen dir dabei, Änderungen zu verfolgen, den Bereitstellungsstatus zu überwachen und auftretende Probleme zu beheben. Dank des Zugriffs auf Protokolle der letzten 10 Ausführungen innerhalb von 30 Tagen kannst du leicht überprüfen, was während jeder Bereitstellung passiert ist, und sicherstellen, dass alles reibungslos abläuft.

So überprüfst die Protokolle einer Bereitstellung:

1. Besuche deine Websites-Seite unter https://wordpress.com/sites
2. Klicke auf den Namen deiner Website, um die Website-Übersicht anzuzeigen.
3. Klicke auf den Tab Bereitstellungen.
4. Klicke auf das Ellipsenmenü (⋮) neben dem Repository, für das du die Protokolle anzeigen möchtest.
5. Wähle Bereitstellungsausführungen anzeigen aus.
6. Die Listenansicht für Bereitstellungsausführungen zeigt die Commits, die auf der Website bereitgestellt wurden, den Bereitstellungsstatus, das Datum und die Dauer.
7. Klicke auf eine beliebige Stelle in einem Durchlauf, um die Bereitstellung zu erweitern und weitere Informationen anzuzeigen.

Die Protokolle zeichnen alle ausgeführten Befehle auf, vom Abruf des Codes von GitHub bis hin zu dessen Platzierung im Zielverzeichnis. Du kannst Zeilen des Protokolls erweitern, um weitere Informationen zu sehen, indem du auf Mehr anzeigen klickst.

Wenn du ein GitHub-Repository von deiner Website trennst, haben zukünftige Änderungen am Repository keine Auswirkungen mehr auf deine Website. Standardmäßig bleiben die bereitgestellten Dateien auf deiner Website erhalten, aber du hast die Möglichkeit, sie während des Trennungsvorgangs zu entfernen.

So entfernst du ein Repository:

1. Besuche deine Websites-Seite unter https://wordpress.com/sites
2. Klicke auf den Namen deiner Website, um die Website-Übersicht anzuzeigen.
3. Klicke auf den Tab Bereitstellungen.
4. Klicke im Repository auf das Ellipsenmenü (⋮).
5. Wähle Repository trennen.
6. Ein Dialogfeld wird angezeigt. Klicke auf den Schalter, um die zugehörigen Dateien von der Website zu entfernen.
7. Klicke auf Repository trennen, um das Dialogfeld zu schließen und das Repository zu trennen.

Beachte, dass WordPress.com für Entwickler weiterhin in deinen Installierten GitHub-Apps und deinen Autorisierten GitHub-Apps angezeigt wird. Dies liegt daran, dass WordPress.com zwar weiterhin Zugriff auf das Repository hat, die Verbindung aber gelöscht wurde.

Du kannst auch den Zugriff von WordPress.com auf dein GitHub-Konto widerrufen. Das ist jederzeit über deine Anwendungseinstellungen auf GitHub möglich. 

So widerrufst du den Zugriff autorisierter Apps auf dein GitHub-Konto:

1. Gehe zu den autorisierten GitHub-Apps.
2. Klicke neben WordPress.com für Entwickler auf Widerrufen.
3. Klicke auf den Button Verstanden, Zugriff widerrufen.

Selbst wenn du den Zugriff durch autorisierte Apps widerrufst, kann der Code dennoch bereitgestellt werden, da die App WordPress.com für Entwickler auf den ausgewählten Konten installiert bleibt.

So widerrufst du den Zugriff auf die WordPress.com-Installation und deaktivierst die Möglichkeit, Code auf deiner WordPress.com-Website bereitzustellen:

1. Gehe zu  Installierte GitHub-Apps.
2. Klicke neben WordPress.com für Entwickler auf Konfigurieren.
3. Klicke im Bereich Gefahrenzone auf Deinstallieren und klicke bei der entsprechenden Aufforderung auf OK.

Das Entfernen von WordPress.com aus der Liste der autorisierten Apps bedeutet nicht, dass die Repositorys gelöscht werden oder nicht mehr funktionieren. Deine Repositorys existieren auf GitHub weiterhin, auch nachdem du den Zugriff durch WordPress.com widerrufst, aber WordPress.com kann keinen Code mehr bereitstellen.