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 上编辑此页
上一页在 run-script Task 中使用自定义镜像时遇到权限不够的问题
下一页权限

#Unable to Use Multiple PVC Workspaces in Tekton

#目录

#问题描述

在 Tekton 中运行带有**多个基于 PersistentVolumeClaim(PVC)**的 workspaces 的 PipelineRun 或 TaskRun 时,执行会失败,并出现类似“more than one PersistentVolumeClaim is bound”的错误。

即使所有 PVC 都有效且声明正确,也会发生此问题。

#错误表现

  1. TaskRun 执行失败,状态为 False,原因是 TaskRunValidationFailed:

    $ kubectl get taskruns -n ${namespace} ${taskrun_name}
    NAME                     SUCCEEDED   REASON                       STARTTIME   COMPLETIONTIME
    demo-hbfhd-foo           False       TaskRunValidationFailed      59s         59s
  2. TaskRun 事件显示错误信息:

    [User error] more than one PersistentVolumeClaim is bound

#根因分析

默认情况下,Tekton 启用了Affinity Assistant功能,帮助将 TaskRun pod 与其 PVC 共同调度到同一节点。这对于具有 ReadWriteOnce 访问模式的卷尤其有用。

但是,当启用 Affinity Assistant 时:

  • 每个 TaskRun 仅限于使用单个基于 PVC 的工作区。
  • 绑定多个 PVC 会触发校验错误,阻止 TaskRun 运行。

此限制是为了避免复杂的调度问题和节点亲和性冲突。

#故障排查

若要允许 TaskRun 或 PipelineRun 使用多个基于 PVC 的工作区,必须通过更新 Tekton 特性标志禁用 Affinity Assistant。

建议按如下步骤排查:

  1. 编辑 TektonConfig 资源,设置 spec.pipeline.disable-affinity-assistant,示例如下:

    apiVersion: operator.tekton.dev/v1alpha1
    kind: TektonConfig
    spec:
      pipeline:
        disable-affinity-assistant: true

    提示:disable-affinity-assistant 特性标志即将被移除,Affinity Assistant 模式将仅由 coschedule 特性标志控制。

  2. feature-flags ConfigMap 会自动更新。

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: feature-flags
      namespace: tekton-pipelines
    data:
      disable-affinity-assistant: "true"
  3. 无需手动重启组件,变更会自动生效。

#相关内容

  • Tekton Affinity Assistant
  • Tekton Workspaces