📜 Descripción Pages

GitLab Pages te permite alojar sitios web estáticos directamente desde un repositorio de GitLab. A continuación, te explico los pasos para configurar Pages en tu proyecto usando un archivo .gitlab-ci.yml.

⚙️ Pasos para configurar Pages

  1. Crear el archivo .gitlab-ci.yml: Este archivo define las instrucciones para construir y desplegar el sitio web. Debe estar ubicado en la raíz del repositorio.
  2. Configurar la imagen del contenedor: Se recomienda usar una imagen ligera de Docker, como alpine:latest, para mayor eficiencia.
    3. pages:
    stage: deploy
    script:
        - echo "Construyendo el sitio..."
    artifacts:
        paths:
            - public
  3. Definir el job de despliegue: Aquí se configuran los comandos para construir el sitio web. En este ejemplo, el comando echo "Construyendo el sitio..." es solo ilustrativo; en un proyecto real, se deben incluir los comandos que generen los archivos del sitio.
  4. Configurar los artefactos: Los archivos generados deben almacenarse en la carpeta public para que GitLab los despliegue correctamente.
  5. Establecer la condición de despliegue: Se debe indicar en qué ramas se ejecutará el pipeline. Generalmente, se usa la rama main.
    6. only:
    - main

🛠️ Verificación Pipeline

    Después de hacer el push, GitLab automáticamente detectará el archivo .gitlab-ci.yml y comenzará a ejecutar un pipeline. Para verificar que todo esté funcionando bien:

  • Ve a tu repositorio en GitLab.
  • Clic en la pestaña CI / CD y luego en Pipelines.
  • Deberías ver que el pipeline ha comenzado. Si todo está bien configurado, verás que el estado del pipeline es success (éxito) al final del proceso.

🗂️ Verificación carpeta Public

  • Durante el proceso de construcción, GitLab buscará los archivos que se generen en el directorio public (que definimos en el archivo .gitlab-ci.yml como el directorio de artefactos). Si tienes un sitio web estático o archivos HTML dentro de esa carpeta, GitLab los usará para crear tu página.

  • Asegúrate de que los archivos generados (como index.html, imágenes, CSS, etc.) estén dentro de la carpeta public. Si estás usando una herramienta de construcción como Jekyll o Hugo, estos archivos se generarán automáticamente en esa carpeta.

🌐 Acceso página Web