Despliegue
GMShop Edge admite dos tiempos de producción:
- Auto-alojamiento de Bun/Nitro: SQLite, objetos locales privados, una cola local duradera, y un directorio de datos persistente, utilizando Docker o un despliegue de origen con un gestor de servicios.
- Cloudflare Workers: D1, KV, R2, Colas, Disparadores de Cron, y opción para enviar correo electrónico.
Ambas plataformas exponen la misma tienda, cuentas de clientes, proceso de pago, gestión de envíos, panel de administración, API de proveedores, integración con Telegram y el flujo /install.
Docker Compose
El paquete público GHCR package es compatible con linux/amd64 y linux/arm64. Guarde el siguiente contenido como compose.yml:
services:
gmshop-edge:
image: ghcr.io/gmwalletapp/gmshop-edge:latest
restart: unless-stopped
ports:
- "3000:3000"
environment:
GMSHOP_DATA_DIR: /var/lib/gmshop
volumes:
- gmshop-data:/var/lib/gmshop
volumes:
gmshop-data:Inicie y verifique el servicio.
docker compose pull
docker compose up -d
curl --fail http://127.0.0.1:3000/healthz
docker compose ps
docker compose logs --follow gmshop-edgeEl contenedor se ejecuta como un usuario que no es administrador. GMSHOP_DATA_DIR contiene gmshop.sqlite, objetos privados, estado duradero de la cola y todos los datos de ejecución. Conserva y realiza una copia de seguridad del volumen gmshop-data cada vez que se actualice o reconstruya el contenedor.
GMSHOP_DATA_DIR es la única variable de entorno de Bun pública. Configure las opciones de Origin, Hosts Permitidos, correo electrónico, pago, proveedor, Telegram y automatización a través de /install o /admin.
Bun solo admite una instancia; no se permiten despliegues con réplicas múltiples ni almacenamiento en red compartido. Lea operaciones de datos de Bun antes de actualizar, restaurar o migrar un despliegue.
Despliegue en Bun desde el código fuente
Puedes ejecutar el servidor de producción directamente desde el código fuente, sin utilizar Docker. Instala Git y Bun 1.3 o una versión posterior; Node.js solo es necesario si eliges PM2 como administrador de procesos.
git clone https://github.com/GMWalletApp/gmshop-edge.git
cd gmshop-edge
bun install --frozen-lockfile
bun run build:bun
sudo install -d -m 0700 -o "$USER" -g "$USER" /var/lib/gmshop
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
GMSHOP_DATA_DIR=/var/lib/gmshop \
bun run start:bunEl último comando se ejecuta en primer plano. Manténgalo bajo un servicio como systemd, Supervisor, PM2, o cualquier otro gestor de servicios en producción. Asegúrese de preservar y hacer una copia de seguridad del directorio GMSHOP_DATA_DIR, de la misma manera que preservaría un volumen Docker. El entorno de ejecución de Bun solo admite una instancia; la implementación con réplicas múltiples y el almacenamiento en red compartido no son compatibles.
PM2
PM2 en sí mismo requiere Node.js y npm, pero GMShop Edge sigue funcionando con Bun. Se debe mantener la opción explícita --interpreter bun para que PM2 no intente iniciar el servidor generado con Node.js.
npm install --global pm2
NODE_ENV=production HOST=0.0.0.0 PORT=3000 \
GMSHOP_DATA_DIR=/var/lib/gmshop \
pm2 start .output/server/index.mjs \
--name gmshop-edge --interpreter bun
pm2 save
pm2 startupEjecuta el comando que muestra pm2 startup, y luego ejecuta pm2 save nuevamente. Utiliza pm2 logs gmshop-edge y curl --fail http://127.0.0.1:3000/healthz para verificar el servicio.
Para actualizar un despliegue de origen:
pm2 stop gmshop-edge
git pull --ff-only
bun install --frozen-lockfile
bun run build:bun
pm2 restart gmshop-edge --update-envCloudflare Workers
Botón de despliegue
La secuencia guiada prepara el proyecto Worker. Después de la implementación, abra /install y verifique las siguientes asociaciones:
- D1
gmshop-edgecomoDB. - KV
gmshop-edge-cachecomoCACHE. - Privado R2
gmshop-edge-filescomoFILES. - Cola
gmshop-edge-commercecomoCOMMERCE_QUEUE, congmshop-edge-commerce-dlqcomo su cola de mensajes en espera. - Cron de un minuto, y al seleccionar, Cloudflare Send Email como
EMAIL.
Wrangler CLI
bun install
bunx wrangler login
bun run deployEl hook predeploy crea o reutiliza los recursos nombrados, aplica las migraciones remotas y construye el Worker. Los IDs de D1/KV se inyectan únicamente en dist/server/wrangler.json; los IDs específicos de la cuenta no se escriben en el wrangler.jsonc portable.
Primera instalación
Después de que Docker o Bun comiencen, abra http://your-host:3000/install. Después de una implementación de Workers, abra /install en la URL del Worker. Confirme la dirección pública detectada y los Hosts Permitidos antes de crear el primer administrador raíz.
La instalación crea el primer administrador raíz, roles integrados de tienda protegidos, secretos en tiempo de ejecución, y valores predeterminados para comercio, tasas de cambio, autenticación y notificaciones. No crea productos falsos, inventario, credenciales de proveedores ni configuraciones de pago.
Después de la instalación:
- Revise la configuración del sistema generado en
/adminy realiza una copia de seguridad de la configuración de ejecución. - Configure la identidad de marca, el registro, la autenticación, el correo electrónico, el comercio electrónico, la gestión de pedidos, la retención de clientes y la configuración del proveedor.
- Cree un borrador de producto con elementos y stock que puedan vender, archivos o configuración de automatización; realice las comprobaciones de publicación antes de hacerlo público.
- Configure un adaptador de pago y completa un pedido de aceptación con un proveedor real antes de abrir la tienda.
Antes de la producción, verificar las reglas exactas de Host/Origen, un correo electrónico de pago y recuperación real, cumplimiento de stock/descarga/automatización, reintento de cola y recuperación de mensajes en cola, reembolsos, derechos expirados, restauración de copias de seguridad, ambas localizaciones de la aplicación, temas, comportamiento móvil, navegación con teclado y recuperación del administrador.