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 Siteadministrator GitHub Actions für GitHub Enterprise Server aktivieren. Weitere Informationen findest du 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 Enterprise Server bietet Workflowvorlagen für häufiger vorkommende Veröffentlichungsszenarien, die Ihnen beim Schreiben von Workflows helfen.
Warnung: Wenn dein Websiteadministrator öffentliche Seiten aktiviert hat, sind GitHub Pages-Websites im Internet öffentlich zugänglich, auch wenn das Repository für die Website privat oder intern ist. Wenn das Repository deiner Website vertrauliche Daten enthält, solltest Du diese vor der Veröffentlichung entfernen. Weitere Informationen findest du unter Konfigurieren von GitHub Seiten für dein Unternehmen und unter Informationen zu Repositorys.
Veröffentlichen aus einem Branch
-
Stelle sicher, dass der Branch, den du als Veröffentlichungsquelle nutzen möchtest, bereits in deinem Repository vorhanden ist.
-
Navigiere in GitHub Enterprise Server zum Repository Deiner Website.
-
Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.
-
Klicke im Abschnitt „Code und Automatisierung“ der Seitenleiste auf Seiten.
-
Wähle unter „Erstellen und Bereitstellen“ unter „Quelle“ die Option Aus einem Branch bereitstellen aus.
-
Wähle unter „Build & Deployment“ im Dropdownmenü für Branches eine Veröffentlichungsquelle aus.
-
Verwende wahlweise das Dropdownmenü für Ordner, um einen Ordner für deine Veröffentlichungsquelle auszuwählen.
-
Klicke auf Speichern.
Problembehandlung beim Veröffentlichen aus einem Branch
Note: If your repository contains symbolic links, you will need to publish your site using a GitHub Actions workflow. For more information about GitHub Actions, see "GitHub Actions-Dokumentation."
Hinweise:
-
Wenn die Veröffentlichung über einen Branch erfolgt und deine Website nicht automatisch veröffentlicht wurde, stelle sicher, dass jemand mit Administratorberechtigungen und einer verifizierten E-Mail-Adresse einen Push an die Veröffentlichungsquelle ausgeführt hat.
-
Commits, die von einem GitHub Actions-Workflow gepusht werden, der das
GITHUB_TOKEN
verwendet, lösen keinen GitHub Pages-Build aus.
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 findest du unter Fehlerbehebung bei Jekyll-Build-Fehlern für GitHub Pages-Websites.
Veröffentlichen mit einem benutzerdefinierten GitHub Actions-Workflow
So konfigurierst du deine Website für das Veröffentlichen mit GitHub Actions:
-
Navigiere in GitHub Enterprise Server zum Repository Deiner Website.
-
Wähle unter dem Namen deines Repositorys die Option Einstellungen aus. Wenn die Registerkarte „Einstellungen“ nicht angezeigt wird, wähle im Dropdownmenü die Option Einstellungen aus.
-
Klicke im Abschnitt „Code und Automatisierung“ der Seitenleiste auf Seiten.
-
Wähle unter „Build & Deployment“ unter „Quelle“ GitHub Actions aus.
-
GitHub Enterprise Server schlägt mehrere Workflowvorlagen vor. Wenn du bereits über einen Workflow zum Veröffentlichen deiner Website verfügst, kannst du diesen Schritt überspringen. Anderenfalls wähle eine der Optionen aus, um einen GitHub Actions-Workflow zu erstellen. Weitere Informationen zum Erstellen deines benutzerdefinierten Workflows findest du unter Erstellen eines benutzerdefinierten GitHub Actions-Workflows zum Veröffentlichen deiner Website.
Den GitHub Pages-Einstellungen wird von den GitHub Pages kein bestimmter Workflow zugeordnet. Die GitHub Pages-Einstellungen werden jedoch mit der Workflowausführung verknüpft, von der deine Website zuletzt bereitgestellt wurde.
Erstellen eines benutzerdefinierten GitHub Actions-Workflows zum Veröffentlichen deiner Website
Weitere Informationen zu GitHub Actions findest du unter GitHub Actions-Dokumentation.
Wenn Sie die Website so konfigurieren, dass sie mit GitHub Actions veröffentlicht wird, schlägt GitHub Enterprise Server Workflowvorlagen für häufiger vorkommende Veröffentlichungsszenarien vor. Der allgemeine Ablauf eines Workflows umfasst Folgendes:
- Wird ausgelöst, wenn ein Push in den Standardbranch des Repositorys erfolgt oder wenn der Workflow manuell über die Registerkarte „Aktionen“ ausgeführt wird.
- Auschecken des Repositoryinhalts mit der Aktion
actions/checkout
. - Erstellen statischer Websitedateien (sofern von der Website verlangt).
- Hochladen der statischen Datei als Artefakt mit der Aktion
actions/upload-pages-artifact
. - Bereitstellen des Artefakts mit der Aktion
actions/deploy-pages
, 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 findest du unter Verwalten von Umgebungen für die Bereitstellung.
Problembehandlung beim Veröffentlichen mit einem benutzerdefinierten GitHub Actions-Workflow
Informationen zur Problembehandlung deines GitHub Actions-Workflows findest du unter Überwachungs- und Problembehandlungsworkflows.