Nube y Docker
Nube y Docker
HQbird funciona en un servidor en la nube igual que en tu propio servidor. Para Docker, hay una imagen lista para cada línea de Firebird. Las copias de seguridad van directamente a S3, sin ningún archivo en el disco del servidor. La conexión con el centro no necesita puertos de entrada.
- 4 imágenes Firebird 5 · 4 · 3 · 2.5
- 1 contenedor Firebird, agente y consola
- S3 copia de seguridad sin archivo en disco
- 0 puertos de entrada para la conexión con el centro
- 200–250 MB de memoria por instancia inactiva
Servidor · contenedor · almacenamiento
Tres partes de una instalación en la nube
Puedes instalar HQbird en un servidor en la nube con el instalador normal o ejecutarlo en un contenedor Docker. En ambos casos el agente se conecta a HQCenter por sí mismo, y las copias de seguridad pueden ir al almacenamiento S3.
Instalador normal
Un solo archivo instala Firebird, el agente y la consola en un servidor en la nube. El instalador en sí no descarga nada. Es una buena opción cuando todo el servidor es para la base de datos.
Imagen Docker
Un contenedor es un Firebird con todos los componentes de HQbird. Los datos están en volúmenes y se conservan cuando reemplazas el contenedor o la imagen.
Copias de seguridad a S3
gbak y nbackup escriben en un flujo, y el flujo va a un bucket. La copia de seguridad no necesita espacio en el disco del servidor. Funciona tanto en un servidor como en un contenedor.
Imágenes · primer inicio · compose
HQbird en Docker
El contenedor instala HQbird con el mismo instalador que un servidor. Firebird, el agente fbagent y HQ Monitor se ejecutan dentro. El agente instala el nodo del clúster por sí mismo cuando la instancia se une a un clúster. Solo instala RCM cuando esta instancia se asigna como RCM del clúster.
Las imágenes están en el IBSurgeon GitHub Container Registry. Son públicas: no necesitas iniciar sesión en el registro. La etiqueta de la imagen es la versión del kit de HQbird.
| Imagen | Firebird | Puerto Firebird | HQ Monitor |
|---|---|---|---|
ghcr.io/ibsurgeon/hqbird2027-fb50 | 5.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb40 | 4.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb30 | 3.0 | 3050 | 23050 |
ghcr.io/ibsurgeon/hqbird2027-fb25 | 2.5 | 3050 | 23050 |
Primer inicio
- 1compose.yamlcópialo del kit a una carpeta del host
- 2Contraseña de SYSDBAen un archivo secreto que solo tú puedas leer
- 3Imagen, nombre, secretosdefine
imageyhostname, quita el#de las líneassecrets: - 4docker compose up -del contenedor instala HQbird
- 5✓ healthyFirebird y la consola responden
mkdir -p secrets openssl rand -hex 12 > secrets/sysdba_password chmod 600 secrets/sysdba_password docker compose up -d docker compose logs -f # installation progress docker compose ps # wait for healthy
En un servidor con 2 núcleos, la instalación en el primer inicio tarda unos 20 segundos.
Lo que obtienes
- Firebird:
<Docker host>:3050. - HQ Monitor:
http://<Docker host>:23050/, inicio de sesiónadmin. - El instalador crea la contraseña de la consola. Está en el archivo
/opt/hqbird/conf/access.propertiesdentro del contenedor. - El nombre del agente en HQCenter: el nombre del host, la fecha de instalación y la línea de Firebird.
Trabajo diario
| Tarea | Comando |
|---|---|
| Estado del servicio | docker compose exec hqbird systemctl list-units --type=service |
| Reiniciar Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: el servicio firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Registro de una hora | docker compose logs --since 1h |
| Detener | docker compose stop: Firebird cierra las bases de datos |
Dentro del contenedor, el comando systemctl controla los servicios de HQbird, pero no es systemd. Entiende los comandos que usan los programas de HQbird: start, stop, restart, status, list-units y otros.
Variables · secretos · volúmenes
Ajustes y volúmenes
El contenedor lee los ajustes solo una vez, en el primer inicio: esto es la instalación. Los datos, la configuración, la licencia y los programas actualizados están en volúmenes. Se conservan cuando creas el contenedor de nuevo o cambias la imagen.
| Ajuste | Qué hace |
|---|---|
HQBIRD_FB_PORT | Puerto de Firebird dentro del contenedor, 3050 por defecto. HQ Monitor escucha en 20000 + este puerto. |
HQBIRD_HQM_PORT | Un puerto diferente para HQ Monitor. |
HQBIRD_AGENT_ID | Nombre del agente. Por defecto se forma con el nombre del host, la fecha y el puerto. |
HQBIRD_HQM_LOGIN, secreto hqmonitor_password | Inicio de sesión y contraseña de HQ Monitor. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Solicitud de una licencia de prueba. |
secreto sysdba_password | Contraseña de SYSDBA del nuevo Firebird. |
secreto license | Archivo de licencia. |
secreto attach | El archivo attach.json de HQCenter: conecta el agente a tu centro. |
| Volumen | Ruta | Contenido |
|---|---|---|
db | /db | Bases de datos. Coloque aquí sus bases de datos. |
backup | /backup | Copias de seguridad. |
opt | /opt | Firebird, el agente, HQ Monitor, el nodo del clúster, RCM. |
state | /var/lib/hqbird-container | Servicios, datos de la consola, registros del agente, ID de la máquina. |
trust | /usr/libexec/hqbird-fbagent | Inicio de confianza de las actualizaciones del agente. |
rootwork | /var/lib/hqbird-fbagent | Carpeta de trabajo para las actualizaciones. |
- Carpetas del host solo para bases de datos y copias de seguridadPuede reemplazar los volúmenes
dbybackupcon carpetas del host. Asígnelas al usuario con uid 84: este es el usuariofirebirdde la imagen. No reemplace los otros cuatro volúmenes con carpetas del host. - Copia de seguridad de los volúmenesGuarde los seis volúmenes juntos.
- No cambie el nombre del hostLa licencia está vinculada al ID de la máquina en el volumen
statey al nombre del agente. Un nuevo volumenstatees una nueva instalación. - Conéctese al centro con un solo archivoEl secreto
attachconecta el agente a HQCenter en el primer inicio. No necesita entrar al contenedor para esto.
Publicación de puertos · firewall · segunda instancia
Puertos y varias instancias
Publique cada puerto con el mismo número fuera y dentro del contenedor: 3051:3051, no 3051:3050. El agente y el clúster informan el puerto que ven dentro del contenedor.
| Puerto | Qué | Cuándo se necesita |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | siempre |
| 20000 + puerto de Firebird (23050) | HQ Monitor | siempre |
| puerto del nodo (7051) | nodo del clúster | la instancia se une a un clúster |
| 7443, 7444 | RCM y su interfaz web | este agente ejecuta RCM; uno por host |
Docker publica puertos por encima de ufw. Lo comprobamos: con la regla de ufw "solo el puerto 22", los puertos de Firebird y HQ Monitor estaban abiertos desde internet. Use un firewall externo, publique el puerto en una dirección del host ("10.0.0.5:23050:23050") o agregue reglas a la cadena DOCKER-USER de iptables.
Segunda instancia en el mismo host
Cada instancia necesita su propia carpeta, nombre de proyecto, nombre de host y puertos. El nombre del proyecto define los nombres de los volúmenes. Con el mismo nombre, el segundo inicio toma los volúmenes y el contenedor del primero.
- Firebird: 3050 + N.
- HQ Monitor: 20000 + puerto de Firebird.
- Nodo del clúster: 7051 + N.
- Solo una instancia en el host puede ejecutar RCM.
Otras líneas de Firebird en el mismo host siguen las mismas reglas, cada una con su propia imagen.
| Instancia 1 | Instancia 2 | |
|---|---|---|
| Proyecto y nombre de host | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Puertos | 3051, 23051, 7052 | 3052, 23052, 7053 |
- MemoriaUna instancia inactiva ocupa unos 200–250 MB. Lo comprobamos: tres instancias de Firebird 4.0 en un servidor con 2 núcleos y 4 GB de memoria, una de ellas bajo carga.
- Firebird fuera de Docker en el mismo hostSi Firebird o HQbird ya se ejecuta en el host sin Docker, omita los puertos 3050, 23050 y 7051.
HQCenter · nueva imagen · clúster
Actualizaciones y clúster
Puede actualizar un contenedor de dos maneras. Ambas conservan los datos.
Desde HQCenter
Como en un servidor normal: el centro actualiza el agente, HQ Monitor, Firebird, el nodo del clúster y RCM dentro del contenedor. Los programas actualizados están en un volumen, por lo que permanecen después de un reinicio.
Con una nueva imagen
Cambie la versión en la línea image y ejecute:
docker compose pull docker compose up -d
Al iniciar, el contenedor ejecuta el instalador de la nueva imagen en modo de actualización. Si el centro ya actualizó el agente a una versión más reciente que la de la imagen, el instalador no se ejecuta: la versión no retrocede.
Contenedor en un clúster
Una instancia en un contenedor se une a un clúster de la misma manera que un servidor. La dirección del miembro es la dirección del host de Docker. Publique los puertos del clúster en compose.yaml.
- El puerto del nodo, por ejemplo 7051: cuando la instancia es miembro del clúster.
- Los puertos 7443 y 7444: cuando este agente ejecuta RCM. Para la interfaz web en 7444, establezca
operator_addr=0.0.0.0:7444en la configuración de RCM. - El puerto del nodo en la descripción del clúster debe coincidir con el puerto publicado.
El agente instala el nodo unos minutos después de que guarde el clúster. Hasta entonces, el puerto del nodo no responde.
Servidor en la nube · NAT · firewall
HQbird en un servidor en la nube
En un servidor en la nube, instala HQbird con el instalador normal: un archivo, un comando. Firebird, el agente y la consola están dentro del archivo: el instalador no descarga nada. En Linux, obtiene algunas bibliotecas del sistema operativo (libtommath, ICU) del repositorio de la distribución. Si no hay repositorio, imprime los comandos exactos y no cambia nada.
- Sin puertos de entrada para el centroEl agente se conecta a HQCenter por su cuenta. Un servidor detrás de NAT o en una red privada de la nube se ve en el centro igual que un servidor en su rack.
- Firewall del sistema operativoEl instalador abre el puerto del nuevo Firebird y el puerto de HQ Monitor en firewalld o ufw. Usted configura las reglas del firewall de la propia nube.
- Requisitos del servidorAl menos 2 GB de memoria, 2 núcleos y 5 GB de disco. Linux x86-64 o Windows.
- Distribuciones de LinuxUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS y otras con apt, dnf, yum o zypper.
- Cien servidores por scriptCada paso de la instalación está disponible como una opción. Puede ver primero el plan de instalación: el comando no cambia nada.
- Los secretos están protegidosUn secreto que introduzca en la consola llega al agente cifrado. Los secretos se ocultan en los informes y en las copias de configuración. En el archivo de configuración del agente, la clave de S3 no está cifrada: limite el acceso a este archivo. En un servidor de Amazon EC2, puede trabajar sin clave: el agente usa el rol IAM del servidor.
- Métricas en su GrafanaEl agente exporta métricas de Firebird y del servidor en formato Prometheus.
- Disco en la nube bajo controlEl agente mide la latencia de lectura y escritura y pronostica cuándo se llenará el disco. Un disco en la nube lento o casi lleno es visible en el informe de estado.
Límites · consejos
Bueno saber
- Docker y ufwUn puerto de contenedor publicado está abierto por encima de ufw. Ciérrelo con un firewall externo o publíquelo en una sola dirección.
- Configuración solo en el primer inicioLas variables y los secretos se leen una vez. No puede cambiar el puerto de Firebird, el nombre del host y los secretos después: necesita una nueva instalación. Los trabajos y otras configuraciones del agente se cambian en HQ Monitor o desde el centro.
- Scripts con docker compose execEn los scripts, agregue la opción
-Ty</dev/null. Sin ellas, el comando lee la entrada estándar y toma el resto del script.
- Advertencias antes de la conexión con el centroHasta que el agente se conecta a HQCenter, su registro indica que la configuración de conexión está incompleta. Esto es normal.
- Firma de la imagenLas imágenes están firmadas con la herramienta cosign. La clave pública para verificarlas con el comando
cosign verifyaún no está publicada. - Dónde se probóUbuntu 22.04, Docker con Compose, un servidor con 2 núcleos y 4 GB de memoria. Hay una guía de instalación paso a paso para Ubuntu disponible en ruso y portugués.