Hallo, Entdecker! An dieser Seite wird aktiv gearbeitet, oder sie wird noch übersetzt. Die neuesten und genauesten Informationen findest Du in unserer englischsprachigen Dokumentation.

Diese Version von GitHub Enterprise wird eingestellt am Diese Version von GitHub Enterprise wurde eingestellt am 2020-05-23. Es wird keine Patch-Freigabe vorgenommen, auch nicht für kritische Sicherheitsprobleme. Für eine bessere Leistung, verbesserte Sicherheit und neue Features nimm ein Upgrade auf die neueste Version von GitHub Enterprise vor. Wende Dich an den GitHub Enterprise-Support, um Hilfe beim Upgrade zu erhalten.

Artikelversion: Enterprise Server 2.17

Informationen zu Jekyll-Build-Fehler für GitHub Pages-Websites

Wenn beim Erstellen Ihrer GitHub Pages-Website (lokal oder auf GitHub Enterprise) mit Jekyll ein Fehler auftritt, erhalten Sie eine Fehlermeldung mit weiteren Informationen.

GitHub Pages ist verfügbar in öffentlichen Repositorys mitGitHub Free und GitHub Free für Organisationen, und in öffentlichen und privaten Repositorys mit GitHub Pro, GitHub Team, GitHub Enterprise Cloud, und GitHub Enterprise Server.

Inhalt dieses Artikels

Informationen zu Jekyll-Build-Fehlern

Manchmal kann es vorkommen, dass GitHub Pages nicht versucht, Ihre Website zu erstellen, nachdem Sie Änderungen zur Veröffentlichungsquelle Ihrer Website gepusht haben.

  • Sie führen den Push mit einem Deployment-Schlüssel durch. Wenn Sie Pushes zum Repository Ihrer Website automatisieren möchten, können Sie stattdessen einen Maschinenbenutzer einrichten. Weitere Informationen finden Sie unter „Deployment-Schlüssel verwenden“ in der die GitHub-Entwicklerdokumentation.
  • Sie verwenden einen Dienst für die fortlaufende Integration, der nicht zum Erstellen Ihrer Veröffentlichungsquelle konfiguriert ist. Travis CI erstellt beispielsweise nicht den Branch gh-pages, es sei denn, Sie fügen den Branch zu einer Liste mit sicheren Branches hinzu. Weitere Informationen finden Sie unter „Build anpassen“ auf Travis CI oder in der Dokumentation Ihres Dienstes für die fortlaufende Integration.

Hinweis: Es kann bis zu 20 Minuten dauern, bis die Änderungen auf Ihrer Website veröffentlicht werden, nachdem Sie die Änderungen zu GitHub Enterprise gepusht haben.

Wenn beim Versuch von Jekyll, Ihre Website zu erstellen, ein Fehler auftritt, wird eine Build-Fehlermeldung angezeigt. Es gibt zwei Hauptarten an Jekyll-Build-Fehlermeldungen.

  • Eine „Page-Build-Warnung“ (Seiten-Build-Warnung) bedeutet, dass Ihre Website erfolgreich erstellt wurde, Sie aber Änderungen vornehmen müssen, um zukünftige Probleme zu verhindern.
  • Eine Fehlermeldung „Page build failed“ (Seiten-Build fehlgeschlagen) bedeutet, dass Ihr 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 finden Sie unter „Behebung von Jekyll-Build-Fehlern bei GitHub Pages-Websites“.

Jekyll-Build-Fehlermeldungen anzeigen

Wir empfehlen Ihnen, Ihre Website lokal zu testen. Dadurch sehen Sie Build-Fehlermeldungen in der Befehlszeile und können Build-Fehler beheben, bevor Sie die Änderungen zu GitHub Enterprise pushen. Weitere Informationen finden Sie unter „GitHub Pages-Website lokal mit Jekyll testen“.

Wenn Sie Änderungen zu Ihrer Veröffentlichungsquelle auf GitHub Enterprise pushen, versucht GitHub Pages, Ihre Website zu erstellen. Wenn der Build fehlschlägt, wird eine E-Mail an Ihre primäre E-Mail-Adresse gesendet. Sie erhalten auch bei Build-Warnungen E-Mails-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 Ihre Website können Sie auf GitHub Enterprise auf der Registerkarte Settings (Einstellungen) des Repositorys Ihrer Website sehen.

Sie können einen Drittanbieterdienst, beispielsweise Travis CI, so konfigurieren, dass nach jedem Commit Fehlermeldungen angezeigt werden.

  1. Wenn Sie dies noch nicht getan haben, fügen Sie eine Datei namens Gemfile in das Root-Verzeichnis Ihrer Veröffentlichungsquelle hinzu. Die Gemfile-Datei sollte den folgenden Inhalt aufweisen:

    source `https://rubygems.org`
    gem `github-pages`
    
  2. Konfigurieren Sie das Repository Ihrer Website für den gewünschten Testdienst. Wenn Sie z. B. Travis CI verwenden möchten, fügen Sie eine Datei namens .travis.yml in das Root-Verzeichnis Ihrer Veröffentlichungsquelle hinzu, und zwar mit folgendem Inhalt:

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
    
  3. Sie müssen Ihr Repository ggf. mit dem Drittanbieter-Testdienst aktivieren. Weitere Informationen finden Sie in der Dokumentation Ihres Testdienstes.

Menschliche Unterstützung einholen

Du kannst das Gesuchte nicht finden?

Kontakt