Prerrequisitos
- Node.js y npm/yarn/bun instalados.
- Una cuenta de Cloudflare.
- Wrangler CLI instalado globalmente o como dependencia de desarrollo (
npm install -g wranglerobun add -d wrangler).
Configuración
-
Iniciar sesión en Cloudflare:
Sigue las instrucciones para autenticarte con tu cuenta de Cloudflare.
-
Revisar
wrangler.jsonc(owrangler.toml):- Asegúrate de que la propiedad
namerefleje el nombre deseado para tu servicio Worker. - Verifica que la propiedad
mainapunte al archivo de entrada correcto (probablemente relacionado consrc/app/index.tsdespués de la compilación). (La ruta exacta depende del resultado de la compilación) - Comprueba
compatibility_datey actualízala si es necesario. - Confirma que el
account_idesté presente o configurado mediante variables de entorno/secretos si es necesario. - (Agrega cualquier detalle específico encontrado en wrangler.jsonc, como namespaces KV, rutas, etc., si estaban presentes)
- Asegúrate de que la propiedad
Compilación (Build)
Antes de desplegar, necesitas compilar el código TypeScript a JavaScript adecuado para Cloudflare Workers.tsc u otro empaquetador (como esbuild a través de las herramientas de compilación de Hono) para compilar el código, a menudo generando la salida en un directorio dist.
Despliegue (Deploy)
Una vez compilado, despliega el worker usando Wrangler:wrangler.jsonc. Después del despliegue, usualmente mostrará la URL donde el Worker es accesible.
CI/CD (Integración Continua / Despliegue Continuo)
(No se detectó configuración específica de CI/CD (p. ej., GitHub Actions, GitLab CI) en la estructura del repositorio proporcionada.) Para configurar CI/CD:- Crea archivos de flujo de trabajo (p. ej.,
.github/workflows/deploy.yml). - Configura los pasos para:
- Hacer checkout del código.
- Configurar Node.js/Bun.
- Instalar dependencias (
bun install). - Compilar el proyecto (
bun run build). - Desplegar usando Wrangler (
wrangler deploy).
- Almacena los tokens de API de Cloudflare (
CF_API_TOKEN) yCF_ACCOUNT_IDde forma segura como secretos en tu entorno de CI/CD. El comando de despliegue de Wrangler puede usar estas variables de entorno para la autenticación.