Eine Veröffentlichungsquelle für deine GitHub Pages-Website konfigurieren

Informationen zu Veröffentlichungsquellen

Du kannst deine Website veröffentlichen, wenn Änderungen an einen bestimmten Branch gepusht werden, oder du kannst einen GitHub Actions-Workflow schreiben, um deine Website zu veröffentlichen. Um GitHub Actions als Veröffentlichungsquelle für GitHub Pages zu verwenden, muss ein Site-Administrator GitHub Actions für GitHub Enterprise Server aktivieren. Weitere Informationen finden Sie unter Aktivieren von GitHub Actions für GitHub Enterprise Server.

Wenn du keine Kontrolle über den Buildprozess für deine Website benötigst, wird empfohlen, deine Website zu veröffentlichen, wenn Änderungen an einen bestimmten Branch gepusht werden. Du kannst angeben, welcher Branch und welcher Ordner als Veröffentlichungsquelle verwendet werden sollen. Der Quellbranch kann ein beliebiger Branch in deinem Repository sein, und der Quellordner kann entweder der Stamm des Repositorys (/) im Quellbranch oder der Ordner /docs im Quellbranch sein. Wenn Änderungen an den Quellbranch gepusht werden, werden die Änderungen im Quellordner in deiner GitHub Pages-Website veröffentlicht.

Wenn du einen anderen Buildprozess als Jekyll verwenden möchtest oder nicht möchtest, dass deine kompilierten statischen Dateien in einem dedizierten Branch enthalten sind, wird empfohlen, einen GitHub Actions-Workflow zu schreiben, um deine Website zu veröffentlichen. GitHub bietet Workflowvorlagen für gängige Veröffentlichungsszenarios, die dir beim Schreiben von Workflows helfen.

Veröffentlichen aus einem Branch

1. Stelle sicher, dass der Branch, den du als Veröffentlichungsquelle nutzen möchtest, bereits in deinem Repository vorhanden ist.

2. Navigiere auf GitHub zum Repository deiner Website.

3. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

4. Klicke im Abschnitt „Code and automation“ der Randleiste auf Pages.

5. Wähle unter „Erstellen und Bereitstellen“ unter „Quelle“ die Option Aus einem Branch bereitstellen aus.

6. Wähle unter „Build & Deployment“ im Dropdownmenü für Branches eine Veröffentlichungsquelle aus.

1. Verwende wahlweise das Dropdownmenü für Ordner, um einen Ordner für deine Veröffentlichungsquelle auszuwählen.

1. Klicken Sie auf Speichern.

Fehlerbehebung beim Veröffentlichen aus einem Zweig

Wenn du den docs-Ordner in jedem Branch als Veröffentlichungsquelle auswählst und später den /docs-Ordner aus diesem Branch in deinem Repository entfernst, wird deine Website nicht erstellt, und du erhältst eine Seiten-Buildfehlermeldung aufgrund eines fehlenden /docs-Ordners. Weitere Informationen finden Sie unter Problembehandlung bei Jekyll-Buildfehlern für GitHub Pages-Websites.

Veröffentlichen mit einem benutzerdefinierten GitHub Actions Workflow

So konfigurieren Sie Ihre Website für die Veröffentlichung mit GitHub Actions:

1. Navigiere auf GitHub zum Repository deiner Website.

2. Klicke unter dem Repositorynamen auf Settings. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.

   

3. Klicke im Abschnitt „Code and automation“ der Randleiste auf Pages.

4. Wählen Sie unter "Erstellen und Bereitstellen" unter "Quelle" die Option GitHub Actions aus.

5. GitHub schlägt mehrere Workflowvorlagen vor. Wenn du bereits über einen Workflow zum Veröffentlichen deiner Website verfügst, kannst du diesen Schritt überspringen. Wählen Sie andernfalls eine der Optionen zum Erstellen eines GitHub Actions Workflows aus. Weitere Informationen zum Erstellen Ihres benutzerdefinierten Workflows finden Sie unter Erstellen eines benutzerdefinierten GitHub Actions Workflows zum Veröffentlichen Ihrer Website.

GitHub Pages ordnet den GitHub Pages-Einstellungen keinen bestimmten Workflow zu. Die GitHub Pages Einstellungen verweisen auf die Workflow-Ausführung, mit der Ihre Website zuletzt bereitgestellt wurde.

Erstellen eines benutzerdefinierten GitHub Actions Workflows zum Veröffentlichen Ihrer Website

Weitere Informationen zu GitHub Actions findest du unter GitHub Actions Dokumentation.

Wenn Sie Ihre Website für die Veröffentlichung mit GitHub Actions konfigurieren, schlägt GitHub Workflowvorlagen für gängige Veröffentlichungsszenarien vor. Der allgemeine Ablauf eines Workflows umfasst Folgendes:

1. Wird ausgelöst, wenn ein Push in den Standardbranch des Repositorys erfolgt oder wenn der Workflow manuell über die Registerkarte „Aktionen“ ausgeführt wird.
2. Verwenden Sie die Aktion actions/checkout, um den Repositoryinhalt auszuchecken.
3. Erstellen Sie alle statischen Websitedateien, sofern dies von Ihrer Website verlangt wird.
4. Verwenden Sie die Aktion actions/upload-pages-artifact, um die statischen Dateien als Artefakt hochzuladen.
5. Stellen Sie das Artefakt mit der Aktion actions/deploy-pages bereit, wenn der Workflow durch einen Push an den Standardbranch ausgelöst wurde. Dieser Schritt wird übersprungen, wenn der Workflow durch einen Pull Request ausgelöst wurde.

Die Workflowvorlagen nutzen eine Bereitstellungsumgebung namens github-pages. Wenn dein Repository noch keine Umgebung namens github-pages enthält, wird sie automatisch erstellt. Es wird empfohlen, eine Bereitstellungsschutzregel hinzuzufügen, damit nur der Standardbranch für diese Umgebung bereitgestellt werden kann. Weitere Informationen finden Sie unter Verwalten von Umgebungen für die Bereitstellung.

Fehlerbehebung bei der Veröffentlichung mit einem benutzerdefinierten GitHub Actions Workflow

Informationen zur Problembehandlung für Ihren GitHub Actions Workflow finden Sie unter Überwachen von Workflows.