Nuvem e Docker

O HQbird funciona em um servidor na nuvem da mesma forma que no seu próprio servidor. Para o Docker, há uma imagem pronta para cada linha do Firebird. Os backups vão direto para o S3, sem arquivo no disco do servidor. A conexão com a central não precisa de portas de entrada.

  • 4 imagens Firebird 5 · 4 · 3 · 2.5
  • 1 contêiner Firebird, agente e console
  • S3 backup sem arquivo no disco
  • 0 portas de entrada para a conexão com a central
  • 200–250 MB de memória por instância sem carga

Servidor · contêiner · armazenamento

As três partes de uma instalação na nuvem

O HQbird pode ser instalado em um servidor na nuvem com o instalador normal ou rodar em um contêiner Docker. Nos dois casos, o próprio agente se conecta ao HQCenter, e os backups podem ir para um armazenamento S3.

Diagrama: as aplicações e o navegador se conectam ao contêiner HQbird no host; o próprio agente se conecta ao HQCenter e envia os backups para o S3 servidor na nuvem ou host Docker HQbird Firebird fbagent HQ Monitor volumes: /db · /backup · /opt portas: 3050 · 23050 cluster: 7051 · 7443 · 7444 Aplicações porta Firebird 3050 Navegador HQ Monitor 23050 HQCenter o agente se conecta S3 backups, HTTPS
Quem se conecta a quem. As aplicações e o navegador entram pelas portas do Firebird e do HQ Monitor. O próprio agente se conecta ao HQCenter e ao S3: para isso não há portas de entrada.
Servidor

Instalador normal

Um arquivo instala o Firebird, o agente e o console no servidor na nuvem. O próprio instalador não baixa nada. Serve quando o servidor inteiro é dedicado ao banco.

Contêiner

Imagem Docker

Um contêiner é um Firebird com todos os componentes do HQbird. Os dados ficam nos volumes e continuam quando o contêiner ou a imagem são trocados.

Armazenamento

Backups no S3

O gbak e o nbackup gravam em um stream, e o stream vai para o bucket. Não é preciso espaço para o backup no disco do servidor. Funciona no servidor e no contêiner.

Mais na página de backups →

Imagens · primeira execução · compose

HQbird no Docker

O contêiner instala o HQbird com o mesmo instalador do servidor. Dentro rodam o Firebird, o agente fbagent e o HQ Monitor. O próprio agente instala o nó do cluster quando a instância entra no cluster. Ele instala o RCM só quando esta instância é designada como RCM do cluster.

As imagens ficam no GitHub Container Registry da IBSurgeon. Elas são públicas: não é preciso fazer login no registro. A tag da imagem é a versão do kit HQbird.

ImagemFirebirdPorta do 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

Primeira execução

  1. 1compose.yamlcopiar do kit para uma pasta no host
  2. 2Senha do SYSDBAem um arquivo de segredo que só você pode ler
  3. 3Imagem, nome, segredosdefinir image e hostname, remover o # das linhas secrets:
  4. 4docker compose up -do contêiner instala o HQbird
  5. 5✓ healthyo Firebird e o console respondem
mkdir -p secrets
openssl rand -hex 12 > secrets/sysdba_password
chmod 600 secrets/sysdba_password
docker compose up -d
docker compose logs -f   # andamento da instalação
docker compose ps        # aguardar healthy

Em um servidor com 2 núcleos, a instalação na primeira execução leva cerca de 20 segundos.

O resultado

  • Firebird: <host Docker>:3050.
  • HQ Monitor: http://<host Docker>:23050/, login admin.
  • O instalador cria a senha do console. Ela fica no arquivo /opt/hqbird/conf/access.properties dentro do contêiner.
  • Nome do agente no HQCenter: nome do host, data da instalação e linha do Firebird.

Trabalho diário

TarefaComando
Estado dos serviçosdocker compose exec hqbird systemctl list-units --type=service
Reiniciar o Firebirddocker compose exec hqbird systemctl restart firebird
Firebird 3.0: serviço firebird-superserver
isqldocker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb
Log da última horadocker compose logs --since 1h
Parardocker compose stop: o Firebird fecha os bancos

Dentro do contêiner, o comando systemctl controla os serviços do HQbird, mas não é o systemd. Ele entende os comandos que os programas do HQbird usam: start, stop, restart, status, list-units e outros.

Variáveis · segredos · volumes

Configurações e volumes

As configurações são lidas uma vez, na primeira execução: essa é a instalação. Os dados, a configuração, a licença e os programas atualizados ficam nos volumes. Eles continuam quando você cria o contêiner de novo ou troca a imagem.

ConfiguraçãoO que faz
HQBIRD_FB_PORTPorta do Firebird dentro do contêiner, por padrão 3050. O HQ Monitor escuta em 20000 + essa porta.
HQBIRD_HQM_PORTOutra porta para o HQ Monitor.
HQBIRD_AGENT_IDNome do agente. Por padrão, é formado pelo nome do host, pela data e pela porta.
HQBIRD_HQM_LOGIN, segredo hqmonitor_passwordLogin e senha do HQ Monitor.
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONEPedido de licença de teste.
segredo sysdba_passwordSenha do SYSDBA do novo Firebird.
segredo licenseArquivo de licença.
segredo attachArquivo attach.json do HQCenter: conecta o agente à sua central.
VolumeCaminhoO que contém
db/dbBancos de dados. Coloque seus bancos aqui.
backup/backupBackups.
opt/optFirebird, agente, HQ Monitor, nó do cluster, RCM.
state/var/lib/hqbird-containerServiços, dados do console, logs do agente, identificador da máquina.
trust/usr/libexec/hqbird-fbagentExecução confiável das atualizações do agente.
rootwork/var/lib/hqbird-fbagentPasta de trabalho das atualizações.
  • Pastas do host só para bancos e backupsOs volumes db e backup podem ser trocados por pastas do host. Dê essas pastas ao usuário com uid 84: é o usuário firebird da imagem. Não troque os outros quatro volumes por pastas do host.
  • Cópia de segurança dos volumesSalve os seis volumes juntos.
  • Não mude o nome do hostA licença está ligada ao identificador da máquina no volume state e ao nome do agente. Um novo volume state é uma nova instalação.
  • Conexão com a central por um arquivoO segredo attach conecta o agente ao HQCenter na primeira execução. Não é preciso entrar no contêiner para isso.

Publicação de portas · firewall · segunda instância

Portas e várias instâncias

Publique cada porta com o mesmo número fora e dentro do contêiner: 3051:3051, e não 3051:3050. O agente e o cluster informam a porta que veem dentro do contêiner.

PortaO quêQuando é necessária
HQBIRD_FB_PORT (3050)Firebirdsempre
20000 + porta do Firebird (23050)HQ Monitorsempre
porta do nó (7051)nó do clustera instância entra no cluster
7443, 7444RCM e a interface web deleeste agente mantém o RCM; um por host

O Docker publica as portas sem passar pelo ufw. Testado: com a regra do ufw "só a porta 22", as portas do Firebird e do HQ Monitor ficaram abertas para a internet. Use um firewall externo, publique a porta em um só endereço do host ("10.0.0.5:23050:23050") ou adicione regras na cadeia DOCKER-USER do iptables.

Segunda instância no mesmo host

Cada instância precisa de sua própria pasta, seu próprio nome de projeto, seu próprio nome de host e suas próprias portas. O nome do projeto define os nomes dos volumes. Com o mesmo nome, a segunda execução toma os volumes e o contêiner da primeira.

  • Firebird: 3050 + N.
  • HQ Monitor: 20000 + porta do Firebird.
  • Nó do cluster: 7051 + N.
  • Só uma instância do host pode manter o RCM.

Outras linhas do Firebird no mesmo host seguem as mesmas regras, cada uma com sua imagem.

Instância 1Instância 2
Nome do projeto e do hosthqbird-fb40-3051hqbird-fb40-3052
HQBIRD_FB_PORT30513052
Portas3051, 23051, 70523052, 23052, 7053
  • MemóriaUma instância sem carga ocupa cerca de 200–250 MB. Testado: três instâncias do Firebird 4.0 em um servidor com 2 núcleos e 4 GB de memória, uma delas com carga.
  • Firebird fora do Docker no mesmo hostSe o host já roda Firebird ou HQbird sem Docker, pule as portas 3050, 23050 e 7051.

HQCenter · nova imagem · cluster

Atualizações e cluster

Há duas formas de atualizar o contêiner. As duas mantêm os dados.

Pelo HQCenter

Como em um servidor normal: a central atualiza o agente, o HQ Monitor, o Firebird, o nó do cluster e o RCM dentro do contêiner. Os programas atualizados ficam em um volume, por isso continuam após o reinício.

Com uma nova imagem

Troque a versão na linha image e execute:

docker compose pull
docker compose up -d

Ao iniciar, o contêiner roda o instalador da nova imagem no modo de atualização. Se a central já atualizou o agente para uma versão mais nova que a da imagem, o instalador não roda: a versão não volta para trás.

Contêiner no cluster

Uma instância no contêiner entra no cluster da mesma forma que um servidor. O endereço do participante é o endereço do host Docker. No compose.yaml, publique as portas do cluster.

  • A porta do nó, por exemplo 7051: quando a instância é participante do cluster.
  • As portas 7443 e 7444: quando este agente mantém o RCM. Para a interface web na 7444, defina nas configurações do RCM operator_addr = 0.0.0.0:7444.
  • A porta do nó na descrição do cluster deve ser igual à porta publicada.

O agente instala o nó alguns minutos depois que o cluster é salvo. Até lá, a porta do nó não responde.

Mais sobre cluster e replicação →

Servidor na nuvem · NAT · firewall

HQbird em um servidor na nuvem

Em um servidor na nuvem, o HQbird é instalado com o instalador normal: um arquivo, um comando. O Firebird, o agente e o console estão dentro do arquivo: o instalador não baixa nada. No Linux, ele pega algumas bibliotecas do SO (libtommath, ICU) do repositório da distribuição. Se não houver repositório, ele mostra os comandos exatos e não muda nada.

  • A central não precisa de portas de entradaO próprio agente se conecta ao HQCenter. Um servidor atrás de NAT ou em uma rede fechada da nuvem aparece na central da mesma forma que um servidor no seu rack.
  • Firewall do sistema operacionalO instalador abre a porta do novo Firebird e a porta do HQ Monitor no firewalld ou no ufw. As regras do firewall da própria nuvem são configuradas por você.
  • Requisitos do servidorA partir de 2 GB de memória, 2 núcleos e 5 GB de disco. Linux x86-64 ou Windows.
  • Distribuições LinuxUbuntu, Debian, AlmaLinux, Rocky, RHEL, Oracle Linux, openSUSE, RED OS e outras com apt, dnf, yum ou zypper.
  • Cem servidores por scriptTodos os passos da instalação existem como opções de linha de comando. É possível ver antes o plano de instalação: o comando não altera nada.
  • Segredos protegidosUm segredo digitado no console vai para o agente criptografado. Nos relatórios e nas cópias da configuração, os segredos ficam ocultos. No arquivo de configuração do agente, a chave do S3 não é criptografada: limite o acesso a esse arquivo. Em um servidor Amazon EC2, é possível trabalhar sem chave, pela função (role) do servidor.
  • Métricas no seu GrafanaO agente fornece métricas do Firebird e do servidor no formato Prometheus.
  • Disco da nuvem sob controleO agente mede a latência de leitura e gravação e prevê quando o disco vai encher. Um disco da nuvem lento ou com pouco espaço aparece no relatório de saúde.

Mais sobre instalação e atualizações →

Limitações · dicas

O que é importante saber

  • Docker e ufwUma porta publicada do contêiner fica aberta sem passar pelo ufw. Feche-a com um firewall externo ou publique-a em um só endereço.
  • Configurações só na primeira execuçãoAs variáveis e os segredos são lidos uma vez. Depois não é possível mudar a porta do Firebird, o nome do host e os segredos: é preciso uma nova instalação. Os jobs e as outras configurações do agente são alterados no HQ Monitor ou pela central.
  • Scripts com docker compose execNos scripts, adicione a opção -T e </dev/null. Sem elas, o comando lê a entrada padrão e consome o resto do script.
  • Avisos antes da conexão com a centralEnquanto o agente não está conectado ao HQCenter, o log dele diz que as configurações de conexão estão incompletas. Isso é normal.
  • Assinatura das imagensAs imagens são assinadas com a ferramenta cosign. A chave pública para verificar com o comando cosign verify ainda não foi publicada.
  • Onde foi testadoUbuntu 22.04, Docker com Compose, servidor com 2 núcleos e 4 GB de memória. A instalação passo a passo para Ubuntu está disponível em russo e em português.

← Voltar à visão geral do HQbird 2027