Despliegue

IZ-KnowledgeBase se despliega como sitio estático. El proceso consiste en compilar el proyecto con Astro y publicar la carpeta dist/ en Cloudflare Pages u otro hosting estático.

Prerrequisitos

Node.js instalado.
npm disponible.
Proyecto actualizado localmente.
Acceso al dashboard de Cloudflare Pages o credenciales de Wrangler.
Dominio definido si se publicará con URL propia.

Build local

Desde la raíz del proyecto:

npm install
npm run build

La salida se genera en:

dist/

Validar localmente:

npm run preview

Publicación con Cloudflare Pages Direct Upload

Flujo recomendado si no se usará GitHub:

Ejecutar npm run build.
Validar el sitio con npm run preview.
Entrar a Cloudflare Pages.
Crear o seleccionar el proyecto.
Usar Direct Upload.
Subir el contenido de dist/.
Validar la URL publicada.

Publicación con Wrangler

Alternativa por línea de comandos:

npx wrangler pages deploy dist --project-name interzone-knowledge-base

Validaciones post-despliegue

Validación	Resultado esperado
Página principal responde	HTTP 200
Sidebar carga	Secciones visibles
“En esta página” aparece	TOC visible en páginas con `##`/`###`
Logo carga	Imagen Interzone visible
CSS aplica correctamente	Layout sin romper sidebar ni TOC
Links internos funcionan	Sin enlaces rotos críticos
Búsqueda funciona	Si está habilitada por Starlight

Rollback

Escenario	Acción
Error visual menor	Corregir Markdown/CSS y publicar nuevo build.
Error crítico en contenido	Revertir archivo fuente y republicar.
Deployment fallido	Restaurar deployment anterior desde Cloudflare Pages si está disponible.
Build local falla	No publicar; corregir error antes de subir `dist/`.

Evidencia requerida

Fecha y hora de publicación.
Responsable del despliegue.
URL publicada.
Captura o validación de home.
Validación de una página de proyecto.
Validación de una guía técnica.
Observaciones o errores encontrados.