二进制与独立 PostgreSQL 手动部署
如果你的生产环境已有高可用 PostgreSQL 集群(云 RDS / Patroni / 自建主从),不希望通过 Docker Compose 运行内置数据库,可以采用单二进制 yearning + systemd 方式直接部署。
1. 准备 PostgreSQL 14–18 数据库与最小权限角色
生产环境(environment: production)强制校验最小权限角色隔离:运行时连接账号 yearning_app 不得为超级用户、不得拥有 CREATEDB,且不能使用 postgres 或迁移账号。
以 PostgreSQL 超级用户连接集群,依次创建库与角色:
2. 生成六用途 AEAD 密钥环(keyring.json)
Yearning v4 使用分域密钥环保护凭据、工单 SQL、游标与脱敏映射。密钥文件权限必须严格限制为 0400 或 0440(更宽权限启动会直接失败关闭)。
deployment_id
deployment_id 会参与每一条密文的 AES-256-GCM AAD 校验,一旦投入使用不可更改;请立即将 keyring.json 加密备份到企业 KMS / 保险库。
3. 执行版本化 Schema 迁移与角色授权
从 GitHub Releases 下载对应架构的发行包(含 yearning 二进制、db/migrations/、db/roles/grants.sql 与 api/contracts/postgresql-column-catalog.json)解压至 /opt/yearning/。
第 1 步:准备迁移配置文件 migrate-schema.json
第 2 步:建表 + 校验列目录 + 执行最小权限授权
4. 编写运行时配置文件 /etc/yearning/config.yaml
配置解析使用严格模式(出现未知字段直接启动报错),以下字段均与后端源码 backend/internal/config/config.go 一一对应:
设置文件权限与一次性初始管理员密码文件(至少 12 位,仅在 users 表为空时生效,引导完可删除该文件):
5. 配置 systemd 托管服务
启动并核验健康探针:
看到 HTTP 200 后,按 Docker Compose 指南中的 Nginx 配置 挂载 HTTPS 反代即可对外服务。