Componentes y roles
Cada componente se merece su lugar.
- 01Aplicación Next.js
Proporciona la interfaz pública, contenido estático, manejadores de rutas y rutas renderizadas en el servidor cuando sea necesario.
- 02Camino de implementación de Cloudflare Workers
Ejecuta la aplicación en el borde a través del adaptador de Next.js compatible actual.
- 03Límite de modelo en el lado del servidor
Mantiene las credenciales del proveedor privadas y aplica validación, tiempos de espera, presupuestos y comportamiento seguro ante fallos.
- 04Vínculos D1 y R2 opcionales
Agregue registros estructurados o artefactos generados solo después de que el flujo de producto demuestre la necesidad.
- 05Lanzamiento y bucle de observación
Conecta cada implementación a un commit, verificaciones de ruta, visibilidad de errores, señales de costo y una regla de reversión.
Navegador → ruta de aplicación validada → proveedor de modelos cuando sea necesario → registro D1/R2 opcional → resultado visible para el usuario → revisión de liberación y errores
Opciones predeterminadas
Comience aquí, luego cambie por un motivo declarado.
Next.js en Workers
vinext para una nueva aplicación compatible; OpenNext para una aplicación existente con un hueco de migración
- Razón de la selección
- Cumple con la guía actual de Cloudflare evitando una migración a producción no verificada.
- Cambiar cuando
- Reevaluar el adaptador cuando cambie materialmente la compatibilidad, el estado de mantenimiento o los requisitos de la aplicación.
Persistencia estructurada
No hay base de datos hasta que el flujo necesite registros duraderos; D1 como punto de partida nativo de Cloudflare
- Razón de la selección
- Evita operar con estado no utilizado mientras mantiene un camino de enlace directo cuando la persistencia se vuelve real.
- Cambiar cuando
- Use un sistema Postgres existente u otro almacén cuando las funciones relacionales, portabilidad, regiones o operaciones de equipo lo hagan la mejor opción.
Almacenamiento de artefactos
No hay almacén de objetos hasta que existan archivos o exportaciones inmutables; R2 cuando existan
- Razón de la selección
- Mantiene la primera versión pequeña y separa objetos grandes de registros estructurados.
- Cambiar cuando
- Use un almacén de objetos existente cuando la residencia de datos, herramientas o estándares organizativos superen la consolidación.
Suposiciones operativas
Costo, privacidad, alternativas y límites.
Puntos de control humanos
Mantén las decisiones responsables visibles.
- Aprobar el alcance de un solo flujo y el límite de datos
- Revisar la configuración de producción y el artefacto exacto de la versión
- Verifique la versión pública y su retroceso
Evidencia y fuentes