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:
-
Compilar el Proyecto en tu Equipo
Abre PowerShell en la carpeta
portal-powerbiy ejecuta:Ventana de terminal npm run buildEsto generará automáticamente la carpeta optimizada llamada
dist/con todo el sitio web y los archivos descargables listos. -
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).
-
Subir la Carpeta
dist- Arrastra directamente la carpeta
distgenerada 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.
- Arrastra directamente la carpeta
🔄 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.
-
Subir el Código a GitHub
Crea un repositorio en GitHub y sube la carpeta
portal-powerbi. -
Conectar en Cloudflare Pages
- En la consola de Cloudflare Pages, selecciona Connect to Git.
- Selecciona tu repositorio.
-
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.
- Framework preset:
🛠️ Cómo Actualizar el Contenido en el Futuro
Cada vez que desees añadir un nuevo laboratorio, actualizar un enlace o cambiar una fecha:
- Abre el archivo correspondiente en la carpeta
src/content/docs/. - Realiza tus modificaciones en formato Markdown.
- Ejecuta
npm run buildy vuelve a subir la carpetadist/a Cloudflare.