Um contêiner e um banco de dados PostgreSQL na sua rede, e você está conectado à Unico.
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
- Crie o banco de dados dedicado e uma role para o Human Plugin.
- Defina a configuração, com os segredos vindos do seu cofre de segredos.
- Inicie o contêiner com Docker Compose ou Kubernetes, com um stop timeout de pelo menos 60 segundos.
- Aguarde
GET /health/readyresponder200antes de direcionar tráfego. Veja Saúde e monitoramento. - Restrinja o acesso ao seu back-end. Veja Rede e segurança.
- 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/readyresponder200. - 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.