Visión general
El operador aprovisiona y mantiene la plataforma mediante un instalador automatizado y un proceso de deploy basado en imágenes versionadas. El objetivo es levantar y actualizar la instalación de forma predecible, con rollback a mano.
Requisitos previos
- Acceso de infraestructura (servidor único o clúster).
- Credenciales del registro de imágenes y DNS/TLS del dominio.
Paso a paso
- Aprovisiona la infraestructura (servidor único o clúster) con el instalador.
- Configura dominios, DNS y certificados TLS.
- Despliega la imagen versionada de la plataforma.
- Ejecuta las migraciones de base de datos y verifica la salud de los servicios.
- En actualizaciones, despliega la nueva versión con una estrategia de despliegue gradual.
Configuración y opciones
- Variables de entorno: secretos y parámetros de la instalación.
- Imágenes versionadas: fija la versión a desplegar (evita etiquetas genéricas en producción).
- Migraciones: ejecuta las migraciones como un paso controlado del deploy.
Casos de uso
- Levantar una nueva instalación desde cero.
- Actualizar a una nueva versión con rollback disponible.
Consejos, límites y buenas prácticas
- Ten siempre el comando de rollback escrito antes de iniciar el deploy.
- Actualiza un servicio a la vez y verifica la salud antes de continuar.
- Nunca expongas secretos en archivos versionados.
Solución de problemas
- El servicio no arranca: revisa las variables de entorno y los logs del servicio.
- La migración falló: verifica la conectividad de la base de datos y ejecuta la migración aislada.