Vercel

Paso 1: Configurar un Proyecto MkDocs

Paso 2: Configurar GitLab CI

    Crear un archivo .gitlab-ci.yml: Crea un archivo llamado .gitlab-ci.yml en la raíz de tu repositorio GitLab con la siguiente configuración:

    image: python:3.8-buster

    stages:
      - docs
      - deploy

    pages:
      stage: docs
      script:
        - pip install mkdocs
        - pip install mkdocs-material
        - mkdocs build
        - cp -r site public
      artifacts:
        paths:
          - public

    deploy_production:
      image: node:16.16.0
      stage: deploy
      only:
        - main
      script:
        - npm install --global vercel
        - vercel --token $VERCEL_TOKEN --prod

Expliacion

    image: python:3.8-buster: Indica la imagen Docker que se utilizará para ejecutar los comandos de CI. En este caso, se utiliza una imagen de Python 3.8 con el sistema operativo Buster (Debian 10).

    stages: Define las etapas del pipeline de CI. En este caso, hay dos etapas: docs (para construir la documentación) y deploy (para desplegar la aplicación).

    pages: Define una tarea para la etapa docs. Esta tarea instala MkDocs y MkDocs Material, construye la documentación del proyecto MkDocs y copia los archivos generados al directorio public.

    artifacts: Especifica los artefactos generados por la tarea pages que se conservarán después de que finalice la ejecución. En este caso, el directorio public que contiene la documentación construida.

    deploy_production: Define una tarea para la etapa deploy. Esta tarea utiliza una imagen de Node.js 16.16.0 para desplegar la aplicación en Vercel. Solo se ejecutará en la rama main.

    only: - main: Especifica que la tarea deploy_production solo se ejecutará cuando se realicen cambios en la rama main.

    script: Define los comandos que se ejecutarán en la tarea deploy_production. Instala la CLI de Vercel globalmente, autentica con el token de Vercel y despliega la aplicación en el entorno de producción de Vercel.

Paso 3: Configurar Variables de Entorno en GitLab

    Configurar Variables de Entorno: Configura la variable de entorno $VERCEL_TOKEN en GitLab CI con el token de acceso de Vercel.