Configuration d’une source de publication pour votre site GitHub Pages

À propos des sources de publication

Vous pouvez publier votre site lorsque des modifications sont poussées vers une branche spécifique ou vous pouvez écrire un workflow GitHub Actions pour publier votre site. Pour utiliser GitHub Actions en tant que source de publication de GitHub Pages, un administrateur de site doit activer GitHub Actions pour GitHub Enterprise Server. Pour plus d’informations, consultez « Activation de GitHub Actions pour GitHub Enterprise Server ».

Si vous n’avez pas besoin de contrôle sur le processus de génération de votre site, nous vous recommandons de publier votre site lorsque des modifications sont poussées vers une branche spécifique. Vous pouvez spécifier la branche et le dossier à utiliser comme source de publication. La branche source peut être n’importe quelle branche de votre dépôt, et le dossier source peut être la racine du dépôt (/) sur la branche source ou un dossier /docs de la branche source. Chaque fois que des modifications sont poussées vers la branche source, les modifications du dossier source sont publiées sur votre site GitHub Pages.

Si vous souhaitez utiliser un processus de génération autre que Jekyll ou si vous ne souhaitez pas qu’une branche dédiée contienne vos fichiers statiques compilés, nous vous recommandons d’écrire un workflow GitHub Actions pour publier votre site. GitHub Enterprise Server fournit des modèles de workflow pour les scénarios de publication courants afin de vous aider à écrire votre workflow.

Publication à partir d’une branche

1. Assurez-vous que la branche que vous souhaitez utiliser comme source de publication existe déjà dans votre dépôt.

2. Dans GitHub Enterprise Server, accédez au dépôt de votre site.

3. Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

4. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Pages.

5. Sous « Génération et déploiement », sous « Source », sélectionnez Déployer à partir d’une branche.

6. Sous « Génération et déploiement », utilisez le menu déroulant Branche et sélectionnez une source de publication.

   

7. Si vous le souhaitez, utilisez le menu déroulant de dossiers afin de sélectionner un dossier pour votre source de publication.

   

8. Cliquez sur Enregistrer.

Résolution des problèmes de publication à partir d’une branche

Si vous choisissez le dossier docs sur n’importe quelle branche comme source de publication, supprimez ultérieurement le dossier /docs de cette branche dans votre référentiel, votre site ne sera pas généré et vous recevrez un message d’erreur de génération de page en raison d’un dossier /docs manquant. Pour plus d’informations, consultez « Résolution des erreurs de build Jekyll pour les sites GitHub Pages ».

Publication avec un workflow GitHub Actions personnalisé

Pour configurer votre site à publier avec GitHub Actions :

1. Dans GitHub Enterprise Server, accédez au dépôt de votre site.

2. Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

   

3. Dans la section « Code et automatisation » de la barre latérale, cliquez sur Pages.

4. Sous « Générer et déploiement », sous « Source », sélectionnez GitHub Actions .

5. GitHub Enterprise Server proposera plusieurs modèles de workflow. Si vous disposez déjà d’un workflow pour publier votre site, vous pouvez ignorer cette étape. Sinon, choisissez l’une des options permettant de créer un workflow GitHub Actions. Pour plus d’informations sur la création de votre flux de travail personnalisé, consultez Création d’un flux de travail GitHub Actions personnalisé pour publier votre site.

   GitHub Pages n’associe pas de workflow spécifique aux paramètres GitHub Pages. Toutefois, les paramètres GitHub Pages sont liés à l’exécution du workflow qui a déployé votre site le plus récemment.

Création d’un workflow GitHub Actions personnalisé pour publier votre site

Pour plus d’informations sur GitHub Actions, consultez Documentation GitHub Actions.

Lorsque vous configurez votre site pour publier avec GitHub Actions, GitHub Enterprise Server vous propose des modèles de workflow pour les scénarios de publication les plus courants. Le flux général d’un workflow est le suivant :

1. Déclenchez chaque fois qu’il y a un envoi vers la branche par défaut du référentiel ou chaque fois que le workflow est exécuté manuellement à partir de l’onglet Actions.
2. Utiliser l’action actions/checkout pour extraire le contenu du dépôt.
3. Si votre site le demande, générer les fichiers de sites statiques.
4. Utiliser l’action actions/upload-pages-artifact pour charger les fichiers statiques en tant qu’artefact.
5. Si le workflow a été déclenché par une poussée vers la branche par défaut, utilisez l’action actions/deploy-pages pour déployer l’artefact. Cette étape est ignorée si le workflow a été déclenché par une demande de tirage.

Les modèles de workflow utilisent un environnement de déploiement appelé github-pages. Si votre dépôt n’inclut pas déjà un environnement appelé github-pages, l’environnement est créé automatiquement. Nous vous recommandons d'ajouter une règle de protection du déploiement afin que seule la branche par défaut puisse être déployée dans cet environnement. Pour plus d’informations, consultez « Gestion des environnements pour le déploiement ».

Résolution des problèmes de publication avec un workflow GitHub Actions personnalisé

Pour obtenir des informations sur la résolution des problèmes liés à votre flux de travail GitHub Actions, consultez Monitoring et résolution des problèmes de workflows.