数据库配置
本文档介绍如何配置 Tekton Results 所需的数据库。
目前,内置 PostgreSQL 数据库不受支持。必须为 Tekton Results 配置外部 PostgreSQL 数据库(is_external_db: true)。
我们的 Data Services 产品已提供全面的 PostgreSQL 管理功能。
目录
前提条件集群要求数据库要求配置概览配置参数参考基本配置1. 创建数据库凭据2. 配置 TektonConfig 资源3. 验证配置高级配置SSL 配置配置自定义 CA 证书步骤 1:创建包含 CA 证书的 ConfigMap步骤 2:使用卷挂载配置 TektonConfig操作更新数据库配置故障排除常见问题验证命令使用 Data Services 中的 PostgreSQL前提条件
集群要求
- 集群中必须已安装 Tekton Operator。
数据库要求
版本:
- PostgreSQL 12 或更高版本
- 建议使用较新版本,以获得更长的维护支持
数据库设置:
- 数据库必须已存在
- 数据库应为空(Tekton Results 将自动创建所需的表结构)
- 确保数据库用户具有创建表的权限
创建数据库命令:
配置概览
Tekton Results 支持使用外部 PostgreSQL 数据库。配置分为两部分:
- 数据库凭据(用户名和密码)存储在 Kubernetes Secrets 中
- 数据库连接参数(主机、端口、数据库名称、SSL 设置)配置在 TektonConfig 自定义资源的
spec.result下
配置参数参考
db_sslmode的有效选项请参阅此处:https://www.postgresql.org/docs/current/libpq-ssl.html#LIBPQ-SSL-PROTECTION。
基本配置
对于不使用 SSL 的基本外部数据库设置,请执行以下步骤:
1. 创建数据库凭据
Secret 中的必填字段:
创建 Secret 的命令:
Secret YAML 示例:
2. 配置 TektonConfig 资源
本文档仅列出与数据库相关的配置字段。有关完整字段列表,请参阅快速入门。
3. 验证配置
此快速入门仅介绍基本配置。对于使用 SSL、需要高级安全性或自定义 CA 证书的生产环境,请参阅下面的高级配置部分。
高级配置
SSL 配置
当需要安全的数据库连接时,可以配置 SSL 相关参数:
SSL 模式选择指南:
SSL 模式描述
verify-ca 和 verify-full 之间的差异取决于根 CA 的策略。如果使用公共 CA,verify-ca 允许连接到可能由其他人向该 CA 注册的服务器。在这种情况下,应始终使用 verify-full。如果使用本地 CA,甚至使用自签名证书,则使用 verify-ca 通常可以提供足够的保护。
重要:使用 SSL 模式 require、verify-ca 或 verify-full 时,必须提供用于签署数据库服务器证书的 CA 证书。如果未正确配置 CA 证书,Tekton Results 组件将无法启动。有关详细配置步骤,请参阅下面的配置自定义 CA 证书部分。
配置自定义 CA 证书
使用需要证书验证的 SSL 模式(require、verify-ca、verify-full)时,需要提供用于签署数据库服务器证书的 CA 证书。最常见的方法是将 CA 证书存储在 ConfigMap 中,并将其挂载到 Tekton Results Pod 中。
步骤 1:创建包含 CA 证书的 ConfigMap
如果有一个名为 root.crt 的 CA 证书文件,请创建 ConfigMap:
步骤 2:使用卷挂载配置 TektonConfig
为了让容器能够访问 CA 证书,需要在 spec.result 下为 TektonConfig 资源配置额外的 options,以挂载 ConfigMap:
使用此配置后:
- CA 证书将在容器中的
/etc/tls/db/ca.crt处可用 - 将
db_sslrootcert设置为/etc/tls/db/ca.crt,以匹配挂载路径 - API 服务器和保留策略智能体都可以访问 CA 证书
操作
更新数据库配置
修改数据库配置后,需要重启 Tekton Results 组件,变更才能生效。
选项 1:重启特定的 deployment
选项 2:重新创建 TektonConfig 资源
验证变更:
如果更新 db_sslmode 字段,可能需要重新创建 TektonConfig 资源,变更才能生效。
故障排除
常见问题
-
连接被拒绝:
- 验证数据库主机和端口
- 检查网络连接
- 确保数据库正在运行
-
身份验证失败:
- 验证 Secret 中的用户名和密码
- 检查数据库用户权限
-
SSL 证书错误:
- 验证 CA 证书是否已正确挂载
- 检查 SSL 模式配置
- 确保证书路径与挂载路径匹配
验证命令
使用 Data Services 中的 PostgreSQL
Data Services 支持部署可用于 Tekton Results 的 PostgreSQL 实例。创建 PostgreSQL 实例时,请考虑以下重要要求:
- 选择与 Tekton Results 版本匹配的 PostgreSQL 版本,例如可以选择 PostgreSQL 12.x 或更高版本。
- 存储配额不应小于 5Gi
创建 PostgreSQL 实例时,会自动生成一个包含连接信息的 Secret。可以使用标签 middleware.instance/type: PostgreSQL 筛选此 Secret 资源。
此 Secret 包含 host、port、username、password 信息。你需要根据此 Secret 补充 database 信息,并在 Tekton Results 实例所在的命名空间中创建一个新的 secret。
如果需要设置 sslmode,请在 TektonConfig spec.result 部分将 db_sslmode 设置为 allow 或 prefer 等。
有关更多 PostgreSQL 部署参数和要求,请参阅 PostgreSQL Deployment Documentation。