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

Vous pouvez configurer votre site GitHub Pages pour qu'il soit publié lorsque les modifications sont poussées vers une branche spécifique, ou vous pouvez écrire un flux de travail GitHub Actions pour publier votre site.

Qui peut utiliser cette fonctionnalité ?

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

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.

Dans cet article

À 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.

Avertissement : si votre administrateur de site a activé les pages publiques, les sites GitHub Pages sont disponibles publiquement sur Internet, même si leur dépôt est privé ou interne. Si vous avez des données sensibles dans le dépôt de votre site, vous pouvez les supprimer avant publication. Pour plus d’informations, consultez « Configuration de GitHub Pages pour votre entreprise » et « À propos des dépôts ».

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.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  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.

    Capture d’écran des paramètres Pages dans un dépôt GitHub. Un menu permettant de sélectionner une branche pour une source de publication, intitulé « Aucun », est indiqué en orange foncé.

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

    Capture d’écran des paramètres Pages dans un dépôt GitHub. Un menu permettant de sélectionner un dossier pour une source de publication, intitulé « /(root) », est présenté en orange foncé.

  8. Cliquez sur Enregistrer.

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

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 "Documentation GitHub Actions."

Remarques:

  • Si vous publiez à partir d’une branche et votre site n’a pas été publié automatiquement, assurez-vous qu’une personne avec des autorisations d’administrateur et une adresse e-mail vérifiée a effectué une poussée vers la source de publication.

  • Les commits envoyés par un workflow GitHub Actions qui utilise le GITHUB_TOKEN ne déclenchent pas de build GitHub Pages.

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.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  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 workflow personnalisé, consultez « Création d’un workflow 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 workflow GitHub Actions, consultez « Monitoring et résolution des problèmes de workflows ».