Clase 02 · Módulo 10
Desplegar desde GitHub y vistas previas
Desplegar desde GitHub y vistas previas
Qué logras en esta clase
Tu web queda publicada en una dirección provisional y se actualiza sola cada vez que subes cambios a GitHub.
- Preparas el proyecto y lo pruebas antes de conectar nada.
- Conectas el repositorio a Cloudflare paso a paso.
- Cargas las variables de entorno de producción.
- Usas vistas previas para probar sin tocar el sitio real.
02
Qué significa desplegar
Desplegar es que un git push termine en tu web publicada, sin subir ningún archivo a mano.
03
El circuito completo
La fila de arriba es producción: lo que ve el público. La de abajo es tu zona de pruebas. A esto se le llama despliegue continuo.
04
Antes de conectar: lo que debe estar listo
- El proyecto está en GitHub y la rama principal no tiene cambios a medias.
- El sitio se construye sin errores en tu computador.
- El archivo
.envestá en.gitignorey nunca se subió. - Tienes una lista con los nombres de tus variables de entorno.
05
Prueba la construcción en tu computador
npx astro buildEste comando genera la carpeta dist con el sitio final. Es lo mismo que hará el alojamiento.
Si termina con errores, copia el mensaje completo y dáselo a Claude Code, como viste en el módulo 5. No sigas hasta que termine limpio.
06
Tu sitio es estático o tiene funciones
| Tu sitio | Qué necesita para Cloudflare |
|---|---|
| Solo páginas estáticas | Wrangler y un archivo de configuración |
| Con formulario, correos o pagos | Lo anterior más el adaptador de Astro para Cloudflare |
Wrangler es la herramienta de línea de comandos de Cloudflare. El adaptador es la pieza que le enseña a Astro a generar funciones compatibles con ese alojamiento.
07
Paso 1: instalar Wrangler y el adaptador
npm install wrangler@latest --save-dev
npx astro add cloudflare- La primera línea instala Wrangler dentro del proyecto.
- La segunda solo se ejecuta si tu sitio tiene funciones: instala el adaptador y actualiza
astro.config.mjs.
Puedes pedírselo a Claude Code en modo plan y revisar con /diff qué archivos cambió.
08
El archivo wrangler.jsonc
Le dice a Cloudflare cómo se llama tu proyecto y dónde está el sitio construido. Versión para un sitio estático:
{
"name": "cafeteria-web",
"compatibility_date": "2026-11-18",
"assets": { "directory": "./dist" }
}En compatibility_date va la fecha del día en que publicas. Si usaste astro add cloudflare, el comando crea este archivo por ti, con más líneas para las funciones.
09
Paso 2: probar como lo hará Cloudflare
npx astro build && npx wrangler devWrangler levanta tu sitio en local imitando el entorno de Cloudflare. Abre la dirección que imprime y prueba el formulario.
10
Paso 3: conectar el repositorio
- En el panel de Cloudflare, entra a Compute > Workers & Pages.
- Elige Create application.
- En Import a repository, selecciona tu cuenta de GitHub y el repositorio.
- Comando de construcción:
npx astro build. - Comando de despliegue:
npx wrangler deploy. - Pulsa Save and Deploy.
11
Tu primera dirección pública
Al terminar, tu sitio queda disponible en un subdominio workers.dev que Cloudflare te asigna. Todavía no es tu dominio: eso se conecta en la clase de DNS.
Ábrelo en el computador y en el celular. Si algo falla, el panel guarda el registro de la construcción con cada paso y su resultado.
12
Lee el registro antes de pedir ayuda
El registro de la construcción dice qué paso falló y por qué. Cópialo completo y dáselo a Claude: una captura a medias no alcanza.
13
Variables de entorno en producción
Tu .env no viaja a GitHub, así que el alojamiento no conoce tus claves. Hay que cargarlas en el panel del proyecto.
- Carga cada variable con el mismo nombre que usas en local.
- Marca como secreto todo lo que no puede verse: clave secreta de Supabase, clave de Resend, token de Mercado Pago.
- Vuelve a desplegar después de cargarlas.
Comprueba en la documentación de tu alojamiento dónde está esa sección.
14
Dónde vive cada valor
| Entorno | Dónde se guarda | Qué claves usa |
|---|---|---|
| Tu computador | Archivo .env | De prueba |
| Vista previa | Panel del alojamiento | De prueba |
| Producción | Panel del alojamiento | Reales |
15
Vistas previas: probar sin tocar producción
Una vista previa es una copia completa del sitio, construida desde una rama, con su propia dirección. Producción no cambia hasta que fusionas.
Tanto Cloudflare como Vercel pueden generar una por rama o por pull request. Comprueba en los ajustes de tu proyecto que la opción esté activa y qué ramas incluye.
16
Cómo se trabaja con ramas desde ahora
Es el mismo flujo de ramas del módulo 2, con una diferencia: ahora cada rama se puede abrir en un navegador antes de aceptarla.
17
Qué revisar en una vista previa
- El cambio que pediste se ve como esperabas.
- Lo que no pediste cambiar sigue igual.
- El formulario envía y el mensaje llega.
- Se ve bien en tu celular real, no solo en el modo de dispositivo.
- La consola del navegador no muestra errores nuevos.
18
Una vista previa con claves reales no es una prueba
Si tu vista previa escribe en la base de producción o cobra de verdad, cada prueba deja rastro real. Sepárala con claves de prueba.
19
Funciona en local y falla al publicar
| Síntoma | Causa probable | Qué hacer |
|---|---|---|
| Falla al instalar | Versión de Node distinta | Fijar la versión del proyecto |
| Construye pero el formulario da error | Falta una variable | Cargarla y redesplegar |
| Página en blanco | Carpeta de salida equivocada | Revisar assets.directory |
| 404 genérica | Sin página 404 propia | Ver la lámina siguiente |
20
Dos ajustes que evitan problemas
Astro 7 exige una versión reciente de Node 22. Pídele a Claude que fije la versión de Node del proyecto y comprueba en la documentación del alojamiento qué archivo o ajuste respeta.
Para que Cloudflare muestre tu página 404 propia, agrega esta línea dentro de assets:
"not_found_handling": "404-page"21
Volver atrás si publicaste algo malo
- No arregles con apuro directo en la rama principal.
- Pídele a Claude Code que revierta el commit problemático con Git.
- Sube ese cambio: el servicio publica otra vez la versión buena.
- Corrige con calma en una rama y revisa su vista previa.
22
Si elegiste Vercel
La secuencia es la misma: importas el repositorio desde el panel, Vercel reconoce que es un proyecto Astro, cargas las variables y despliegas.
Cambia una pieza: si tu sitio tiene funciones, el adaptador es el de Vercel, no el de Cloudflare. Sigue la guía oficial de Astro para Vercel citada en las fuentes.
23
Lo que te llevas
- Desplegar es conectar el repositorio una vez; después publica cada
git push. - Se prueba la construcción en local antes de conectar.
- Las claves de producción viven en el panel, nunca en el repositorio.
- Cada rama tiene su vista previa: ahí se revisa, no en producción.
- Un fallo se deshace revirtiendo el commit, no parchando a ciegas.
24
Hazlo ahora
En 15 minutos:
- Ejecuta
npx astro buildy confirma que termina sin errores. - Conecta tu repositorio siguiendo el paso 3.
- Abre la dirección provisional en tu celular.
- Crea una rama, cambia un texto visible y súbela.
- Abre la vista previa, confirma el cambio y fusiona.
- Comprueba que producción se actualizó sola.
Clase terminada
Sigue con la próxima.
Fuentes · revisadas el 18 de noviembre de 2026