Ejecutando Cloudflare Workers en Spin Apps

Guía práctica para integrar Cloudflare Workers en Spin, empaquetarlos en un binario Wasm único y desplegar en runtimes como SpinKube y Akamai Wasm Functions.

18 ago 2025 • 6 min de lectura • Equip Q2BSTUDIO

Inteligencia-Artificial-

By Matt Butcher traducido y reescrito por Q2BSTUDIO

En la actualidad existen muchos tipos de funciones sin servidor. Cloudflare Workers es una forma popular diseñada para ejecutarse en el edge. En muchos casos es posible compilar, cargar y ejecutar Cloudflare Workers dentro de aplicaciones Spin, lo que ofrece flexibilidad para desplegar en Cloudflare o empaquetar todo en un binario Wasm para entornos compatibles con Spin como SpinKube Kubernetes Fermyon Cloud o Akamai mediante Wasm Functions.

Antes de entrar en la parte practica es importante entender la diferencia principal entre Cloudflare Workers y las aplicaciones Spin. Cloudflare ejecuta archivos JavaScript en un interprete basado en V8. Cuando Cloudflare ejecuta un Worker carga los archivos JS en ese interprete y los ejecuta. Spin en cambio ejecuta binarios WebAssembly. Al ejecutar spin build se compila un binario Wasm. En aplicaciones JavaScript para Spin lo que hacemos es incluir un runtime de JavaScript como SpiderMonkey cargar los scripts en ese runtime y compilar todo a Wasm. El resultado no contiene archivos .js ejecutables por separado sino bytecode Wasm.

La tecnica que mostramos consiste en tratar al Worker como una biblioteca. Eso significa que en tiempo de compilacion el Worker se compila junto al codigo de Spin dentro del mismo binario WebAssembly y asi se integra completamente.

Para seguir este tutorial asumimos que ya tiene instalados Spin y npm. Empezaremos creando una app Spin JavaScript dentro de la cual añadiremos un Cloudflare Worker, verificaremos su ejecucion local y luego enlazaremos Spin para enrutar peticiones al Worker. Al compilar tendremos un unico artefacto Wasm que contiene el router de Spin y el Worker integrado.

Crear la aplicacion Spin

No hay nada especial para crear una app Spin que invoque un Worker. El proceso standard es por ejemplo ejecutar en su terminal spin new -t http-js --accept-defaults spin-worker para generar la estructura basica de proyecto. A continuacion entre en el directorio cd spin-worker y ejecute spin build para verificar que el proyecto compila correctamente.

Una vez construido puede arrancar el servicio con spin up y desde otra terminal probar con curl localhost:3000 para ver la respuesta por defecto hello universe que demuestra que la aplicacion Spin funciona.

Crear un Worker

Para crear un Cloudflare Worker dentro del proyecto utilice npm create cloudflare@latest -- cf-worker y siga las indicaciones seleccionando Hello World example Worker only JavaScript sin git ni despliegue automatico. Esto creara un subdirectorio cf-worker. Para probar el Worker de forma independiente puede usar npx wrangler dev que levanta un servidor local usualmente en el puerto 8787 y respondera Hello World o el texto que configure.

Edite el archivo cf-worker/src/index.js y modifique la funcion fetch para devolver un texto identificable por ejemplo Hello from a worker. Reinicie wrangler dev y compruebe con curl localhost:8787 que recibe la respuesta esperada.

Llamar al Worker desde Spin

Abra el codigo de Spin en spin-worker/src/index.js y modifique el router para ofrecer una ruta raiz que responda Hello from Spin y una ruta adicional /worker que invoque la funcion fetch del Worker embebido. Importe el Worker desde ../cf-worker/src/index y añada una ruta .get /worker Worker.fetch para que al recibir esa ruta Spin ejecute el fetch del Worker integrado. Reconstruya con spin build --up y pruebe con curl localhost:3000 y curl localhost:3000/worker para verificar que ambas rutas devuelven Hello from Spin y Hello from a worker respectivamente.

Con esta aproximacion el Worker se compila junto al resto de la app y se ejecuta desde el mismo binario Wasm por lo que no necesita desplegarse por separado si su objetivo es ejecutar todo dentro de un runtime compatible con Spin.

Despliegue en runtimes compatibles

El paquete Wasm resultante puede ejecutarse en diversos entornos como SpinKube en Kubernetes Fermyon Cloud Azure AKS Rancher Desktop o Akamai mediante Fermyon Wasm Functions. Para desplegar en Akamai con el plugin Spin Akamai basta con ejecutar spin aka deploy desde el directorio del proyecto y seguir las instrucciones. Tras el despliegue recibira una URL publica donde podra acceder tanto a la ruta raiz como a la ruta /worker y comprobar que el Worker integrado responde correctamente.

Limitaciones y siguientes pasos

Muchas funciones de Cloudflare Workers se adaptan bien a esta integracion sin embargo hay APIs que difieren entre el entorno de Workers y el ecosistema Spin. En futuros desarrollos conviene crear capas de adaptacion que seleccionen recursos como key value storage segun el runtime objetivo. Con un diseño cuidadoso es posible mantener una unica base de codigo que soporte tanto ejecucion nativa en Cloudflare como empaquetado dentro de Spin.

Acerca de Q2BSTUDIO

En Q2BSTUDIO somos una empresa de desarrollo de software especializada en aplicaciones a medida y software a medida. Ofrecemos soluciones que combinan inteligencia artificial y ciberseguridad para empresas de todos los tamanos. Nuestros servicios incluyen integracion con servicios cloud aws y azure desarrollo de servicios de inteligencia de negocio e implementacion de soluciones de ia para empresas. Tambien desarrollamos agentes IA personalizados y cuadros de mando con power bi para maximizar el valor de sus datos.

Si su empresa busca modernizar aplicaciones migrar cargas a la nube o incorporar capacidades avanzadas de inteligencia artificial y ciberseguridad Q2BSTUDIO puede ayudar. Implementamos soluciones seguras escalables y orientadas a resultados que integran las mejores practicas en desarrollo de software aplicaciones a medida y en la adopcion de servicios cloud aws y azure.

Palabras clave y posicionamiento

Este articulo incluye terminos relevantes para mejorar posicionamiento como aplicaciones a medida software a medida inteligencia artificial ciberseguridad servicios cloud aws y azure servicios inteligencia de negocio ia para empresas agentes IA y power bi. Utilice estos terminos en su estrategia de contenido para atraer clientes interesados en desarrollos personalizados y soluciones de inteligencia de negocio.

Contacte con Q2BSTUDIO para evaluar su proyecto recibir una demostracion o solicitar un presupuesto. Podemos ayudarle a integrar Cloudflare Workers dentro de flujos basados en Spin o a desplegar soluciones serverless y Wasm en multiplataforma aprovechando la potencia de la nube y la inteligencia artificial para impulsar su negocio.

Resumen practico

En resumen puede incorporar un Worker de Cloudflare dentro de una app Spin siguiendo estos pasos crear app Spin crear Worker probar Worker por separado importar el Worker en Spin y enrutar peticiones al Worker compilar todo a Wasm y desplegar en el runtime deseado. Esta estrategia reduce la complejidad de gestionar dos despliegues separados y facilita el mantenimiento de una sola base de codigo que sirva tanto para entornos edge como para entornos basados en WebAssembly.

Q2BSTUDIO acompana a las empresas en cada fase del proyecto desde el diseno hasta el despliegue y mantenimiento asegurando soluciones seguras y optimizadas que integran aplicaciones a medida software a medida inteligencia artificial y ciberseguridad para obtener resultados medibles.

UNA PAUSA?

Juga una estona abans de marxar

ELS NOSTRES SERVEIS

Com et podem ajudar

Intel·ligència artificial

Agents d'IA, chatbots i assistents intel·ligents que automatitzen tasques i atenen els teus clients 24/7 per millorar l'eficiència del teu negoci.

Més info

Desenvolupament de programari

Aplicacions web, mòbils i d'escriptori, intranets, e-commerce, SaaS i plataformes de gestió dissenyades per a les necessitats concretes de la teva empresa.

Més info

Serveis cloud

Migració, infraestructura, hosting gestionat, alta disponibilitat i seguretat en Microsoft Azure i Amazon Web Services perquè el teu negoci escali sense límits.

Més info

Ciberseguretat i pentesting

Auditories de seguretat, test d'intrusió (pentesting) i protecció d'aplicacions, dades i infraestructura on-premise i cloud, amb hacking ètic i compliment normatiu.

Més info

Business Intelligence

Quadres de comandament i anàlisi de dades amb Power BI: integrem les teves fonts, dissenyem dashboards i KPIs i convertim les teves dades en decisions.

Més info

Automatització de processos

Automatitzem tasques repetitives i connectem les teves aplicacions amb n8n, Power Automate, Make i RPA, eliminant treball manual i augmentant la productivitat.

Més info

Formació per a empreses

Formem els teus equips en tecnologia amb criteri: desenvolupament web, bases de dades, Git, bones pràctiques i seguretat, automatització amb n8n, intel·ligència artificial per a empreses i creació de solucions d'IA amb Azure AI Foundry.

Més info

Auditoria de codi

Auditem el codi que creguis tu, el teu equip o una IA: et diem què està bé i què millorar, el securitzem i el deixem llest per a producció, web o app.

Més info

Generació d'imatges amb IA

Creem per tu les imatges que necessita el teu negoci amb intel·ligència artificial: producte, xarxes, publicitat, il·lustració i avatars. Tu ens dius què vols i t'ho lliurem llest per fer servir.

Més info

Generació de vídeos amb IA

Creem per tu vídeos amb intel·ligència artificial: promocionals, per a xarxes, presentadors virtuals, doblatge i animacions. Ens comptes la idea i t'ho lliurem muntat i llest per publicar.

Més info

Avatars conversacionals amb IA

Creem avatars conversacionals amb IA —humans digitals amb cara i veu— que atenen els teus clients i equips amb el coneixement de la teva empresa, a la teva web, monitors interactius, WhatsApp o Teams.

Més info

Màrqueting Online i IA

Google Ads, Meta Ads, LinkedIn Ads i posicionament en motors d'IA (GEO/AEO): captem clients i fem que la teva marca aparegui on et busquen, també a ChatGPT, Gemini i Perplexity.

Més info

Tens un projecte en ment?

Explica'ns la teva visió i la convertim en una solució de programari. Sigui quin sigui l'abast, fem realitat la teva idea.

Live Chat