Operação

Como operar o Human Plugin no dia a dia.

Markdown

Atualizações

Execute a imagem latest e atualize quando a Unico anunciar uma versão:

• Docker Compose: docker compose pull && docker compose up -d.
• Kubernetes: kubectl -n human-plugin rollout restart deployment/human-plugin, com imagePullPolicy: Always.

Uma nova versão prepara as tabelas de que precisa na inicialização, antes de aceitar tráfego, então nenhuma etapa manual no banco de dados é necessária. Faça um backup do banco de dados antes de atualizar a produção e verifique /health/ready e uma requisição de criação real depois.

Rotação de credenciais

Chave de acesso. A Unico emite a nova chave com uma janela de sobreposição. Atualize HUMAN_API_ACCESS_KEY no seu .env ou Secret, reinicie o Human Plugin (docker compose up -d --force-recreate ou kubectl -n human-plugin rollout restart deployment/human-plugin), confirme que uma criação funciona e então peça à Unico que revogue a chave antiga.

Credenciais do registry. A Unico emite um novo token enquanto o antigo ainda funciona. Faça login novamente com o novo token (ou recrie o pull secret do Kubernetes), faça um pull para confirmar e então peça à Unico que revogue o token antigo. Os contêineres em execução não são afetados.

Senha do banco de dados. Altere-a no PostgreSQL e em POSTGRES_PASSWORD e reinicie o Human Plugin.

Desligamento

Ao receber SIGTERM, o Human Plugin deixa de aceitar conexões e aguarda até 55 segundos pelas requisições em andamento, porque uma criação pode levar até 30 segundos e depois gravar o seu resultado. Defina o stop timeout para pelo menos 60 segundos. Uma criação interrompida é encerrada como falha em uma leitura posterior.

Escalabilidade

O Human Plugin não guarda estado de requisição em memória, então vários contêineres podem compartilhar um mesmo banco de dados. Adicione uma réplica a cada 1.500 transações por minuto e aumente o max_connections do PostgreSQL para 25 × o número de réplicas + 10. Veja Requisitos de hardware.

O catálogo de atributos

O Human Plugin baixa o catálogo de atributos uma vez, na inicialização. Uma nova versão do catálogo chega a um contêiner na próxima reinicialização dele. Reiniciar os contêineres um de cada vez mantém o serviço disponível.

Backups

O seu banco de dados guarda a inteligência a partir da qual data.ndocs é calculado. Faça backup com as suas próprias ferramentas e teste as restaurações. Perder o banco de dados significa perder a inteligência, e ela não pode ser reconstruída.