Skip to main content

À propos des erreurs de build Jekyll pour les sites GitHub Pages

Si Jekyll rencontre une erreur lors de la génération de votre site GitHub Pages en local ou sur GitHub Enterprise Server, vous recevez un message d’erreur avec davantage d’informations.

Qui peut utiliser cette fonctionnalité ?

GitHub Pages est disponible dans les référentiels publics avec GitHub Free et GitHub Free pour les organisations, et dans les référentiels publics et privés avec GitHub Pro, GitHub Team, GitHub Enterprise Cloud et GitHub Enterprise Server.

À propos des erreurs de build Jekyll

Si vous publiez depuis une branche, parfois, GitHub Pages ne tente pas de générer votre site après avoir poussé les changements vers la source de publication de votre site.

  • Vous poussez avec une clé de déploiement. Si vous souhaitez automatiser les poussées vers le dépôt de votre site, vous pouvez configurer un utilisateur d’ordinateur à la place. Pour plus d’informations, consultez « Gestion des clés de déploiement ».
  • Vous utilisez un service CI qui n’est pas configuré pour générer votre source de publication. Par exemple, Travis CI ne génère pas la branche gh-pages, sauf si vous ajoutez la branche à une liste sécurisée. Pour plus d’informations, consultez « Personnalisation de la build » sur Travis CI ou la documentation de votre service CI.

Note

La publication des changements de votre site peut prendre jusqu’à 10 minutes après les avoir poussés vers GitHub Enterprise Server.

Si Jekyll tente de générer votre site et rencontre une erreur, vous recevez un message d’erreur de build. Il existe deux principaux types de messages d’erreur de build Jekyll.

  • Un message « Avertissement de génération de page » signifie que votre build s’est terminée correctement, mais que vous devrez peut-être apporter des changements pour éviter des problèmes à venir.
  • Un message « Échec de génération de page » signifie que votre build a échoué. Si Jekyll est en mesure de détecter une raison de l’échec, un message d’erreur descriptif s’affiche.

Pour plus d’informations sur la résolution des erreurs de build, consultez « Résolution des erreurs de build Jekyll pour les sites GitHub Pages ».

Affichage des échecs de build de votre dépôt dans GitHub Enterprise Server

Vous pouvez voir les échecs de build (mais pas les avertissements de build) pour votre site dans GitHub Enterprise Server sous l’onglet Paramètres du dépôt de votre site.

Affichage des messages d’erreur de build Jekyll en local

Nous vous recommandons de tester votre site en local, ce qui vous permet de voir les messages d’erreur de build sur la ligne de commande et de corriger les échecs de build avant de pousser les changements vers GitHub Enterprise Server. Pour plus d’informations, consultez « Test de votre site GitHub Pages localement avec Jekyll ».

Affichage des messages d’erreur de build Jekyll dans votre demande de tirage

Si vous publiez depuis une branche, lorsque vous créez une demande de tirage pour mettre à jour votre source de publication dans GitHub Enterprise Server, vous pouvez voir les messages d’erreur de version sous l’onglet Vérifications de la demande de tirage. Pour plus d’informations, consultez « À propos des vérifications d’état ».

Si vous publiez avec un workflow GitHub Actions personnalisé afin de voir les messages d’erreur de version dans votre demande de tirage, vous devez configurer votre workflow pour qu’il s’exécute sur le déclencheur pull_request. Lorsque vous effectuez cette opération, nous vous recommandons d’ignorer les étapes de déploiement si le workflow a été déclenché par l’événement pull_request. Cela vous permet de voir les erreurs de build sans déployer les modifications de votre demande de tirage sur votre site. Pour plus d’informations, consultez « Événements qui déclenchent des flux de travail » et « Évaluer les expressions dans les workflows et les actions ».

Affichage des erreurs de build Jekyll par e-mail

Si vous publiez depuis une branche, lorsque vous publiez des changements vers votre source de publication dans GitHub Enterprise Server, GitHub Pages tente de générer votre site. Si la build échoue, vous recevez un e-mail dans votre adresse e-mail principale.

Vous ne recevrez qu’un e-mail si la prise en charge des e-mails sortants est activée dans votre instance GitHub Enterprise Server. Pour plus d’informations, contactez votre administrateur de site.

Si vous publiez avec un workflow GitHub Actions personnalisé afin de recevoir les e-mails sur les erreurs de build dans votre demande de tirage, vous devez configurer votre workflow pour qu’il s’exécute sur le déclencheur pull_request. Lorsque vous effectuez cette opération, nous vous recommandons d’ignorer les étapes de déploiement si le workflow a été déclenché par l’événement pull_request. Cela vous permet de voir les erreurs de build sans déployer les modifications de votre demande de tirage sur votre site. Pour plus d’informations, consultez « Événements qui déclenchent des flux de travail » et « Évaluer les expressions dans les workflows et les actions ».

Affichage des messages d’erreur de build Jekyll dans votre demande de tirage avec un service CI tiers

Vous pouvez configurer un service tiers, tel que Travis CI, pour afficher les messages d’erreur après chaque commit.

  1. Si ce n’est déjà fait, ajoutez un fichier appelé Gemfile à la racine de votre source de publication, avec le contenu suivant :

    source `https://rubygems.org`
    gem `github-pages`
    
  2. Configurez le dépôt de votre site pour le service de test de votre choix. Par exemple, pour utiliser Travis CI, ajoutez un fichier appelé .travis.yml à la racine de votre source de publication, avec le contenu suivant :

    language: ruby
    rvm:
      - 2.3
    script: "bundle exec jekyll build"
    
  3. Vous devrez peut-être activer votre dépôt avec le service de test tiers. Pour plus d’informations, consultez la documentation de votre service de test.