Antes de comenzar
Establezca primero el límite de operación.
- Una aplicación funcional con pruebas locales repetibles y un gestor de paquetes bloqueado.
- Una cuenta de Cloudflare, autenticación de Wrangler y un propietario de producción designado.
- Una lista de enlaces necesarios, secretos, regiones de datos y rutas de solicitud esperadas.
- Un camino de prueba de humo de bajo riesgo y una regla de decisión para revertir.
Paso a paso
Moverse del alcance a un artefacto verificado.
Elige el camino de implementación deliberadamente
Para una nueva aplicación de Next.js, comience verificando la compatibilidad con vinext, ya que Cloudflare lo presenta como su camino recomendado. Para una implementación existente de OpenNext, mantenga el adaptador cuando haya una brecha de compatibilidad no resuelta. Use Pages solo para una exportación verdaderamente estática.
- Punto de control
- El repositorio registra por qué vinext, OpenNext o páginas estáticas se ajustan a esta aplicación hoy.
- Artificio
- Registro de decisión de ruta de implementación
Definir límites de tiempo de ejecución y datos
Lista qué rutas necesitan renderizado en el servidor o APIs y cuáles pueden permanecer estáticas. Agrega D1, R2, KV, Workers AI, Colas u otras conexiones solo cuando un feature validado las requiera. Documenta qué datos cruzan cada frontera y qué sistema es responsable de la eliminación y recuperación.
- Punto de control
- Cada vinculación tiene una característica nombrada, un propietario de datos y un comportamiento de falla.
- Artificio
- Mapa de tiempo de ejecución y enlaces
Hacer que la construcción sea reproducible
Fija el adaptador y las herramientas de implementación, genera tipos vinculantes y ejecuta comprobaciones de tipos, pruebas, validación de contenido y el comando exacto para la construcción de producción. Mantén los secretos fuera del control de código fuente y distingue la configuración de vista previa de la configuración de producción.
- Punto de control
- Un checkout limpio puede producir el mismo artefacto de despliegue sin estado local no documentado.
- Artificio
- Inventario de construcción y configuración verificados
Vista previa del artefacto de producción
Ejecuta el Worker construido localmente o en un entorno de vista previa, luego verifica códigos de estado, redirecciones, metadatos, activos estáticos, límites autenticados y cualquier migración de base de datos. Trata los enlaces de IA remotos como potencialmente facturables incluso durante el desarrollo local.
- Punto de control
- El artefacto de producción exacto pasa por una ruta escrita y una matriz de enlace.
- Artificio
- Registro de prueba de humo de vista previa
Lanzar una versión trazable
Genera un marcador de versión pública desde el commit, ejecuta una prueba de despliegue y despliega la construcción inmutable. Registra el commit, la versión del Worker, el momento del despliegue y el operador. Evita cambiar los esquemas de datos y el comportamiento de la aplicación en un solo paso no revisado.
- Punto de control
- El marcador de versión pública resuelve al commit deseado y el proveedor de implementación informa una versión exitosa.
- Artificio
- Registro de lanzamiento de producción
Verifique y mantenga disponible el retroceso
Repetir la matriz de rutas contra el dominio público, incluyendo 200 críticos, redirecciones, 404, metadatos y verificaciones de API. Vigilar errores y regresiones visibles para el usuario. Revertir cuando el lanzamiento rompa un camino crítico o viole el límite de aceptación escrito previamente.
- Punto de control
- La producción coincide con el registro de lanzamiento, o se restaura la versión anterior conocida como buena.
- Artificio
- Decisión de verificación pública y retroceso
Entregables
Mantén el trabajo reutilizable e inspectable.
- Registro de decisión de ruta de implementación
- Mapa de tiempo de ejecución, datos y enlaces
- Comando de construcción de producción repetible
- Vista previa de la ruta y la matriz de enlaces
- Registro de liberación a Worker
- Registro de prueba pública y retroceso
Límites de decisión
¿Qué no demuestra este tutorial.
- Etiquetas de Cloudflare vinext beta; verifique su informe de compatibilidad antes de migrar una aplicación de producción existente.
- OpenNext sigue siendo un camino de mantenimiento documentado, pero no debe presentarse como el estándar de Cloudflare para una nueva aplicación.
- D1, R2, Workers AI y otros servicios tienen límites, precios y comportamientos de datos separados que deben verificarse para el plan elegido.
- Una implementación exitosa no demuestra la corrección de la aplicación, seguridad, recuperación de datos o calidad de las salidas del modelo.
Registro de fuentes
Verificar la guía primaria actual.
- Cloudflare Workers: Guía de Next.js
Fuente principal para el camino recomendado actual de vinext, verificación de compatibilidad y enlaces de Workers.
- Cloudflare Workers: Adaptador OpenNext
Fuente principal para mantener una aplicación existente de OpenNext y sus características compatibles de Next.js.
- Documentación de Cloudflare D1
Fuente principal para D1 vinculante, datos y detalles operativos.
- Documentación de Cloudflare R2
Fuente principal para el comportamiento del almacenamiento de objetos, límites y enlaces de precios.