Instalar Excubius
Excubius se ejecuta en un servidor Linux que tú controlas, en tu suscripción de nube o en tu centro de datos. El instalador interactivo revisa el servidor, hace unas pocas preguntas, instala los contenedores y obtiene el certificado. Este artículo enumera lo que necesitas, lo que el instalador pregunta y hace, y a dónde ir para cada tarea posterior.
Antes de empezar
| Elemento | Requisito |
|---|---|
| Servidor | Rocky Linux 9 o 10 (u otro sistema de la familia RHEL), x86-64, systemd. Al menos 2 vCPU, 4 GiB de memoria y 20 GiB de disco libre; en Azure, Standard_B2ms (2 vCPU, 8 GiB) es un buen punto de partida y se puede redimensionar más adelante. Si tu equipo de nube crea los servidores, consulta Solicitar el servidor de Azure |
| Acceso | Una cuenta con sudo en el servidor, accesible por SSH desde tu estación de trabajo |
| Red hacia los usuarios | Puertos 80 y 443 libres en el servidor y abiertos desde donde las personas usarán Excubius |
| Salida | HTTPS hacia ghcr.io y docker.io para descargar las imágenes, salvo que uses el paquete sin conexión |
| Red hacia lo que monitoreas | Desde el servidor, el puerto SQL de cada instancia, réplica e IP de listener (y UDP 1434 para instancias con nombre sin puerto fijo), además de HTTPS hacia los puntos de conexión web que pruebes. Nada se conecta al recolector |
| Paquete del instalador | excubius-installer-<version>.tar.gz, o el paquete sin conexión con las imágenes incluidas. Los usuarios con sesión iniciada obtienen ambos en Descargas |
| Inicio de sesión | Un registro de aplicación de Microsoft Entra ID, un cliente OAuth de Google, o ambos. Consulta Configurar proveedores de inicio de sesión |
| Inicios de sesión de monitoreo | Inicios de sesión de solo lectura para lo que vayas a monitorear, por ejemplo el inicio de sesión de SQL Server de Requisitos previos para grupos de disponibilidad |
| Certificado | Para Let's Encrypt, un nombre DNS público que apunte al servidor, o acceso por API a su zona DNS. No es necesario si usas tu propio certificado, uno autofirmado o una puerta de enlace que termina TLS |
Cómo funciona la instalación
Las comprobaciones previas revisan el sistema operativo y su versión, la arquitectura, systemd y dnf, la memoria, las CPU, el disco, que los puertos 80 y 443 estén libres, SELinux, el acceso a los registros de contenedores o al archivo de imágenes, y la sincronización del reloj.
El servidor recibe el paquete de la versión, un archivo de configuración y las imágenes de contenedor. Nunca recibe código fuente ni se conecta a un repositorio de código.
Instalar
-
Copia el paquete del instalador al servidor y descomprímelo:
tar -xzf excubius-installer-0.4.0.tar.gzcd excubius-installer-0.4.0 -
Si quieres, ejecuta solo las comprobaciones previas. No cambian nada:
sudo ./install.sh --check-only -
Ejecuta el instalador y responde sus preguntas. Presiona Entrar para aceptar el valor entre corchetes:
sudo ./install.shEl instalador guarda tus respuestas, con versiones, para que una actualización solo haga las preguntas nuevas de esa versión.
-
Cuando termine, abre la dirección pública que muestra e inicia sesión como el administrador que indicaste durante la instalación. Después, configura el inicio de sesión e invita a las personas que usarán Excubius.
Todo lo que hace el instalador queda registrado en /var/log/excubius-install.log, sin secretos.
Las preguntas del instalador
| Pregunta | Valor predeterminado | Notas |
|---|---|---|
| Directorio de instalación | /opt/excubius | Cualquier ruta absoluta |
| Cuenta de servicio | excubius | Se crea si no existe. Ejecuta los contenedores sin privilegios de root |
| URL pública | https://monitoring.example.com | La dirección que abrirán las personas. Su host es el nombre principal del servidor |
| Alias | Ninguno | Otros nombres que las personas pueden abrir, separados por espacios, por ejemplo un alias en un dominio que controlas |
| TLS | letsencrypt | letsencrypt (por HTTP), letsencrypt-dns (por DNS), selfsigned, custom (tus archivos PEM), gateway (TLS termina delante) o later (HTTP sin cifrar por ahora) |
| Nombres del certificado | all | Se pregunta cuando hay alias: deja fuera los nombres que un certificado no puede cubrir |
| Correo electrónico para Let's Encrypt | — | Ambos modos de Let's Encrypt |
| Proveedor de DNS y credenciales | — | Solo letsencrypt-dns: el id de dnsapi de acme.sh, como dns_cf, dns_dreamhost o dns_azure, y sus variables, que se escriben una por una sin mostrarse en pantalla |
| Archivos de certificado y clave | — | Solo custom: la cadena PEM, con el certificado del servidor primero, y una clave sin cifrar |
| Nombre de usuario y contraseña del administrador | Un nombre de usuario sugerido | La cuenta del primer inicio de sesión, en la dirección que el instalador muestra al terminar. La contraseña necesita 12 caracteres o más y se pide dos veces |
| Preset base | enterprise | enterprise, databases o core; consulta Configurar la instancia |
| Usuario y token del registro | — | Se te entregan con la licencia. No se piden con el paquete sin conexión |
| Token del bot de Slack y canal | — y #alerts | Opcional; puedes configurarlos más adelante. Consulta Configurar las notificaciones de Slack |
| ID de inquilino, ID de cliente y secreto de Entra ID | — | Opcional; puedes configurarlos más adelante |
Con un modo de Let's Encrypt, el instalador comprueba después los nombres en el DNS público y, por HTTP, que apunten a este servidor. Si no apuntan, explica las alternativas; nunca se detiene por eso.
El instalador genera una sola vez la contraseña de la base de datos, el secreto de firma de sesiones, la clave que cifra los secretos guardados y el token del recolector, y nunca los pide. Cuando la plataforma ya guardó la contraseña del administrador, las credenciales de DNS y una clave privada, el instalador las quita del archivo de configuración.
Para instalar sin preguntas, pasa las respuestas en un archivo con --answers; consulta la referencia del instalador.
Nombres y TLS
| Modo | Úsalo cuando |
|---|---|
| Let's Encrypt, validación por HTTP | El nombre se resuelve públicamente al servidor y el puerto 80 es accesible desde internet |
| Let's Encrypt, validación por DNS | El servidor es privado, pero puedes crear registros DNS mediante una API |
| Tu propio certificado | Tu organización emite certificados |
| Autofirmado | Un laboratorio o una primera prueba |
| Puerta de enlace | Un equilibrador de carga o un proxy inverso delante del servidor termina TLS |
| HTTP sin cifrar | Una primera prueba, o una red en la que confías por completo |
Puedes cambiar los nombres y el certificado más adelante desde Configuración sin reinstalar, y la renovación es automática. Consulta Configurar nombres y TLS.
Actualizar, reinstalar o desinstalar
| Comando | Qué hace |
|---|---|
sudo ./install.sh en un servidor ya instalado | Ofrece Upgrade (conserva los datos y solo hace las preguntas nuevas), Reinstall, Purge and install fresh o Cancel |
sudo ./install.sh --uninstall | Hace una última copia de seguridad de la base de datos y luego elimina los servicios y las imágenes. Conserva los datos, las copias de seguridad y la configuración |
sudo ./install.sh --uninstall --purge | También elimina los datos, las copias de seguridad y la cuenta de servicio. Te pide que escribas purge |
Actualiza dentro de una ventana de cambios. Los servicios se reinician durante unos segundos y se ejecutan las migraciones de la base de datos. Antes de empezar, lee los problemas conocidos de la versión.
--dry-run funciona con todos los comandos y solo muestra lo que ocurriría. Los pasos para actualizar, revertir, hacer copias de seguridad y restaurar están en Actualizar, hacer copias de seguridad y restaurar, para usuarios con sesión iniciada.
Vigilar Excubius desde fuera
Excubius no debe ser lo único que se vigila a sí mismo. Registra https://<your server>/heartbeat en un vigilante externo, como una prueba de disponibilidad de Azure Monitor, Uptime Kuma ejecutándose en otro lugar o un servicio del estilo de healthchecks, y haz que te avise cuando la dirección deje de responder ok. Si el servidor se detiene, ese vigilante es el que te lo dice.
/heartbeat y /healthz responden por HTTP sin cifrar en todos los modos de TLS. /healthz también devuelve la versión que se está ejecutando.