Saltar al contenido
Guías

Build y despliegue

Compila y publica una tienda en Cloudflare Workers con la CLI.

El destino disponible es Cloudflare Workers. ecomiq build y ecomiq deploy siempre compilan con el runtime workerd, aunque desarrollo use Node.

Configuración

ecomiq.config.js
import { defineConfig } from "@ecomiq/storefront/config";

export default defineConfig({
  domain: "marketplace",
  deploy: {
    target: "cloudflare",
    name: "andina-market",
    routes: [{ pattern: "tienda.ejemplo.pe", custom_domain: true }],
  },
  env: {
    PUBLIC_SUPPORT_EMAIL: "soporte@ejemplo.pe",
  },
});

Si omites deploy.name, la CLI genera el nombre a partir de domain. deploy.routes acepta la misma forma que routes de Wrangler:

  • Un string.
  • { pattern, zone_id, custom_domain? }.
  • { pattern, zone_name, custom_domain? }.
  • { pattern, custom_domain, enabled?, previews_enabled? }.

Build

pnpm build

El resultado queda en .ecomiq/dist. La CLI también genera el server entry y la configuración de Wrangler. No los edites.

Despliegue

Autentica Wrangler con una sesión local o CLOUDFLARE_API_TOKEN y ejecuta:

pnpm deploy

deploy realiza un build nuevo y después ejecuta wrangler deploy con la configuración generada.

Variables y secretos

env termina en vars del Worker y es visible como configuración de texto. Úsalo solo para valores no sensibles.

Configura tokens, claves privadas y BETTER_AUTH_SECRET como Cloudflare Secrets, no dentro de ecomiq.config.js.

Comprobación

El Worker generado responde:

RutaUso
/pingComprobación simple; responde ok.
/__ecomiq/healthVerifica también la carga de settings.

La CLI no acepta flags de deploy

No hay --name, --env, --route ni --dry-run. Declara el nombre, las rutas y las variables en ecomiq.config.js.

En esta página