Saltearse al contenido

Despliega tu proyecto de Astro en GitLab Pages

Puedes usar GitLab Pages para alojar un proyecto de Astro para tu proyecto, grupo, o cuenta de usuario en GitLab.

  1. Establece el site correcto en astro.config.mjs.

  2. Renombra el directorio public/ a static.

  3. Establece outDir:public en astro.config.mjs. Este ajuste le indica a Astro que coloque la salida de archivos estáticos al compilar en una carpeta llamada public, la cual es requerida por GitLab Pages para los archivos expuestos.

    Si estás usando el directorio public/ como fuente de archivos estáticos en tu proyecto de Astro, renombralo y usa ese nuevo nombre del directorio en astro.config.mjs para el valor de publicDir.

    Por ejemplo, estos son los ajustes correctos de astro.config.mjs cuando el directorio public/ es renombrado a static/:

    import { defineConfig } from 'astro/config';
    export default defineConfig({
    site: 'https://<user>.gitlab.io',
    base: '/<project-name>',
    outDir: 'public',
    publicDir: 'static',
    });
  4. Crea un archivo llamado .gitlab-ci.yml en la raíz de tu proyecto con el siguiente contenido. Esto compilará y desplegará tu proyecto cada vez que realices cambios en el contenido:

    pages:
    # La imagen de Docker que se usará para construir tu app
    image: node:lts
    before_script:
    - npm ci
    script:
    # Especifica los pasos involucrados para construir tu app aquí
    - npm run build
    artifacts:
    paths:
    # El directorio que contiene los archivos construidos para ser publicados.
    # Debe llamarse "public".
    - public
    only:
    # Activa una nueva compilación y despliega solo cuando haya un push a la
    # rama(s) a continuación
    - main

Más guías de implementación