logo
Alauda DevOps Pipelines Docs
English
简体中文
English
简体中文
logo
Alauda DevOps Pipelines Docs
导航

概览

介绍
架构
快速开始
生命周期策略
发版日志
特性概述

触发器

介绍
架构

核心概念

Tekton Triggers 核心概念
EventListener
触发器
Interceptor
TriggerBinding
TriggerTemplate
快速开始

实用指南

设置事件监听器
使用 GitLab 事件触发器
创建 TriggerTemplate

问题处理

Pipeline 未被自动触发
permissions

概念

TektonConfig
TektonPipeline
安装

升级

升级路径
升级 Alauda DevOps Pipelines Operator

配置

调整子组件的可选配置项
配置流水线组件的资源配额
Pod 模板配置指南
定期清理 TaskRun 和 PipelineRun 资源

How To

通过 TektonConfig 在 global 集群中部署 tekton-pipelines

管道

介绍
架构

概念

任务
TaskRuns
流水线
PipelineRuns
StepActions
解析器
工作空间
Pod 模板
快速开始

实用指南

调整 Dockerfile 构建适用于 Task 的自定义镜像
Specifying remote pipelines using hub resolvers
Specifying remote tasks using hub resolvers
使用 java-image-build-scan-deploy 管道

故障排查

在 Tekton 中使用自定义镜像时遇到容器创建失败的问题
在 run-script Task 中使用自定义镜像时遇到权限不够的问题
在 Tekton 中遇到无法使用多个基于 PVC 的工作区的问题
权限

结果

介绍
架构

核心概念

核心概念
深入理解 Tekton Results
快速开始
permissions

配置

数据库配置

供应链安全

介绍
架构

概念

核心概念
了解 Tekton Chains

快速开始

Getting Started
签名证明

实用指南

生成镜像签名并验证镜像完整性
构建系统溯源验证
源代码仓库验证
漏洞扫描和验证
Base Image and SBOM Verification
License Compliance Verification
Keyless Signing Verification

配置

链配置
链配置
Authentication for Chains
签名密钥配置

Hub

引言
架构

核心概念

概念
理解 Tekton Hub
权限描述

API Reference

介绍

Kubernetes APIs

Operator

TektonConfig [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
TektonPipeline [operator.tekton.dev/v1alpha1]
TektonTrigger [operator.tekton.dev/v1alpha1]
TektonChain [operator.tekton.dev/v1alpha1]
TektonHub [operator.tekton.dev/v1alpha1]
TektonResult [operator.tekton.dev/v1alpha1]
TektonInstallerSet [operator.tekton.dev/v1alpha1]
OpenShift Pipelines as Code [operator.tekton.dev/v1alpha1]

管道

Pipeline [tekton.dev/v1]
任务 [tekton.dev/v1]
PipelineRun [tekton.dev/v1]
TaskRun [tekton.dev/v1]
集群任务 [tekton.dev/v1]
运行 [tekton.dev/v1]
CustomRun [tekton.dev/v1]
StepAction [tekton.dev/v1]
VerificationPolicy [tekton.dev/v1alpha1]
ResolutionRequest [resolution.tekton.dev/v1beta1]

Triggers

触发器 [triggers.tekton.dev/v1beta1]
TriggerTemplate [triggers.tekton.dev/v1beta1]
EventListener [triggers.tekton.dev/v1beta1]
触发绑定 [triggers.tekton.dev/v1beta1]
拦截器 [triggers.tekton.dev/v1alpha1]
集群触发器绑定 [triggers.tekton.dev/v1beta1]
集群拦截器 [triggers.tekton.dev/v1alpha1]

高级 API

Results

Introduction to API Usage
Results 列表
结果详情
结果记录列表
Result logs 列表
📝 在 GitHub 上编辑此页
上一页配置
下一页供应链安全

#Database Configuration

本文档介绍了如何配置 Tekton Results 所需的数据库。

NOTE

当前,我们仅支持连接外部数据库。原因如下:

  • 内置数据库缺少备份、监控、高可用及高级管理等生产环境必需功能,仅提供基础的存储和查询功能,不适合生产环境使用。
  • 外部数据库提供了自动备份、性能监控、弹性扩展和专业支持等企业级功能,适合生产环境部署。
  • 我们的 Data Services 产品已提供完善的 PostgreSQL 管理能力。

#目录

#前提条件

#集群要求

  • 集群中必须安装 Tekton Operator。

#数据库要求

版本:

  • PostgreSQL 12 及以上版本
  • 推荐使用较新版本以获得更长的维护支持

数据库配置:

  • 数据库必须已存在
  • 数据库应为空(Tekton Results 会自动创建所需的表结构)
  • 确保数据库用户具有创建表的权限

创建数据库命令:

CREATE DATABASE tekton_results;

#配置概述

Tekton Results 支持使用外部 PostgreSQL 数据库。配置分为两部分:

  1. 数据库凭据(用户名和密码)存储在 Kubernetes Secret 中
  2. 数据库连接参数(主机、端口、数据库名、SSL 设置)配置在 TektonResult 自定义资源中

#配置参数参考

字段说明默认值是否必填
is_external_db是否使用外部数据库false是(外部数据库需设置为 true)
db_host数据库主机地址localhost是
db_port数据库端口5432是
db_name数据库名称tekton-results是
db_sslmodeSSL 连接模式disable否
db_sslrootcertSSL 根证书路径空否(使用 SSL 时必填)
secret_name存储数据库凭据的 Secret 名称空是

db_sslmode 的有效选项说明请参考 https://www.postgresql.org/docs/current/libpq-ssl.html#LIBPQ-SSL-PROTECTION。

#基础配置

以下示例展示了无 SSL 的基础外部数据库配置步骤:

#1. 创建数据库凭据

Secret 中必填字段:

字段说明示例值
POSTGRES_USER数据库用户名result
POSTGRES_PASSWORD数据库密码your_secure_password

创建 Secret 命令:

kubectl create secret generic tekton-results-postgres \
  --namespace="tekton-pipelines" \
  --from-literal=POSTGRES_USER=result \
  --from-literal=POSTGRES_PASSWORD=your_secure_password

Secret YAML 示例:

apiVersion: v1
kind: Secret
type: Opaque
metadata:
  name: tekton-results-postgres
data:
  POSTGRES_USER: <base64 encoded username>
  POSTGRES_PASSWORD: <base64 encoded password>

#2. 配置 TektonResult 资源

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonResult
metadata:
  name: result
spec:
  is_external_db: true
  db_host: your-postgres-host.example.com
  db_port: 5432
  db_name: tekton_results
  db_sslmode: allow
  secret_name: tekton-results-postgres
TIP

本文档仅列出了数据库相关配置字段。完整字段列表请参见 快速开始。

#3. 验证配置

kubectl get tektonresults.operator.tekton.dev result
kubectl get pods -n tekton-pipelines -l app.kubernetes.io/name=tekton-results-api
TIP

本快速开始仅涵盖基础配置。生产环境中如需使用 SSL、高级安全或自定义 CA 证书,请参见下方的高级配置章节。

#高级配置

#SSL 配置

当需要安全的数据库连接时,可以配置 SSL 相关参数:

SSL 模式选择指南:

环境推荐模式安全级别说明
开发disable无不加密
测试require基础加密连接
生产verify-full最高加密且验证证书

SSL 模式说明

sslmode防止窃听防止中间人攻击说明
disable否否不关心安全性,不想承担加密开销。
allow可能否不关心安全性,但如果服务器要求加密则接受加密。
prefer可能否不关心加密,但如果服务器支持则使用加密。
require是否希望数据加密,接受开销,信任网络确保连接到目标服务器。
verify-ca是取决于 CA 策略希望数据加密,接受开销,确保连接到受信任的服务器。
verify-full是是希望数据加密,接受开销,确保连接到受信任且指定的服务器。

verify-ca 和 verify-full 的区别取决于根 CA 的策略。若使用公共 CA,verify-ca 允许连接到任何由该 CA 注册的服务器,此时应使用 verify-full。若使用本地 CA 或自签名证书,verify-ca 通常已足够。

WARNING

重要提示: 使用 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

假设 CA 证书文件名为 root.crt,执行:

kubectl create configmap db-root-crt -n tekton-pipelines --from-file ca.crt=./root.crt

#步骤 2:配置 TektonResult 资源挂载卷

为使容器内可访问 CA 证书,需要在 TektonResult 资源中通过 options 配置挂载 ConfigMap:

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonResult
metadata:
  name: result
spec:
  is_external_db: true
  # 数据库连接配置
  db_host: your-postgres-host.example.com
  db_port: 5432
  db_name: tekton_results
  db_sslmode: verify-full
  db_sslrootcert: /etc/tls/db/ca.crt
  # Secret 配置
  secret_name: tekton-results-postgres
  # 挂载 CA 证书的选项
  options:
    deployments:
      tekton-results-api:
        spec:
          template:
            spec:
              containers:
                - name: api
                  volumeMounts:
                    - mountPath: /etc/tls/db
                      name: postgredb-tls-ca
                      readOnly: true
              volumes:
                - configMap:
                    name: db-root-crt
                  name: postgredb-tls-ca
      tekton-results-retention-policy-agent:
        spec:
          template:
            spec:
              containers:
                - name: retention-policy-agent
                  volumeMounts:
                    - mountPath: /etc/tls/db
                      name: postgredb-tls-ca
                      readOnly: true
              volumes:
                - configMap:
                    name: db-root-crt
                  name: postgredb-tls-ca

配置说明:

  • CA 证书将挂载到容器的 /etc/tls/db/ca.crt
  • db_sslrootcert 设置为 /etc/tls/db/ca.crt,与挂载路径对应
  • API 服务和保留策略智能体均可访问该证书

#操作

#更新数据库配置

修改数据库配置后,需重启 Tekton Results 组件以使配置生效。

方案一:重启指定 Deployment

# 重启 API 服务
kubectl delete pod -n tekton-pipelines -l app.kubernetes.io/name=tekton-results-api

# 重启保留策略智能体
kubectl delete pod -n tekton-pipelines -l app.kubernetes.io/name=tekton-results-retention-policy-agent

方案二:重新创建 TektonResult 资源

# 获取当前 TektonResult 资源并强制替换
kubectl get tektonresults.operator.tekton.dev result -o yaml | kubectl replace --force -f -

验证变更:

# 查看 Pod 状态确认新配置生效
kubectl get pods -n tekton-pipelines -l app.kubernetes.io/name=tekton-results-api
kubectl get pods -n tekton-pipelines -l app.kubernetes.io/name=tekton-results-retention-policy-agent
WARNING

如果更新了 db_sslmode 字段,可能需要重新创建 TektonResult 资源以使变更生效。

kubectl get tektonresults.operator.tekton.dev result -o yaml | kubectl replace --force -f -

#故障排查

#常见问题

  1. 连接被拒绝:

    • 检查数据库主机和端口是否正确
    • 检查网络连通性
    • 确认数据库服务是否运行
  2. 认证失败:

    • 核实 Secret 中的用户名和密码
    • 检查数据库用户权限
  3. SSL 证书错误:

    • 确认 CA 证书是否正确挂载
    • 检查 SSL 模式配置
    • 确保证书路径与挂载路径一致

#验证命令

# 查看 TektonResult 状态
kubectl get tektonresults.operator.tekton.dev result -o yaml

# 查看 Pod 日志
kubectl logs -n tekton-pipelines -l app.kubernetes.io/name=tekton-results-api

# 验证 Secret 是否存在
kubectl get secret tekton-results-postgres -n tekton-pipelines

#使用 Data Services 中的 PostgreSQL

Data Services 支持部署可供 Tekton Results 使用的 PostgreSQL 实例。创建 PostgreSQL 实例时,请注意以下重要要求:

  1. 选择与 Tekton Results 版本匹配的 PostgreSQL 版本,例如 PostgreSQL 12.x 及以上。
  2. 存储配额不得低于 5Gi。

创建 PostgreSQL 实例时,会自动生成包含连接信息的 Secret。该 Secret 资源可通过标签 middleware.instance/type: PostgreSQL 过滤:

kubectl get secret -n <ns-of-postgresql-instance> -l middleware.instance/type=PostgreSQL | grep -E '^postgres'
INFO

该 Secret 包含 host、port、username、password 信息。你需要基于此 Secret 补充 database 信息,并在 Tekton Results 实例所在命名空间创建新的 Secret。

如需设置 sslmode,请在 TektonResult 中将 db_sslmode 设置为 allow 或 prefer 等。

更多 PostgreSQL 部署参数和要求,请参考 。