Deployment (Index)
Deployment — hub de navegación para elegir el flujo de despliegue correcto. ↓ Production Install · ⬆ Documentación AITHA
This page is the navigation hub for deployment documentation.
Choose your deployment flow
Pick the one you need:
- Fresh production server (manual runbook + guided wizard): Production Install Runbook
- Cloudflare DNS automation: Cloudflare
- Local development (Docker) + Vagrant sandbox testing: Local Development and Sandbox
If the server is already bootstrapped, use the deploy section inside Production Install Runbook.
Cómo se deploya en cada host
Cómo se deploya en un host es una propiedad del host, no del comando: vive
versionada en deployment/hosts/<host-de-la-inventory>.env y la carga
deployment/scripts/infra/host_config.sh en cuanto un comando resuelve un
selector de host.
./infra release 3 store # ordinal de `server list --ordinal`
./infra release sd2 store # alias de CORE2_HOST_ALIASES
./infra remote deploy sd2 apps
./infra remote dns cloudflare sd2 --apply --wait # la zona sale del host
Antes eso viajaba en la línea de comandos del operador
(PUBLIC_BASE_DOMAIN=… REMOTE_STATUS_PAGE_HOST=… ./infra release … --remote-build),
así que no estaba versionado, no se podía descubrir, y olvidar una variable
dejaba el deploy apuntando a los defaults de otra instancia.
| Clave | Para qué |
|---|---|
CORE2_HOST_ALIASES | selectores cortos, separados por coma |
PUBLIC_BASE_DOMAIN | dominio público de la instancia |
REMOTE_STATUS_PAGE_HOST | shortname de la página de status |
CORE2_BUILD_MODE | local (build en el controlador), remote (build en el servidor, obligatorio si la arquitectura difiere), skip (no toca imágenes) |
CORE2_CF_ZONE | zona por defecto del sync de DNS |
Reglas:
- Una variable ya presente en el entorno gana sobre el archivo, así que el
override puntual sigue valiendo:
CORE2_BUILD_MODE=skip ./infra release sd2 store. Los flags--remote-build/--local-buildpisanCORE2_BUILD_MODE. - El archivo se lee, no se ejecuta: solo
KEY=VALUEplanos. - Un host sin archivo se comporta como antes, heredando los defaults globales de
deployment/topology.env. - Regresión cubierta por
./infra test host-config.
Detalle y plantilla: deployment/hosts/README.md.
Related runbooks
- Configuration inputs and generation: Configuration
- DNS generation: Cloudflare
- Bootstrap failures (SSH, reboot, network): Remote Bootstrap (Troubleshooting)
- Core private registry workflows: Private Registry
- Backups and snapshots: Backups
- General runtime troubleshooting: Troubleshooting