---
title: Operação
description: Atualização para a imagem mais recente, rotação de credenciais, comportamento no desligamento, escalabilidade e backups do banco de dados de uma instalação do Human Plugin.
canonical: https://developer.unico.io/pt-BR/human-plugin/self-hosting/operations
locale: pt-BR
generated_by: markdown-export
---

# Operação

Como operar o Human Plugin no dia a dia.

## 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](/pt-BR/human-plugin/self-hosting/overview#hardware-requirements).

## O catálogo de atributos

O Human Plugin baixa o [catálogo de atributos](/pt-BR/human-plugin/additional-resources/attribute-catalog) 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.