Instalação com PostgreSQL externo#

Este guia se aplica à nova instalação do Sherpa Orchestrator com um banco de dados PostgreSQL em um servidor separado. Ao atualizar uma instalação existente, utilize o processo de atualização e prepare um backup com antecedência.

Antes de começar#

• Prepare um servidor PostgreSQL versão 13 ou superior com um banco de dados em codificação UTF-8.
• Permita conexões da rede Docker do servidor Orchestrator: configure listen_addresses, a regra host em pg_hba.conf e o firewall. Verifique o endereço e a porta disponíveis a partir do contêiner, e não apenas do host.
• Escolha um nome para a função de trabalho, banco de dados e uma senha separada. A função de trabalho precisará de permissão CREATE no banco: as migrações criarão automaticamente os esquemas orchestrator e orchestrator_archive.
• Se a função e o banco já foram criados pelo administrador do PostgreSQL, as credenciais administrativas não são necessárias para o instalador. Caso contrário, prepare uma função administrativa temporária com permissões CREATEROLE e CREATEDB.

Instalação#

1. Descompacte o pacote do cliente e execute sudo ./sh_scripts/install.sh, conforme descrito na instrução geral.
2. Na etapa Seleção do banco de dados, escolha 4 — PostgreSQL Externo. O contêiner do banco de dados não será iniciado.
3. Informe POSTGRES_PASSWORD da função de trabalho, em seguida POSTGRES_HOST, POSTGRES_PORT, POSTGRES_USER e POSTGRES_DBNAME. Não deixe o exemplo de senha do modelo no arquivo .env.
4. Se a função ou o banco ainda não foram criados, preencha POSTGRES_ADMIN_USER, POSTGRES_ADMIN_PASSWORD e, se necessário, POSTGRES_ADMIN_DBNAME (por padrão postgres). Se a função e o banco já foram criados, deixe a função administrativa em branco.
5. Aguarde a verificação da conexão antes de iniciar o sistema. O instalador verificará a disponibilidade do servidor e o login da função de trabalho, criará a função e o banco, se necessário, e então verificará a permissão CREATE.
6. Se a verificação falhar, execute as ações indicadas no servidor PostgreSQL e escolha r — Repetir verificação. A opção e permite corrigir os parâmetros de conexão. Não pule a verificação com a opção s: o Orchestrator não será iniciado enquanto o banco ou a função não estiverem disponíveis.
7. Conclua as demais etapas do instalador e abra a interface do Orchestrator. Verifique o login e a criação de um objeto de teste na seção permitida para sua função.

Se a verificação não passar#

• Servidor indisponível: verifique POSTGRES_HOST, POSTGRES_PORT, roteamento do Docker, listen_addresses, pg_hba.conf e o firewall.
• Função ou banco ausente: crie-os no servidor PostgreSQL ou forneça temporariamente as credenciais administrativas ao instalador. Após a criação do banco, conceda à função de trabalho a permissão CREATE.
• Erro de login da função de trabalho: verifique sua senha no arquivo .env e a regra permissiva em pg_hba.conf. Se a função existia anteriormente, sua senha pode ser diferente da especificada para a nova instalação.

Os esquemas orchestrator e orchestrator_archive são criados pelas migrações. Para uma nova instalação, não carregue um dump de outro sistema.