GitHub Pages

Déployez les applications Explainer sur GitHub Pages en utilisant l’action native actions/deploy-pages.

Configuration

Définir la cible de déploiement

Ajoutez une variable de dépôt dans GitHub Settings → Variables :

DEPLOY_TARGET=github-pages

Activer GitHub Pages

Dans les paramètres de votre dépôt, allez dans Pages → Source et sélectionnez GitHub Actions.

Configurer les permissions

Le workflow nécessite les permissions suivantes :

permissions:
  contents: read
  pages: write
  id-token: write

Workflow GitHub Actions

Lorsque DEPLOY_TARGET est défini sur github-pages, le workflow utilise les actions Pages natives :

- uses: actions/upload-pages-artifact@v3
  with:
    path: apps/docs/dist

- uses: actions/deploy-pages@v4
  id: deployment
  with:
    environment: github-pages

Considérations sur le chemin de base

Si votre dépôt n’est pas un site utilisateur/organisation (c’est-à-dire qu’il se trouve à username.github.io/repo-name), vous devez configurer le chemin base d’Astro :

astro.config.ts
export default defineConfig({
  base: '/repo-name',
  // ...
})

Cela garantit que tous les liens et ressources utilisent le bon préfixe de chemin.

Nommage de l’environnement

Les déploiements GitHub Pages utilisent un environnement nommé github-pages. C’est le nom d’environnement par défaut attendu par l’action actions/deploy-pages.