---
title: Execute o Human Plugin na sua infraestrutura
description: O que envolve executar o Human Plugin — um contêiner e o seu banco de dados PostgreSQL — e a ordem de uma implantação.
canonical: https://developer.unico.io/pt-BR/human-plugin/self-hosting/overview
locale: pt-BR
generated_by: markdown-export
---

# Execute o Human Plugin na sua infraestrutura

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

```mermaid
flowchart LR
  A[Your back-end] --> B[Human Plugin container]
  B --> C[(Your PostgreSQL, dedicated)]
```

## 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](/pt-BR/human-plugin/self-hosting/networking-and-security) |
| Entrada | Porta `8080`, HTTP simples, somente a partir do seu back-end |
| Segredos | Sua chave de acesso e a senha do banco de dados |

<a id="hardware-requirements"></a>

## 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](/pt-BR/human-plugin/self-hosting/networking-and-security).

## 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](/pt-BR/human-plugin/get-started/prerequisites).

## Ordem da implantação

1. Crie o banco de dados dedicado e uma role para o Human Plugin.
2. Defina a [configuração](/pt-BR/human-plugin/self-hosting/configuration), com os segredos vindos do seu cofre de segredos.
3. Inicie o contêiner com [Docker Compose](/pt-BR/human-plugin/self-hosting/docker-compose) ou [Kubernetes](/pt-BR/human-plugin/self-hosting/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](/pt-BR/human-plugin/self-hosting/health-and-monitoring).
5. Restrinja o acesso ao seu back-end. Veja [Rede e segurança](/pt-BR/human-plugin/self-hosting/networking-and-security).
6. Execute nele a requisição de criação do [Quickstart](/pt-BR/human-plugin/get-started/quickstart#3-create-a-process).

## O que acontece na inicialização

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

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