Saltearse al contenido

Módulo 6: Despliegue en Cloudflare Pages

☁️ ¿Por Qué Cloudflare Pages?

Este portal ha sido desarrollado con Astro y Starlight, lo que significa que se compila a puro HTML, CSS y JavaScript estático.

No requiere servidores costosos, bases de datos SQL en la nube ni mantenimiento complejo. Cloudflare Pages ofrece:

  • Alojamiento 100% gratuito e ilimitado en ancho de banda.
  • Red CDN global: Carga instantánea desde cualquier dispositivo o ubicación.
  • Certificado SSL / HTTPS automático: Conexión segura garantizada.
  • Dominio personalizado gratuito: Tu sitio tendrá una dirección como https://analytics-powerbi-uees.pages.dev.

🚀 Método 1: Despliegue Directo (Arrastrar y Soltar en 2 Minutos)

Si no deseas utilizar Git ni repositorios remotos, este es el método más rápido:

  1. Compilar el Proyecto en tu Equipo

    Abre PowerShell en la carpeta portal-powerbi y ejecuta:

    Ventana de terminal
    npm run build

    Esto generará automáticamente la carpeta optimizada llamada dist/ con todo el sitio web y los archivos descargables listos.

  2. Crear el Proyecto en Cloudflare

    • Entra a dash.cloudflare.com e inicia sesión (o crea una cuenta gratuita).
    • En el menú lateral izquierdo, haz clic en Compute (Workers & Pages) > Pages.
    • Haz clic en el botón azul Upload assets (Subir activos).
    • Escribe el nombre de tu proyecto (por ejemplo: business-analytics-uees).
  3. Subir la Carpeta dist

    • Arrastra directamente la carpeta dist generada en tu proyecto hacia la ventana del navegador.
    • Haz clic en Deploy site.
    • En menos de 30 segundos, Cloudflare te entregará la URL pública para compartir con tus alumnos.

🔄 Método 2: Despliegue Continuo con GitHub (Recomendado para Actualizaciones)

Si vinculas el proyecto a un repositorio de GitHub, cada vez que edites un archivo .mdx, la web se actualizará automáticamente en la nube.

  1. Subir el Código a GitHub

    Crea un repositorio en GitHub y sube la carpeta portal-powerbi.

  2. Conectar en Cloudflare Pages

    • En la consola de Cloudflare Pages, selecciona Connect to Git.
    • Selecciona tu repositorio.
  3. Configurar los Parámetros de Compilación

    • Framework preset: Astro
    • Build command: npm run build
    • Build output directory: dist
    • Haz clic en Save and Deploy.

🛠️ Cómo Actualizar el Contenido en el Futuro

Cada vez que desees añadir un nuevo laboratorio, actualizar un enlace o cambiar una fecha:

  1. Abre el archivo correspondiente en la carpeta src/content/docs/.
  2. Realiza tus modificaciones en formato Markdown.
  3. Ejecuta npm run build y vuelve a subir la carpeta dist/ a Cloudflare.