Instalar o Excubius
O Excubius é executado em um servidor Linux que você controla, na sua assinatura de nuvem ou no seu datacenter. O instalador interativo verifica o servidor, faz uma lista curta de perguntas, instala os contêineres e obtém o certificado. Este artigo lista o que você precisa, o que o instalador pergunta e faz e aonde ir para cada tarefa seguinte.
Antes de começar
| Item | Requisito |
|---|---|
| Servidor | Rocky Linux 9 ou 10 (ou outro sistema da família RHEL), x86-64, systemd. Pelo menos 2 vCPUs, 4 GiB de memória e 20 GiB de disco livre; no Azure, Standard_B2ms (2 vCPUs, 8 GiB) é um bom começo e pode ser redimensionado depois. Se a sua equipe de nuvem cria os servidores, consulte Solicitar o servidor do Azure |
| Acesso | Uma conta com sudo no servidor, acessível por SSH a partir da sua estação de trabalho |
| Rede para os usuários | Portas 80 e 443 livres no servidor e abertas a partir de onde as pessoas usarão o Excubius |
| Saída | HTTPS para ghcr.io e docker.io para baixar as imagens, a menos que você use o pacote offline |
| Rede para o que você monitora | A partir do servidor, a porta SQL de cada instância, réplica e IP de ouvinte (e UDP 1434 para instâncias nomeadas sem porta fixa), além de HTTPS para os endpoints web que você testa. Nada se conecta ao coletor |
| Pacote do instalador | excubius-installer-<version>.tar.gz ou o pacote offline com as imagens incluídas. Usuários conectados obtêm os dois em Downloads |
| Entrada | Um registro de aplicativo do Microsoft Entra ID, um cliente OAuth do Google ou ambos. Consulte Configurar provedores de entrada |
| Logons de monitoramento | Logons somente leitura para o que você vai monitorar, por exemplo o logon do SQL Server em Pré-requisitos para grupos de disponibilidade |
| Certificado | Para o Let's Encrypt, um nome DNS público que aponte para o servidor ou acesso por API à zona DNS dele. Não é necessário para um certificado próprio, um autoassinado ou um gateway que encerra o TLS |
Como a instalação funciona
As verificações prévias abrangem o sistema operacional e a versão dele, a arquitetura, o systemd e o dnf, a memória, as CPUs, o disco, as portas 80 e 443 livres, o SELinux, o acesso aos registros ou ao arquivo de imagens e a sincronização do relógio.
O servidor recebe o pacote da versão, um arquivo de configuração e as imagens de contêiner. Ele nunca recebe código-fonte e nunca acessa um repositório de código.
Instalar
-
Copie o pacote do instalador para o servidor e descompacte-o:
tar -xzf excubius-installer-0.4.0.tar.gzcd excubius-installer-0.4.0 -
Se quiser, execute apenas as verificações prévias. Elas não alteram nada:
sudo ./install.sh --check-only -
Execute o instalador e responda às perguntas. Pressione Enter para aceitar o valor entre colchetes:
sudo ./install.shO instalador guarda as suas respostas, com controle de versão, para que uma atualização pergunte apenas o que é novo naquela versão.
-
Ao terminar, abra o endereço público que ele exibe e entre como o administrador que você definiu durante a instalação. Em seguida, configure a entrada e convide as pessoas que usarão o Excubius.
Tudo o que o instalador faz é registrado em /var/log/excubius-install.log, sem segredos.
As perguntas do instalador
| Pergunta | Padrão | Observações |
|---|---|---|
| Diretório de instalação | /opt/excubius | Qualquer caminho absoluto |
| Conta de serviço | excubius | É criada se não existir. Executa os contêineres sem privilégios de root |
| URL pública | https://monitoring.example.com | O endereço que as pessoas vão abrir. O host dele é o nome principal do servidor |
| Aliases | Nenhum | Outros nomes que as pessoas podem abrir, separados por espaços, por exemplo um alias em um domínio que você controla |
| TLS | letsencrypt | letsencrypt (por HTTP), letsencrypt-dns (por DNS), selfsigned, custom (seus arquivos PEM), gateway (o TLS termina na frente) ou later (HTTP simples por enquanto) |
| Nomes no certificado | all | Perguntado quando há aliases: deixe de fora os nomes que um certificado não pode cobrir |
| E-mail para o Let's Encrypt | — | Nos dois modos do Let's Encrypt |
| Provedor de DNS e credenciais | — | Somente letsencrypt-dns: o id dnsapi do acme.sh, como dns_cf, dns_dreamhost ou dns_azure, e as variáveis dele, digitadas uma a uma sem eco |
| Arquivos de certificado e chave | — | Somente custom: a cadeia PEM, com o certificado do servidor primeiro, e uma chave não criptografada |
| Nome de usuário e senha do administrador | Um nome de usuário sugerido | A conta para a primeira entrada, no endereço que o instalador exibe ao terminar. A senha precisa ter 12 caracteres ou mais e é pedida duas vezes |
| Predefinição base | enterprise | enterprise, databases ou core; consulte Configurar a instância |
| Usuário e token do registro | — | Fornecidos a você com a licença. Não são perguntados com o pacote offline |
| Token do bot e canal do Slack | — e #alerts | Opcional; você pode defini-los depois. Consulte Configurar notificações do Slack |
| ID do locatário, ID do cliente e segredo do Entra ID | — | Opcional; você pode defini-los depois |
Com um modo do Let's Encrypt, o instalador verifica em seguida os nomes no DNS público e, por HTTP, se eles apontam para este servidor. Quando não apontam, ele explica as alternativas; ele nunca para por causa disso.
O instalador gera uma única vez a senha do banco de dados, o segredo de assinatura de sessão, a chave que criptografa os segredos armazenados e o token do coletor, e nunca os pede. Depois que a plataforma armazena a senha do administrador, as credenciais de DNS e uma chave privada, ele as remove do arquivo de configuração.
Para instalar sem perguntas, passe as respostas em um arquivo com --answers; consulte a referência do instalador.
Nomes e TLS
| Modo | Use quando |
|---|---|
| Let's Encrypt, validação por HTTP | O nome é resolvido publicamente para o servidor e a porta 80 está acessível pela internet |
| Let's Encrypt, validação por DNS | O servidor é privado, mas você pode criar registros DNS por meio de uma API |
| Seu próprio certificado | A sua organização emite certificados |
| Autoassinado | Um laboratório ou um primeiro teste |
| Gateway | Um balanceador de carga ou proxy reverso na frente encerra o TLS |
| HTTP simples | Um primeiro teste ou uma rede em que você confia totalmente |
Você pode alterar os nomes e o certificado depois em Settings (Configurações) sem reinstalar, e a renovação é automática. Consulte Configurar nomes e TLS.
Atualizar, reinstalar ou desinstalar
| Comando | O que faz |
|---|---|
sudo ./install.sh em um servidor instalado | Oferece Upgrade (mantém os dados e faz apenas as perguntas novas), Reinstall, Purge and install fresh ou Cancel |
sudo ./install.sh --uninstall | Faz um último backup do banco de dados e depois remove os serviços e as imagens. Mantém os dados, os backups e a configuração |
sudo ./install.sh --uninstall --purge | Também exclui os dados, os backups e a conta de serviço. Pede que você digite purge |
Atualize em uma janela de mudança. Os serviços são reiniciados por alguns segundos e as migrações do banco de dados são executadas. Leia os problemas conhecidos da versão antes de começar.
--dry-run funciona com todos os comandos e apenas exibe o que aconteceria. As etapas para atualizar, reverter, fazer backup e restaurar estão em Atualizar, fazer backup e restaurar, para usuários conectados.
Monitorar o Excubius de fora
O Excubius não deve ser o único a monitorar a si mesmo. Registre https://<your server>/heartbeat em um monitor externo, como um teste de disponibilidade do Azure Monitor, um Uptime Kuma executado em outro lugar ou um serviço no estilo healthchecks, e configure-o para alertar você quando o endereço parar de responder ok. Se o servidor parar, é esse monitor que avisa você.
/heartbeat e /healthz respondem por HTTP simples em todos os modos de TLS. /healthz também retorna a versão em execução.