Nuvem e Docker
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.
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.
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.
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.
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.
| Imagem | Firebird | Porta do 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 |
Primeira execução
- 1compose.yamlcopiar do kit para uma pasta no host
- 2Senha do SYSDBAem um arquivo de segredo que só você pode ler
- 3Imagem, nome, segredosdefinir
imageehostname, remover o#das linhassecrets: - 4docker compose up -do contêiner instala o HQbird
- 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/, loginadmin. - O instalador cria a senha do console. Ela fica no arquivo
/opt/hqbird/conf/access.propertiesdentro do contêiner. - Nome do agente no HQCenter: nome do host, data da instalação e linha do Firebird.
Trabalho diário
| Tarefa | Comando |
|---|---|
| Estado dos serviços | docker compose exec hqbird systemctl list-units --type=service |
| Reiniciar o Firebird | docker compose exec hqbird systemctl restart firebirdFirebird 3.0: serviço firebird-superserver |
| isql | docker compose exec hqbird /opt/firebird/bin/isql -user SYSDBA localhost/3050:/db/my.fdb |
| Log da última hora | docker compose logs --since 1h |
| Parar | docker 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ção | O que faz |
|---|---|
HQBIRD_FB_PORT | Porta do Firebird dentro do contêiner, por padrão 3050. O HQ Monitor escuta em 20000 + essa porta. |
HQBIRD_HQM_PORT | Outra porta para o HQ Monitor. |
HQBIRD_AGENT_ID | Nome do agente. Por padrão, é formado pelo nome do host, pela data e pela porta. |
HQBIRD_HQM_LOGIN, segredo hqmonitor_password | Login e senha do HQ Monitor. |
HQBIRD_TRIAL_EMAIL, HQBIRD_TRIAL_ZONE | Pedido de licença de teste. |
segredo sysdba_password | Senha do SYSDBA do novo Firebird. |
segredo license | Arquivo de licença. |
segredo attach | Arquivo attach.json do HQCenter: conecta o agente à sua central. |
| Volume | Caminho | O que contém |
|---|---|---|
db | /db | Bancos de dados. Coloque seus bancos aqui. |
backup | /backup | Backups. |
opt | /opt | Firebird, agente, HQ Monitor, nó do cluster, RCM. |
state | /var/lib/hqbird-container | Serviços, dados do console, logs do agente, identificador da máquina. |
trust | /usr/libexec/hqbird-fbagent | Execução confiável das atualizações do agente. |
rootwork | /var/lib/hqbird-fbagent | Pasta de trabalho das atualizações. |
- Pastas do host só para bancos e backupsOs volumes
dbebackuppodem ser trocados por pastas do host. Dê essas pastas ao usuário com uid 84: é o usuáriofirebirdda 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
statee ao nome do agente. Um novo volumestateé uma nova instalação. - Conexão com a central por um arquivoO segredo
attachconecta 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.
| Porta | O quê | Quando é necessária |
|---|---|---|
HQBIRD_FB_PORT (3050) | Firebird | sempre |
| 20000 + porta do Firebird (23050) | HQ Monitor | sempre |
| porta do nó (7051) | nó do cluster | a instância entra no cluster |
| 7443, 7444 | RCM e a interface web dele | este 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 1 | Instância 2 | |
|---|---|---|
| Nome do projeto e do host | hqbird-fb40-3051 | hqbird-fb40-3052 |
HQBIRD_FB_PORT | 3051 | 3052 |
| Portas | 3051, 23051, 7052 | 3052, 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.
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.
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
-Te</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 verifyainda 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.