Execute o Human Plugin na sua infraestrutura

Um contêiner e um banco de dados PostgreSQL na sua rede, e você está conectado à Unico.

Markdown

Requisitos

Requisito	Detalhe
Runtime de contêiner	Docker, Docker Compose ou Kubernetes. A imagem é construída para linux/amd64 e linux/arm64 e roda como não-root
PostgreSQL	Versão 16 ou posterior. Um banco de dados usado apenas pelo Human Plugin, acessível com usuário e senha. SSL obrigatório por padrão
HTTPS de saída	Para a Unico. Veja Rede e segurança
Entrada	Porta 8080, HTTP simples, somente a partir do seu back-end
Segredos	Sua chave de acesso e a senha do banco de dados

Requisitos de hardware

O mínimo para executar o Human Plugin com até 1.500 transações por minuto, com selfies de até 800 KB.

Human Plugin

Recurso	Mínimo
CPU	1 vCPU por réplica
Memória	1 GB por réplica

Para mais volume, adicione uma réplica a cada 1.500 transações por minuto. Também sugerimos executar mais de uma réplica, para que o Human Plugin continue disponível enquanto uma delas reinicia.

PostgreSQL

Recurso	Mínimo
Versão	16
CPU	2 vCPU
Memória	4 GB
Disco	SSD

Para estimar o espaço em disco, conte cerca de 1,7 KB por processo × processos por dia × os dias que você retém, mais 30%.

Rede

HTTPS de saída (porta 443) para a Unico. Veja Rede e segurança.

A imagem

O Human Plugin é publicado como pkg.unico.run/human-plugin-api:latest. Execute sempre a tag latest, que é a versão atual. Baixe-a com as credenciais do registry (usuário e token) que a Unico fornece. Veja Pré-requisitos e acesso.

Ordem da implantação

1. Crie o banco de dados dedicado e uma role para o Human Plugin.
2. Defina a configuração, com os segredos vindos do seu cofre de segredos.
3. Inicie o contêiner com Docker Compose ou Kubernetes, com um stop timeout de pelo menos 60 segundos.
4. Aguarde GET /health/ready responder 200 antes de direcionar tráfego. Veja Saúde e monitoramento.
5. Restrinja o acesso ao seu back-end. Veja Rede e segurança.
6. Execute nele a requisição de criação do Quickstart.

O que acontece na inicialização

O Human Plugin baixa o catálogo de atributos, conecta-se ao PostgreSQL e prepara as suas tabelas, e então abre a porta. Ele para com um erro, antes de começar a escutar, quando:

• uma configuração obrigatória está ausente ou é inválida;
• o catálogo de atributos não pode ser baixado;
• o PostgreSQL está inacessível, ou a role não consegue criar tabelas.

O log informa o motivo. Veja Solução de problemas.

Várias instâncias

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. Contêineres que iniciam ao mesmo tempo se coordenam pelo banco de dados, então você pode implantar réplicas juntas.

Indo para produção

• Mantenha o stop timeout em 60 segundos ou mais.
• Direcione tráfego a um contêiner somente depois que /health/ready responder 200.
• Nunca exponha o Human Plugin fora da sua rede privada.
• Faça backup do banco de dados: ele guarda a sua inteligência. Veja Operação.