Esta página fue traducida automáticamente. Lee el original en inglés. English

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.

Diagrama: las aplicaciones y el navegador se conectan al contenedor HQbird en el host; el agente se conecta a HQCenter por sí mismo y envía las copias de seguridad a S3 servidor en la nube o host Docker HQbird Firebird fbagent HQ Monitor volúmenes: /db · /backup · /opt puertos: 3050 · 23050 clúster: 7051 · 7443 · 7444 Clientes puerto Firebird 3050 Navegador HQ Monitor 23050 HQCenter el agente se conecta hacia fuera S3 copias de seguridad, HTTPS
Quién se conecta a quién. Las aplicaciones y el navegador entran por los puertos de Firebird y HQ Monitor. El agente se conecta a HQCenter y a S3 por sí mismo: para esto no se necesitan puertos de entrada.
Servidor

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.

Contenedor

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.

Almacenamiento

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.

Más sobre las copias de seguridad →

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.

ImagenFirebirdPuerto FirebirdHQ Monitor
ghcr.io/ibsurgeon/hqbird2027-fb505.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb404.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb303.0305023050
ghcr.io/ibsurgeon/hqbird2027-fb252.5305023050

Primer inicio

  1. 1compose.yamlcópialo del kit a una carpeta del host
  2. 2Contraseña de SYSDBAen un archivo secreto que solo tú puedas leer
  3. 3Imagen, nombre, secretosdefine image y hostname, quita el # de las líneas secrets:
  4. 4docker compose up -del contenedor instala HQbird
  5. 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ón admin.
  • El instalador crea la contraseña de la consola. Está en el archivo /opt/hqbird/conf/access.properties dentro 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

TareaComando
Estado del serviciodocker compose exec hqbird systemctl list-units --type=service
Reiniciar Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0: el servicio firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Registro de una horadocker compose logs --since 1h
Detenerdocker 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.

AjusteQué hace
HQBIRD_FB_PORTPuerto de Firebird dentro del contenedor, 3050 por defecto. HQ Monitor escucha en 20000 + este puerto.
HQBIRD_HQM_PORTUn puerto diferente para HQ Monitor.
HQBIRD_AGENT_IDNombre del agente. Por defecto se forma con el nombre del host, la fecha y el puerto.
HQBIRD_HQM_LOGIN, secreto hqmonitor_passwordInicio de sesión y contraseña de HQ Monitor.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONESolicitud de una licencia de prueba.
secreto sysdba_passwordContraseña de SYSDBA del nuevo Firebird.
secreto licenseArchivo de licencia.
secreto attachEl archivo attach.json de HQCenter: conecta el agente a tu centro.
VolumenRutaContenido
db/dbBases de datos. Coloque aquí sus bases de datos.
backup/backupCopias de seguridad.
opt/optFirebird, el agente, HQ Monitor, el nodo del clúster, RCM.
state/var/lib/hqbird-containerServicios, datos de la consola, registros del agente, ID de la máquina.
trust/usr/libexec/hqbird-fbagentInicio de confianza de las actualizaciones del agente.
rootwork/var/lib/hqbird-fbagentCarpeta de trabajo para las actualizaciones.
  • Carpetas del host solo para bases de datos y copias de seguridadPuede reemplazar los volúmenes db y backup con carpetas del host. Asígnelas al usuario con uid 84: este es el usuario firebird de 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 state y al nombre del agente. Un nuevo volumen state es una nueva instalación.
  • Conéctese al centro con un solo archivoEl secreto attach conecta 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.

PuertoQuéCuándo se necesita
HQBIRD_FB_PORT (3050)Firebirdsiempre
20000 + puerto de Firebird (23050)HQ Monitorsiempre
puerto del nodo (7051)nodo del clústerla instancia se une a un clúster
7443, 7444RCM y su interfaz webeste 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 1Instancia 2
Proyecto y nombre de hosthqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Puertos3051, 23051, 70523052, 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:7444 en 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.

Más sobre el clúster y la replicación →

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.

Más sobre la instalación y las actualizaciones →

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 -T y </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 verify aú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.

← Volver a la descripción general de HQbird 2027