跳转到主要内容
在您的基础设施中运行 Human Plugin

在您的网络中部署一个容器和一个 PostgreSQL 数据库，即可连接到 Unico。

Markdown

要求​

要求详情
容器运行时Docker、Docker Compose 或 Kubernetes。镜像为 linux/amd64 和 linux/arm64 构建，并以非 root 用户运行
PostgreSQL16 或更高版本。仅供 Human Plugin 使用的数据库，可通过用户名和密码访问。默认要求 SSL
出站 HTTPS访问 Unico。参见网络与安全
入站端口 8080，纯 HTTP，仅来自您的后端
密钥您的访问密钥和数据库密码

硬件要求​

以下是运行 Human Plugin 的最低配置，支持最高 每分钟 1,500 笔事务，自拍照最大 800 KB。

Human Plugin​

资源最低配置
CPU每个副本 1 vCPU
内存每个副本 1 GB

如需更高的处理量，每 1,500 笔事务/分钟增加一个副本。我们还建议运行多个副本，以便在其中一个重启时 Human Plugin 仍保持可用。

PostgreSQL​

资源最低配置
版本16
CPU2 vCPU
内存4 GB
磁盘SSD

估算磁盘空间时，按每个流程约 1.7 KB × 每天的流程数 × 保留天数，再加 30%。

网络​

出站 HTTPS（端口 443）访问 Unico。参见网络与安全。

镜像​

Human Plugin 发布为 pkg.unico.run/human-plugin-api:latest。请始终运行 latest 标签，即当前版本。使用 Unico 提供的镜像仓库凭据（用户名和令牌）拉取。参见前提条件与访问权限。

部署顺序​

  1. 创建专用数据库以及供 Human Plugin 使用的角色。
  2. 设置配置，密钥来自您的密钥存储。
  3. 使用 Docker Compose 或 Kubernetes 启动容器，停止超时至少 60 秒。
  4. 等待 GET /health/ready 返回 200 后再路由流量。参见健康检查与监控。
  5. 将访问限制为仅您的后端可用。参见网络与安全。
  6. 对其运行快速入门中的创建请求。

启动时会发生什么​

Human Plugin 会下载属性目录，连接到 PostgreSQL 并准备其表，然后打开端口。在以下情况下，它会在开始监听之前报错并停止：

  • 缺少必需的设置，或设置无效；
  • 无法下载属性目录；
  • 无法连接到 PostgreSQL，或该角色无法创建表。

日志中会说明原因。参见故障排查。

多个实例​

Human Plugin 不在内存中保存请求状态，因此多个容器可以共享同一个数据库。同时启动的容器会通过数据库进行协调，因此您可以一次性滚动发布多个副本。

上线生产​

  • 将停止超时保持在 60 秒或以上。
  • 仅在 /health/ready 返回 200 后才向容器路由流量。
  • 切勿将 Human Plugin 暴露在您的私有网络之外。
  • 备份数据库：其中保存着您的 intelligence 数据。参见运维。
最后更新 于