Informationen zu Jekyll-Build-Fehlern
Manchmal kann es vorkommen, dass GitHub Pages nicht versucht, Deine Website zu erstellen, nachdem Du Änderungen zur Veröffentlichungsquelle Deiner Website übertragen hast.
- Du führst den Push mit einem Deployment-Schlüssel durch. Wenn Du Übertragungen zum Repository Deiner Website automatisieren möchtest, kannst du stattdessen einen Maschinenbenutzer einrichten. For more information, see "Managing deploy keys."
- Du verwendest einen Dienst für die fortlaufende Integration, der nicht zum Erstellen Deiner Veröffentlichungsquelle konfiguriert ist. Travis CI erstellt beispielsweise nicht den Branch
gh-pages, es sei denn, Du fügst den Branch zu einer Liste mit sicheren Branches hinzu. Weitere Informationen findest Du unter „Build anpassen“ auf Travis CI oder in der Dokumentation Deines Dienstes für die fortlaufende Integration.
Hinweis: Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Deiner Website veröffentlicht werden, nachdem Du die Änderungen zu GitHub Enterprise hinzugefügt hast.
Wenn beim Versuch von Jekyll, Deine Website zu erstellen, ein Fehler auftritt, wird eine Build-Fehlermeldung angezeigt. Es gibt zwei Hauptarten an Jekyll-Build-Fehlermeldungen.
- Eine „Page build warning“ (Seiten-Build-Warnung) bedeutet, dass Deine Website erfolgreich erstellt wurde, Du aber Änderungen vornehmen musst, um künftige Probleme zu verhindern.
- Eine Fehlermeldung „Page build failed“ (Seiten-Build fehlgeschlagen) bedeutet, dass Dein Build nicht abgeschlossen werden konnte. Wenn Jekyll einen Grund dafür erkennt, enthält die Fehlermeldung eine Beschreibung der Ursache.
Weitere Informationen zur Behebung von Build-Fehlern findest Du unter „Behebung von Jekyll-Build-Fehlern bei GitHub Pages-Websites.“
Jekyll-Build-Fehlermeldungen anzeigen
Wir empfehlen Dir, Deine Website lokal zu testen. Dadurch siehst Du Build-Fehlermeldungen in der Befehlszeile und kannst Build-Fehler beheben, bevor Du die Änderungen zu GitHub Enterprise überträgst. Weitere Informationen findest Du unter „Deine GitHub Pages-Website lokal mit Jekyll testen.“
Wenn Du Änderungen zu Deiner Veröffentlichungsquelle auf GitHub Enterprise überträgst, versucht GitHub Pages, Deine Website zu erstellen. Wenn der Build fehlschlägt, wird eine E-Mail an Deine primäre E-Mail-Adresse gesendet. Du erhältst auch bei Build-Warnungen E-Mail-Benachrichtigungen.
Du erhältst nur dann eine E-Mail, wenn der Support für ausgehende E-Mails auf Ihre GitHub Enterprise Server-Instanz aktiviert ist. Für weitere Informationen kontaktiere Deinen Websiteadministrator.
Build-Fehler (aber keine Build-Warnungen) für Deine Website kannst Du auf GitHub Enterprise auf der Registerkarte Settings (Einstellungen) des Repositorys Deiner Website sehen.
Du kannst einen Drittanbieterdienst, beispielsweise Travis CI, so konfigurieren, dass nach jedem Commit Fehlermeldungen angezeigt werden.
-
Wenn Du dies noch nicht getan hast, füge eine Datei namens Gemfile in das Root-Verzeichnis Deiner Veröffentlichungsquelle ein. Die Gemfile-Datei sollte den folgenden Inhalt aufweisen:
source `https://rubygems.org` gem `github-pages` -
Konfiguriere das Repository Deiner Website für die gewünschte Test-Dienstleistung. Wenn Du beispielsweise Travis CI verwenden möchtest, füge eine Datei namens .travis.yml in das Root-Verzeichnis Deiner Veröffentlichungsquelle ein, und zwar mit folgendem Inhalt:
language: ruby rvm: - 2.3 script: "bundle exec jekyll build" -
Du musst Dein Repository allenfalls mit dem Drittanbieter-Testdienst aktivieren. Weitere Informationen findest Du in der Dokumentation Deines Test-Dienstleisters.