配置种子
在文件中声明管理对象
面向通过 git 进行部署的管理员:在文件中声明管理对象,以便在空数据库上重建实例。
涵盖的内容
将 CONFIG_SEED_PATH 设为一个 YAML 文件,AnsibleForms 会在启动时应用它。该文件 声明以前只存在于数据库中的对象:
| 部分 | 声明的内容 |
|---|---|
runners | 作业的运行位置:RTE、AWX / AAP / Ascender、Semaphore、Rundeck、Jenkins |
secret_stores | 密钥库(HashiCorp Vault 等) |
credentials | 凭据 |
databases | 表单查询的数据库及其凭据,从 7.5.0 起 |
oauth2 | SSO 提供商:Entra ID 和 OIDC |
repositories | Git 仓库 |
syslog_servers | 接收服务器日志和审计条目的 syslog 服务器 |
notification_channels | 用于通知的邮件服务器、Slack、Teams、Telegram 和 webhook |
labels | 页眉徽标旁的标签,从 7.3.0 起 |
ldap | LDAP 配置 |
settings | 公共 URL,以及没有活动邮件通道时使用的邮件设置 |
chat | 聊天助手的模型提供商 |
awx | 自 7 起已弃用,将在 8 中移除:请使用 type: awx 的 runners |
7 之前编写的种子仍然有效:其 awx 部分的每一项都会作为类型为 awx 的运行器应用,日志 会在每次应用时发出警告。在升级到 8 之前,请将这些项移到 runners 下并设置 type: awx。
种子与 config.yaml 不同,后者保存类别、角色和常量, 并有自己的 CONFIG_PATH。两者是有意分开的: 保存 config.yaml 的仓库是种子所声明的对象之一,因此种子 不能放在该仓库中。
用户和组不在其中:它们来自 LDAP 或 SSO,第一个管理员则来自 ADMIN_USERNAME / ADMIN_PASSWORD。
本节内容
每个主题都有自己的页面:
| 页面 | 内容 |
|---|---|
| 示例 | 一个完整的种子文件,逐部分说明 |
| 托管对象 | 种子如何拥有它列出的对象,以及它如何避免包含密钥 |
| 重新加载与启动 | 无需重启即可修改文件,以及启动时会发生什么 |
| Kubernetes | 从 ConfigMap 和 Secret 部署 AnsibleForms |
| 编辑与审计 | 锁定设置页面,以及审计日志记录的内容 |