Aller au contenu

Déployez votre site Astro sur GitLab Pages

Vous pouvez utiliser GitLab Pages pour héberger un site Astro pour vos projets GitLab, vos groupes ou votre compte utilisateur.

Comment déployer

  1. Définissez le bon site dans astro.config.mjs.
  2. Renommez le répertoire public/ en static.
  3. Mettez outDir:public dans astro.config.mjs. Ce paramètre indique à Astro de placer la sortie statique de la compilation dans un dossier appelé public, qui est le dossier requis par GitLab Pages pour les fichiers exposés.

Si vous utilisiez le répertoire public/ comme source de fichiers statiques dans votre projet Astro, renommez-le et utilisez ce nouveau nom de dossier dans astro.config.mjs pour la valeur de publicDir.

Par exemple, voici les paramètres corrects de astro.config.mjs lorsque le répertoire public/ est renommé en static/ :

import { defineConfig } from 'astro/config';
export default defineConfig({
site: 'https://<user>.gitlab.io',
base: '/<project-name>',
outDir: 'public',
publicDir: 'static',
});
  1. Créez un fichier appelé .gitlab-ci.yml à la racine de votre projet avec le contenu ci-dessous. Cela permettra de construire et de déployer votre site à chaque fois que vous apporterez des modifications à votre contenu :

    pages:
    # L'image Docker qui sera utilisée pour construire votre application
    image: node:lts
    before_script:
    - npm ci
    script:
    # Précisez ici les étapes de la construction de votre application
    - npm run build
    artifacts:
    paths:
    # Le dossier qui contient les fichiers construits à publier.
    # Il doit être appelé "public".
    - public
    only:
    # Déclencher un nouveau build et déployer uniquement lorsqu'il y a un push sur
    # la(les) branche(s) ci-dessous
    - main

Guides de déploiement

Plus de guides de déploiement

Filtrer par type de déploiement