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 上编辑此页
上一页升级
下一页升级 Alauda DevOps Pipelines Operator

#升级路径

NOTE

重要提示

本文档提供了 Alauda DevOps Pipelines operator 的升级路径原则及支持的版本兼容性。 有关详细的升级说明,请参阅 升级 Alauda DevOps Pipelines Operator。

#目录

#概述

Alauda DevOps Pipelines operator 遵循特定的升级路径原则,以确保版本切换过程中的兼容性和稳定性。

#版本类型

  • LTS(长期支持)版本:4.0.x、4.2.x、4.6.x、4.10.x - 推荐用于生产环境
  • 非LTS(短期)版本:4.1.x、4.3.x、4.5.x、4.7.x、4.9.x - 用于提前体验新功能

#升级原则

  • 支持在 LTS 版本之间升级,最长支持跳过最多两个中间 LTS 版本的升级路径。例如:
    • 直接 LTS 升级:4.0.x (LTS) → 4.2.x (LTS)
    • 最长支持升级范围:4.0.x (LTS) → 4.10.x (LTS)(跳过 4.2.x (LTS) 和 4.6.x (LTS))
  • 非LTS 版本仅支持升级到下一个紧邻的 LTS 版本。例如:
    • 4.3.x → 4.6.x (LTS) 支持
    • 4.3.x → 4.10.x (LTS) 不支持
  • 版本兼容性:同一小版本内的补丁版本完全兼容
  • 组件一致性:所有 Tekton 组件需同时升级以保持兼容性

#升级路径

#Alauda DevOps Pipelines v4.1.0

此升级路径已在 Alauda DevOps Pipelines Operator 版本 v4.1.0 和 ACP 版本 4.0.3(测试时最新的 LTS 补丁版本)下测试通过

Channel 版本ACP 版本Kubernetes 版本
pipelines-4.04.0.31.31.6

#升级前提条件

在开始升级之前,请确保以下条件:

  1. 版本兼容性:当前版本处于支持的升级路径范围内。
  2. 组件健康状态:所有 Tekton 组件均处于 Ready 状态。
  3. 资源充足:集群有足够资源支持升级过程。

#升级路径指南

#LTS 到 LTS 的升级路径

推荐生产环境在长期支持(LTS)版本之间进行升级。支持以下标准及扩展升级路径:

  • 主要路径:前一个 LTS → 当前 LTS

    • 说明:从紧邻的前一个 LTS 版本直接升级。
    • 测试状态:所有补丁版本均经过测试;最新补丁版本进行全面回归测试。
    • 示例:4.0.x (LTS) → 4.2.x (LTS)
  • 扩展路径:最多跳过两个 LTS 版本 → 当前 LTS

    • 说明:直接跳过最多两个中间 LTS 版本的升级路径。
    • 测试状态:所有补丁版本均经过测试;最新补丁版本通过扩展测试验证。
    • 示例:4.0.x (LTS) → 4.10.x (LTS)(跳过 4.2.x (LTS) 和 4.6.x (LTS))
  • 维护路径:非LTS(仍在维护中)→ 当前 LTS

    • 说明:从仍处于维护期的非LTS版本直接升级。
    • 测试状态:测试范围有限;理论上支持。
    • 适用场景:适合希望直接从非LTS 环境升级且保持支持范围内的团队。

#升级到非LTS 版本

当升级到非LTS 版本时,针对需要更快获取新功能的环境,提供以下路径:

  • 主要路径:前一个 LTS → 当前非LTS

    • 说明:从最新 LTS 版本直接升级。
    • 测试状态:所有补丁版本均经过测试;最新补丁版本进行全面回归测试。
    • 示例:4.0.x (LTS) → 4.1.x (非LTS)
  • 扩展路径:最多跳过两个 LTS 版本 → 当前非LTS

    • 说明:直接跳过最多两个中间 LTS 版本的升级路径。
    • 测试状态:所有补丁版本均经过测试;最新补丁版本进行全面回归测试。
    • 适用场景:适合希望减少升级跳数的用户。
    • 示例:4.0.x (LTS) → 4.7.x (非LTS)(跳过 4.2.x (LTS) 和 4.6.x (LTS))
  • 维护路径:非LTS(仍在维护中)→ 当前非LTS

    • 说明:针对仍处于支持期的非LTS版本的升级路径。
    • 测试状态:测试范围有限;理论上支持。
    • 适用场景:适合快速采用非LTS 新功能的团队。

#补丁级兼容性

  • 同一小版本内:补丁升级(例如 4.0.1 → 4.0.3)完全兼容。
  • 测试策略:同一小版本内所有补丁版本均支持升级。最新补丁版本进行全面回归测试,较早补丁版本测试有限。
  • 建议:为保证生产环境稳定,建议在进行任何大版本或小版本升级前,先升级至最新补丁版本。
  • 示例:虽然 4.0.1、4.0.2 和 4.0.3 都可升级到 4.1.x,但仅最新的 4.0.3 经过完整测试和验证。

#升级流程参考

有关完整的升级说明,包括分步操作、备份指导和故障排除:

  • 📘 通用升级指南:升级流程的全面文档。
  • 📝 release notes:版本特定的更新、破坏性变更及新功能。