Tutorial de Void Platform: Instalar, configurar y desplegar apps para tu equipo
Un tutorial práctico de Void Platform: instala el núcleo en una cuenta de Cloudflare compartida, configura las credenciales, habilita el correo electrónico e incorpora a tus desarrolladores.
Por qué un destino de despliegue compartido cambia el flujo de trabajo del equipo
Montar un destino de despliegue compartido para un equipo parece sencillo hasta que el primer desarrollador pregunta dónde quedó su historial de reversiones. Un tutorial de Void Platform cubre ese vacío: te guía paso a paso para instalar una plataforma autoalojada sobre una cuenta de Cloudflare compartida, de modo que cada desarrollador despliegue en el mismo entorno gestionado. Este tutorial de Void Platform abarca los requisitos previos, las credenciales, la instalación del núcleo y los servicios opcionales que la mayoría de los equipos acaban queriendo.
Una aclaración antes que nada: no necesitas una plataforma para publicar tus propias apps. Si despliegas para ti mismo, apunta tus herramientas directamente a Cloudflare. Una plataforma solo se justifica cuando varias personas necesitan acceso compartido, un historial de despliegues conservado y un único lugar consistente al que mirar cuando algo falla.
Esa distinción importa porque condiciona cada decisión posterior: desde cuánta infraestructura aprovisionas hasta si te molestas en habilitar servicios opcionales.
Qué hace realmente una Void Platform
Una plataforma Void es una instalación, no un registro en un SaaS. Como administrador, la instalas en una cuenta de Cloudflare que tu equipo comparte y luego la mantienes con el tiempo. Los desarrolladores conectan el CLI de Void a la URL de la plataforma, inician sesión mediante uno de los métodos de acceso que hayas habilitado y despliegan, sin tener que lidiar con cuentas de Cloudflare por su parte.
La capa de plataforma añade dos cosas que los despliegues directos no ofrecen: acceso compartido para todo el equipo y un historial de despliegues conservado que sobrevive al tail de logs en vivo. Todo lo demás es configuración.
| Situación | Destino recomendado | Por qué |
|---|---|---|
| Publicas un proyecto personal secundario | Directo a Cloudflare | Sin sobrecarga de administración, nada compartido que mantener |
| Dos o más desarrolladores despliegan con regularidad | Plataforma autoalojada del núcleo | Acceso compartido más registros de despliegue conservados |
| Necesitas logs después de los hechos | Plataforma autoalojada del núcleo | La plataforma conserva los logs de ejecución en lugar de solo un tail en vivo |
| Quieres revertir a una compilación verificada | Plataforma autoalojada del núcleo | La plataforma guarda despliegues a los que puedes volver |
| Necesitas compilaciones impulsadas por GitHub | Cloudflare directo, o una plataforma compilada desde el código fuente con servicios opcionales | Las compilaciones gestionadas de GitHub no forman parte de una instalación estándar |
Requisitos previos y credenciales: prepáralos primero
La guía de instalación oficial separa los requisitos previos de las credenciales por una buena razón: la mayoría de las instalaciones fallidas carecen de uno de los dos. Repasa esta lista antes de tocar nada y el resto de este tutorial de Void Platform irá mucho más rápido.
| Requisito | Por qué importa | Aplica a |
|---|---|---|
| Una cuenta de Cloudflare que tu equipo comparte | La plataforma despliega apps en ella | Plataforma |
| Workers Paid en la cuenta de la plataforma | Necesario para Sandboxes gestionados | Plataforma |
| Workers for Platforms más la infraestructura documentada | Necesario para ejecutar una plataforma de equipo completa | Plataforma de equipo |
| Credenciales de API para el instalador | La instalación necesita actuar sobre tu cuenta | Plataforma |
| Un dominio y una zona de correo compartidos | Activa la pasarela de correo electrónico | Opcional, pero habitual |
| El CLI de Void en cada máquina de desarrollador | Cómo se conectan y despliegan los desarrolladores | Desarrollador |
Dos de esas filas son fáciles de subestimar. Primero, Workers Paid es un requisito estricto para los Sandboxes: planifícalo en la cuenta de la plataforma específicamente, no en la cuenta personal de un desarrollador. Segundo, el dominio y la zona de correo son lo que realmente activa la pasarela de correo; sin ellos, la pasarela queda inerte.
Si tu organización coloca Cloudflare Access delante de la API, ten en cuenta que las plataformas compiladas desde el código fuente que añaden los servicios opcionales de GitHub necesitan una configuración de entrada de webhooks aislada. Los webhooks y los inicios de sesión interactivos no funcionan bien en la misma ruta protegida.
Tutorial paso a paso de Void Platform: instalar el núcleo
La instalación en sí es una secuencia, no un único comando. Sigue la guía oficial de instalación de la plataforma autoalojada de Void para conocer los comandos exactos y los formatos de credenciales, y usa la tabla siguiente como lista de verificación para no saltarte nada.
| Paso | Acción | Con qué acabas |
|---|---|---|
| 1 | Confirma la cuenta de Cloudflare compartida y el estado de Workers Paid | Una cuenta de plataforma válida |
| 2 | Reúne las credenciales para el instalador | Todo lo que la instalación necesita para autenticarse |
| 3 | Ejecuta la instalación del núcleo en esa cuenta | Una URL de plataforma a la que tu equipo puede llegar |
| 4 | Configura el dominio y la zona de correo compartidos | Una pasarela de correo electrónico activa |
| 5 | Verifica que los Sandboxes gestionados se levanten | Ejecución aislada funcional para las apps |
| 6 | Habilita los métodos de acceso que quieres que usen los desarrolladores | Una vía de inicio de sesión para el equipo |
| 7 | Comparte la URL de la plataforma con los desarrolladores | Un destino de despliegue al que todos pueden llegar |
Incorporar a los desarrolladores tras la instalación
Tu trabajo no termina con "está instalado". Cada desarrollador necesita el CLI de Void instalado localmente, la URL de la plataforma y un método de acceso funcional. El traspaso de tres líneas que evita el noventa por ciento de las consultas de soporte:
- La URL: a dónde debe apuntar el CLI.
- El método de acceso: qué proveedor de identidad o credencial deben usar.
- La expectativa: las apps se despliegan en la cuenta compartida, así que el uso de recursos es visible para todos.
Envía eso como mensaje fijado en lugar de por mensaje privado. Las nuevas incorporaciones te lo agradecerán más adelante, y no tendrás que responder la misma pregunta cada trimestre.
Instalación del núcleo frente a servicios opcionales
Un tutorial de Void Platform que prometa un panel y compilaciones de GitHub desde el primer día está vendiendo de más la instalación estándar. El núcleo es deliberadamente ligero. Esto es lo que realmente incluye.
| Componente | ¿En la instalación del núcleo? | Notas |
|---|---|---|
| Sandboxes gestionados | Sí | Requiere Workers Paid en la cuenta de la plataforma |
| Pasarela de correo electrónico | Sí, una vez configurada | Necesita un dominio y una zona de correo compartidos para activarse |
| Panel de usuario | No | Añádelo por separado si quieres una interfaz |
| Compilaciones y webhooks de GitHub | No | Servicio opcional, normalmente en plataformas compiladas desde el código fuente |
| Build Containers | No | No se incluyen por defecto |
| Dominios de proyecto personalizados | No | No forman parte del núcleo |
Saber esto de antemano te ahorra una conversación incómoda. Los equipos que esperan una interfaz de administración pulida desde el principio suelen concluir que la instalación "falló" cuando en realidad obtuvieron exactamente lo que ofrece una instalación del núcleo: un destino de despliegue con acceso compartido e historial conservado, y nada más.
Cloudflare directo frente a Void Platform autoalojada
Ambos destinos usan las mismas API de aplicación, así que moverse entre ellos no supone una reescritura. Las diferencias aparecen en las operaciones. La comparación siguiente refleja cómo se comportan ambos destinos en la práctica.
| Capacidad | Directo a Cloudflare | Plataforma autoalojada del núcleo |
|---|---|---|
| Workers AI y solicitudes a proveedores | Tu cuenta y pasarela | Pasarela y proxy de la instalación |
| Logs de ejecución | Tail en vivo de Cloudflare | Logs de plataforma conservados |
| Reversión de aplicaciones | Versiones de Worker | Despliegues de plataforma conservados |
| Sandboxes | Workers Paid más Docker | Workers Paid en la cuenta de la plataforma |
| Panel de usuario y compilaciones gestionadas de GitHub | No necesarios | No incluidos en una instalación estándar |
La conclusión práctica: elige despliegues directos cuando quieras cero superficie de administración, y elige una plataforma cuando quieras conservación y acceso compartido más de lo que quieres simplicidad. No hay respuesta incorrecta, solo una que no encaja.
Errores a los que prestar atención
La mayoría de los problemas que la gente encuentra durante un tutorial de Void Platform se remontan a la configuración, no a la instalación en sí. Los informes de la comunidad y la experiencia de administración tienden a agruparse en torno a los mismos pocos síntomas.
| Síntoma | Causa probable | Solución |
|---|---|---|
| El correo nunca llega | Dominio y zona de correo compartidos sin configurar | Configura ambos para activar la pasarela |
| Los webhooks de GitHub fallan detrás de Access | La ruta protegida de la API se traga las llamadas de webhook | Usa la configuración de entrada de webhooks aislada |
| Los Sandboxes no arrancan | Falta Workers Paid en la cuenta de la plataforma | Actualiza la cuenta en la que se ejecuta la plataforma |
| Un desarrollador no puede iniciar sesión | Ningún método de acceso habilitado, o URL incorrecta | Habilita un método y vuelve a compartir la URL de la plataforma |
| "¿Dónde está el panel?" | Expectativa desalineada | Explica el alcance de la instalación del núcleo, o añade el servicio opcional |
| El historial de reversiones parece vacío | Despliegas directo en lugar de a través de la plataforma | Apunta el CLI a la URL de la plataforma |
Un consejo más: mantén tus credenciales documentadas en algún lugar duradero y con control de acceso. La instalación es repetible; recordar qué credencial pertenece a qué entorno seis meses después es la parte que no lo es.
Preguntas frecuentes
¿Necesito un tutorial de Void Platform si solo despliego mis propias apps?
No. Desplegar directamente en Cloudflare es la decisión correcta para trabajo en solitario: te saltas la instalación, las tareas de administración y toda la sobrecarga de la cuenta compartida. Una plataforma es una herramienta de equipo, no un requisito previo.
¿Qué incluye realmente la instalación del núcleo?
Sandboxes gestionados y una pasarela de correo electrónico, con el correo activándose una vez que configuras un dominio y una zona de correo compartidos. El panel de usuario, las compilaciones y webhooks de GitHub, los build Containers y los dominios de proyecto personalizados quedan todos fuera del núcleo.
¿Cómo se conectan los desarrolladores una vez que la plataforma está en marcha?
Instalan el CLI de Void, lo apuntan a la URL de la plataforma, inician sesión mediante un método de acceso habilitado y despliegan. No se requiere ninguna configuración individual de cuenta de Cloudflare por su parte.
¿Este tutorial de Void Platform cubre plataformas a escala de equipo?
Cubre la instalación del núcleo, que es la base. Ejecutar una plataforma de equipo completa requiere además Workers for Platforms y la infraestructura documentada: revisa la documentación de Workers for Platforms antes de escalar.
¿Cuál es el error más grande que cometen los administradores?
Asumir que la instalación del núcleo incluye una interfaz y compilaciones gestionadas. Alinea las expectativas con tu equipo desde el principio, decide deliberadamente qué servicios opcionales necesitas y la plataforma hará exactamente lo que está diseñada para hacer: dar a todos un único lugar donde desplegar, con un historial al que realmente puedes revertir.
Guarda este tutorial de Void Platform en marcadores antes de tu próxima instalación: las tablas de verificación son la parte a la que volverás.
Guías relacionadas
Consejos sobre plataformas Void Platform: guía práctica para huecos en forjados más seguros en obra
Consejos prácticos sobre Void Platform para planificar, instalar, inspeccionar y retirar protecciones de huecos en forjados que las cuadrillas realmente utilizarán en obra.
Guía para principiantes de Void Platform: instalar, configurar y desplegar tu primera aplicación
Una guía práctica para principiantes de Void Platform que cubre los requisitos previos, el orden de instalación, las funciones principales frente a las opcionales y cómo incorporar a tu primer desarrollador.
Jugabilidad de Void Platform: una guía práctica para instalar y desplegar en Cloudflare
La jugabilidad de Void Platform, explicada: instala la plataforma, conecta la CLI, despliega apps y sabe exactamente qué incluye la compilación principal.
Recorrido por Void Platform: instalar una plataforma compartida de despliegue en Cloudflare
Un recorrido práctico por Void Platform: requisitos previos, credenciales, instalación del núcleo, servicios opcionales y las comprobaciones que mantienen en marcha los despliegues del equipo.