Guía de progresión de Void Platform: de despliegues directos a una plataforma de equipo

Planifica tu despliegue con esta guía de progresión de Void Platform: despliegues directos en Cloudflare, autoalojamiento del núcleo, servicios opcionales y escalado a nivel de equipo.

Qué significa realmente "progresión" en una Void Platform

La mayoría de los equipos no instalan una plataforma de despliegue compartida el primer día: crecen hasta tener una. Esta guía de progresión de Void Platform traza esa ruta de crecimiento, desde un único desarrollador que despliega directamente en Cloudflare hasta una plataforma mantenida con logs retenidos, historial de reversión y acceso para todo el equipo. Seguir una guía clara de progresión de Void Platform importa porque cada etapa cambia lo que asumes: tus credenciales, los límites de tu cuenta y cuánta superficie operativa gestionas.

Una plataforma Void es una capa de despliegue compartida. Un administrador la instala y la mantiene, y los desarrolladores conectan la Void CLI a su URL, inician sesión mediante un método de inicio de sesión habilitado y despliegan sus aplicaciones en una cuenta compartida de Cloudflare. La progresión aquí no consiste en desbloquear contenido, sino en el orden en que adoptas las capacidades, para que nunca ejecutes infraestructura que aún no necesitas.

EtapaQué ejecutasIdeal paraQué cambia para ti
Etapa 0Despliegue directo en CloudflareDesarrolladores individuales, aplicaciones personalesNada que mantener; solo logs en vivo
Etapa 1Plataforma autoalojada del núcleoEquipos pequeños que necesitan acceso compartidoSandboxes gestionados, pasarela de correo, historial retenido
Etapa 2Núcleo más servicios opcionalesEquipos que necesitan compilaciones de GitHub, dominios personalizados y un panelMás piezas en movimiento y más opciones de configuración
Etapa 3Plataforma de equipo sobre Workers for PlatformsOrganizaciones más grandesInfraestructura documentada y funciones que dependen de la configuración

Etapa 0: Empieza con un despliegue directo en Cloudflare

Si despliegas una aplicación para ti mismo, despliégala directamente en Cloudflare; no necesitas instalar una plataforma primero. Este es el punto de partida correcto, no un atajo. Ambos destinos de despliegue usan las mismas API de aplicación, lo que significa que la aplicación que creas en la Etapa 0 es la misma que trasladas a una plataforma más adelante. No se reescribe nada.

Lo que cedes en la Etapa 0 es principalmente memoria institucional. No hay acceso compartido para compañeros de equipo, los logs de ejecución son un tail en vivo de Cloudflare en lugar de logs retenidos de la plataforma, y la reversión funciona mediante versiones de Worker en vez de un historial de despliegues retenido. Para un proyecto individual es un buen intercambio. Para un equipo, se convierte en fricción rápidamente.

La siguiente tabla es la forma más clara de ver dónde está la línea: es la comparación con la que tiene que empezar cualquier guía honesta de progresión de Void Platform:

FunciónCloudflare directoPlataforma autoalojada del núcleo
Workers AI y solicitudes a proveedoresTu cuenta y pasarelaPasarela y proxy de la instalación
Logs de ejecuciónTail en vivo de CloudflareLogs retenidos de la plataforma
Reversión de aplicacionesVersiones de WorkerDespliegues retenidos de la plataforma
SandboxesRequiere Workers Paid y DockerRequiere Workers Paid en la cuenta de la plataforma
Panel de usuario y compilaciones gestionadas de GitHubNo requeridoNo incluido en una instalación estándar

Lee esa tabla con atención y aparece un patrón: la plataforma no reemplaza a Cloudflare, añade un plano de control compartido encima. Los Sandboxes siguen necesitando un plan de Workers de pago. El panel y las compilaciones gestionadas de GitHub todavía no forman parte de una instalación estándar. La progresión significa añadir ese plano de control de forma deliberada, no asumir que llega completamente formado.

Etapa 1: Instala la plataforma del núcleo

Esta es la parte intermedia de cualquier guía de progresión de Void Platform, y la etapa en la que ocurren la mayoría de los errores, normalmente porque alguien se saltó los requisitos previos. Antes de tocar un comando de instalación, revisa la guía oficial de instalación de la plataforma autoalojada de Void y confirma tanto los requisitos previos como las credenciales que necesitarás. Una instalación que se detiene a mitad de camino es más difícil de limpiar que una que nunca empezó.

La instalación del núcleo es intencionalmente ligera. Incluye Sandboxes gestionados y una pasarela de correo. El correo no está activado por defecto: se habilita cuando configuras un dominio y una zona de correo compartidos. Ese único detalle desconcierta a un número sorprendente de administradores que asumen que una instalación funcional implica correo funcional.

PasoQué hacesPor qué importa
1Revisar los requisitos previos documentadosEvita una plataforma a medio construir que tengas que deshacer
2Reunir las credenciales necesariasLa instalación necesita actuar sobre tu cuenta de Cloudflare
3Instalar la plataforma del núcleoTe da Sandboxes gestionados y la pasarela de correo
4Configurar un dominio y una zona de correo compartidosActiva la pasarela de correo
5Confirmar Workers Paid en la cuenta de la plataformaNecesario para que se ejecuten los Sandboxes
6Habilitar un método de inicio de sesión y compartir la URL de la plataformaLos desarrolladores necesitan una forma de entrar
7Incorporar a los desarrolladores a la Void CLIConvierte un servidor en un flujo de trabajo compartido

El paso 7 es el que la gente subestima. Una plataforma en la que nadie puede iniciar sesión es solo una URL cara. Los informes de la comunidad de equipos que ejecutan plataformas de despliegue compartidas señalan sistemáticamente la incorporación como el verdadero cuello de botella: los desarrolladores necesitan la URL de la plataforma, un método de inicio de sesión funcional y una explicación de dos minutos sobre cómo se conecta la CLI. Escríbelo una vez y dejarás de responder la misma pregunta cada semana.

Etapa 2: Añade solo los servicios opcionales que necesites

Una vez que el núcleo es estable, entras en la fase de expansión de la guía de progresión de Void Platform. Existen varias capacidades, pero se excluyen deliberadamente de una instalación estándar: el panel de usuario, las compilaciones y webhooks de GitHub, los Containers de compilación y los dominios personalizados de proyecto.

Componente¿En una instalación estándar?Qué saber antes de añadirlo
Sandboxes gestionadosSíRequiere Workers Paid en la cuenta de la plataforma
Pasarela de correoSí, una vez configuradaNecesita un dominio y una zona de correo compartidos
Panel de usuarioNoAñádelo cuando los desarrolladores necesiten una vista de autoservicio
Compilaciones y webhooks de GitHubNoLas plataformas compiladas desde código fuente deben seguir la configuración de ingreso aislado para webhooks cuando Access protege la API
Containers de compilaciónNoAñade infraestructura de compilación que debes mantener
Dominios personalizados de proyectoNoAñádelos cuando los proyectos necesiten sus propios nombres de host

Dos reglas hacen que esta etapa sea sencilla. Primero, añade un servicio opcional a la vez y verifícalo antes de continuar: cuando cambian tres cosas a la vez, no puedes saber cuál se rompió. Segundo, trata los servicios de GitHub con cuidado: si compilas la plataforma desde el código fuente y los añades mientras Cloudflare Access protege la API, la configuración de ingreso aislado para webhooks no es opcional. Omitirla produce webhooks que nunca llegan, silenciosamente.

Etapa 3: Escala hacia una plataforma de equipo

La etapa final de una guía de progresión de Void Platform es donde la plataforma deja de ser una comodidad y se convierte en infraestructura. Una plataforma de equipo requiere Workers for Platforms y la infraestructura documentada que lo acompaña. Las funciones dependen en gran medida de cómo esté configurada la instalación, por lo que dos organizaciones que ejecutan "la misma" plataforma pueden tener conjuntos de capacidades bastante diferentes.

Antes de comprometerte, revisa de nuevo tus decisiones anteriores. Los requisitos previos y las credenciales que iban bien para un equipo de cinco personas pueden no cubrir a un grupo más grande. Pregunta quién es responsable administrativo de la plataforma, quién tiene las credenciales de Cloudflare y qué pasa cuando la persona que la instaló se va de vacaciones. La documentación de Workers for Platforms de Cloudflare es la referencia correcta para entender el modelo subyacente antes de expandirte.

Errores comunes de progresión

Una guía de progresión de Void Platform solo es útil si te ayuda a evitar los fallos que otras personas ya encontraron. Estos son los que aparecen con más frecuencia, asignados a sus causas:

SíntomaCausa probableSolución
El correo nunca se envíaDominio y zona de correo compartidos no configuradosConfigura ambos y vuelve a probar la pasarela
Los webhooks nunca lleganAccess protege la API sin ingreso aisladoSigue la configuración de ingreso aislado para webhooks
Los Sandboxes no se ejecutanNo hay plan Workers Paid en la cuenta de la plataformaActualiza la cuenta de la plataforma
Los compañeros de equipo no pueden entrarNo hay método de inicio de sesión habilitadoHabilita uno y distribuye la URL de la plataforma
Sin historial de reversiónSigues con despliegues directos en CloudflarePasa a la plataforma o usa versiones de Worker
Faltan el panel o los dominios personalizadosFunciones esperadas que no están en la instalación del núcleoAñade los servicios opcionales explícitamente
Comprobación de preparaciónEtapa 0Etapa 1Etapa 2Etapa 3
Plataforma instalada y mantenida—✔✔✔
Método de inicio de sesión compartido activo—✔✔✔
Pasarela de correo configurada—Opcional✔✔
Servicios opcionales revisados——✔✔
Workers for Platforms implementado———✔

FAQ

¿Necesito una Void Platform para desplegar una aplicación? No. Si despliegas una aplicación para ti mismo, despliégala directamente en Cloudflare. Una plataforma merece la pena cuando necesitas acceso compartido, logs retenidos y un historial de despliegues por el que tu equipo pueda revertir.

¿Cuál es la diferencia entre una instalación del núcleo y una completa? La instalación del núcleo te da Sandboxes gestionados y una pasarela de correo. El panel, las compilaciones y webhooks de GitHub, los Containers de compilación y los dominios personalizados de proyecto quedan fuera y deben añadirse deliberadamente.

¿Esta guía de progresión de Void Platform se aplica a desarrolladores individuales? En parte. Las etapas 2 y 3 serán excesivas para una sola persona. La Etapa 0 es genuinamente la respuesta correcta para el trabajo individual, y las mismas API de aplicación significan que no pierdes nada por quedarte ahí hasta que aparezca un equipo.

¿Cómo sé cuándo pasar a una plataforma de equipo? Cuando el acceso compartido y el historial de despliegues dejen de ser algo deseable. En ese momento, planifica Workers for Platforms y la infraestructura documentada, y espera que las funciones varíen según cómo esté configurada tu instalación.