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 中使用自定义镜像时遇到权限不够的问题

#在 Tekton 中使用自定义镜像时遇到容器创建失败的问题

#目录

#问题描述

在 Tekton 流水线中,使用产品默认提供的镜像可以正常执行,但使用用户自定义镜像时可能会遇到 TaskRun 执行失败的问题。

#错误表现

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

    $ kubectl get taskruns -n ${namespace} ${taskrun_name}
    NAME                     SUCCEEDED   REASON                       STARTTIME   COMPLETIONTIME
    hello-c7pnj-run-script   False       CreateContainerConfigError   9m43s
  2. TaskRun 事件中显示错误信息:

    Failed: Failed to create pod due to config error
  3. 相关 Pod 事件中显示错误信息:

    Failed: Error: container's runAsUser breaks non-root policy

#根因分析

此类问题通常由以下两个原因导致:

  1. 镜像本身存在问题。
  2. 镜像与 Task 的配置不兼容。

#问题排查

如果该问题仅在使用自定义镜像时出现,建议按以下步骤排查:

  1. 验证镜像本身是否存在问题:

    $ docker run -it --rm ${registry} ${cmd}
  2. 检查 Task 配置与镜像的兼容性:

    • 检查 Task 是否配置了 runAsNonRoot: true。
    • 检查镜像默认用户是否为 root 或非数字编号的用户 ID。

示例 Task 配置:

apiVersion: tekton.dev/v1
kind: Task
metadata:
  name: foo
spec:
  steps:
    - name: bar
      securityContext:
        runAsNonRoot: true

示例 Dockerfile 配置:

USER root

示例检查镜像默认用户

$ docker run -it --rm ${registry} id

# 表明镜像默认用户为 root
uid=0(root) gid=0(root) groups=0(root)

#解决方案

#方案一:调整镜像构建配置,设置默认用户为非 root 用户

#前提条件

  • 具备重新构建镜像的环境和权限。

#操作步骤

参考 调整 Dockerfile 构建适用于 Task 的自定义镜像 文档,调整 Dockerfile 的配置。

#方案二:修改 TaskRun 或 PipelineRun 的运行配置

#前提条件

  • 具备修改 TaskRun 或 PipelineRun 的权限。

#操作步骤

  1. 单独执行 TaskRun 时添加配置:

    apiVersion: tekton.dev/v1
    kind: TaskRun
    metadata:
      name: foo
    spec:
      taskRef:
        name: foo
      podTemplate:
        securityContext:
          runAsUser: 65532
  2. 执行 PipelineRun 时添加配置:

    # 方式一:为所有 Task 添加配置
    apiVersion: tekton.dev/v1
    kind: PipelineRun
    spec:
      taskRunTemplate:
        podTemplate:
          securityContext:
            runAsUser: 65532
    
    # 方式二:为特定 Task 添加配置
    apiVersion: tekton.dev/v1
    kind: PipelineRun
    spec:
      taskRunSpecs:
        # 该 pipelineTaskName 为 Pipeline 中定义的 Task 名称
        - pipelineTaskName: example-git-clone
          podTemplate:
            securityContext:
              runAsUser: 65532
              fsGroup: 65532

#方案三:修改全局 Tekton 配置

#前提条件

  • 具备集群操作权限。
  • 具备 TektonConfig 资源的修改权限。
  • 注意:此配置会影响所有 Task。

#操作步骤

  1. 修改 TektonConfig 资源: 增加如下的 spec.pipeline.default-pod-template 配置:

    apiVersion: config.tekton.dev/v1beta1
    kind: TektonConfig
    metadata:
      name: config
    spec:
      pipeline:
        default-pod-template: |
          securityContext:
            runAsUser: 65532
  2. 验证配置是否生效:

    $ kubectl get configmap -n tekton-pipelines config-defaults -o yaml | grep 'default-pod-template: |' -A2
    
    # 预期输出
    default-pod-template: |
      securityContext:
        runAsUser: 65532

#方案四:修改 Task 定义

#前提条件

  • 具备修改 Task 的权限。
  • 注意:此配置会影响所有使用到该 Task 的 TaskRun 或 PipelineRun。

#操作步骤

  1. 方式一:移除 runAsNonRoot 配置:

    apiVersion: tekton.dev/v1
    kind: Task
    metadata:
      name: foo
    spec:
      steps:
        - name: bar
          securityContext:
            # 不限制容器必须以非 root 用户运行
            # runAsNonRoot: true
  2. 方式二:添加 runAsUser 配置:

    apiVersion: tekton.dev/v1
    kind: Task
    metadata:
      name: foo
    spec:
      steps:
        - name: bar
          securityContext:
            # 设置容器以非 root 用户运行
            runAsNonRoot: true
            runAsUser: 65532

#预防错误

  1. 镜像构建

    • 优先使用非 root 用户构建镜像。
    • 统一使用 UID 65532 作为非 root 用户。
    • 确保应用程序能够以非 root 用户正常运行。
  2. Task 配置

    • 根据安全需求决定是否启用 runAsNonRoot。
    • 如需启用,按需配置 runAsUser。
  3. 权限管理

    • 遵循最小权限原则。
    • 提前规划好目录权限。
    • 定期审查权限配置。

#相关内容

  • 调整 Dockerfile 构建适用于 Task 的自定义镜像
  • Dockerfile 官方文档
  • Dockerfile 最佳实践