Configurar y desplegar aplicaciones en la red global de Cloudflare es más accesible de lo que parece. Con una cuenta gratuita, sin necesidad de tarjeta de crédito, puedes tener tu primer worker funcionando en minutos. A continuación se explican los pasos fundamentales para crear una cuenta, familiarizarte con la interfaz y construir tu primera aplicación tanto desde el dashboard como desde la línea de comandos.
¿Cómo crear una cuenta en Cloudflare y explorar la interfaz?
El proceso de registro es directo: te autentificas con el método que prefieras (por ejemplo, Gmail), respondes algunas preguntas de onboarding —como si el uso será personal o profesional— y listo, sin ingresar datos de tarjeta de crédito [0:20]. Una vez dentro, el panel principal ofrece múltiples opciones organizadas por categorías.
Dentro de la sección de cómputo, encontrarás Workers y Pages [1:00]. Aunque originalmente Cloudflare lanzó Pages para simplificar el despliegue de aplicaciones front-end, con el tiempo descubrieron que esta separación generaba complejidad adicional. Actualmente, las nuevas funcionalidades se lanzan exclusivamente en Workers, convirtiendo a Pages en un servicio en proceso de descontinuación. Por eso, todo el desarrollo —ya sea back-end, front-end u otros servicios— se realiza directamente en Workers.
¿Qué opciones ofrece un worker después de crearlo?
Al crear tu primer worker con un template de "Hello World" [1:52], Cloudflare aprovisiona los recursos en segundos. El código inicial es muy sencillo: un console.info y un Response que devuelve el saludo. Una vez desplegado, la interfaz presenta varias pestañas importantes:
- Métricas: analítica de uso del worker.
- Deployments: historial de despliegues, que luego puedes conectar con un repositorio de GitHub.
- Bindings: permite conectar bases de datos, KVs y otros servicios de Cloudflare [2:40].
- Observabilidad: integrada por defecto con el dashboard.
- Settings: configuraciones avanzadas como dominio por defecto, custom domain, preview URLs para multi staging donde cada pull request vive en una URL independiente, variables, secrets y configuraciones de runtime [3:05].
El editor en línea funciona bien para workers simples, pero cuando trabajas con frameworks o TypeScript, el código aparece minificado u ofuscado, lo que hace impráctica la edición desde el navegador [3:50].
¿Cómo funciona el despliegue global de Cloudflare?
Cada vez que guardas y despliegas cambios, Cloudflare distribuye tu aplicación a través de todos sus datacenters a nivel global, haciendo que los despliegues sean extremadamente rápidos [4:35]. Esto se comprobó al modificar el "Hello World" para incluir saludos en inglés y español, verificando el resultado casi de inmediato en la URL asignada.
¿Cómo crear un worker desde el CLI y conectarlo con GitHub?
Para un flujo de trabajo profesional, la creación desde la línea de comandos es el camino recomendado. El primer paso es seleccionar la versión de Node.js —en este caso la versión 22— [5:10]. Un dato relevante: aunque Workers soporta JavaScript, TypeScript, Python y Rust (todo lo que compile a WebAssembly), la documentación está mayoritariamente orientada a JavaScript y TypeScript.
El CLI genera toda la estructura del proyecto mediante scaffolding, instala dependencias y permite conectar el repositorio con GitHub y la cuenta de Cloudflare para aprovechar las ventajas de CI/CD [5:40].
¿Qué archivos de configuración son esenciales?
Siguiendo la documentación oficial, se deben configurar varios archivos clave:
- Plugin de Vite para workers: se agrega para que el proyecto se ejecute correctamente en la red de Cloudflare, útil también al migrar aplicaciones existentes [6:30].
- vite.config.ts: se actualiza con las líneas indicadas en la documentación, ubicado en la raíz del proyecto.
- Archivo wrangler (grungler): es el archivo más importante de un worker [7:05]. Define el nombre, el
compatibilityDate, los assets, los bindings y demás configuraciones avanzadas.
- tsconfig-worker.json: configuración específica de TypeScript para el worker.
- worker/index.ts: archivo principal que contiene la lógica del worker desplegado.
La propiedad main dentro del archivo de configuración hace referencia directa al worker que se va a desplegar. Cuando la aplicación combina front-end y back-end en el mismo worker, se configura una especie de routing: las rutas definidas se atienden por el worker, y cuando no existen, se sirve la SPA configurada con Vite [8:10].
La documentación oficial de Cloudflare es el recurso principal para resolver dudas y seguir cada paso de configuración. Comparte en los comentarios cómo fue tu experiencia creando tu primer worker.
