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 上编辑此页
上一页实用指南
下一页Specifying remote pipelines using hub resolvers

#调整 Dockerfile 构建适用于 Task 的自定义镜像

#目录

#功能简介

在 Tekton 中,为了增强安全性,Task 可能会配置 runAsNonRoot: true,这要求容器必须以非 root 用户运行。因此,在构建自定义镜像时,需要特别注意 Dockerfile 的配置,以确保镜像能够在这类 Task 中正常运行。

本文介绍如何调整 Dockerfile 来构建适用于 Task 的自定义镜像,重点关注用户权限的配置。

#使用场景

以下场景需要参考本文的操作指导:

  • 构建自定义镜像并在 Task 中使用
  • 现有镜像在 Task 中运行时出现权限相关错误
  • 确保镜像符合 Task 的安全要求

#前置条件

使用本功能前,需确保:

  • 具备 Docker 镜像构建环境
    • 可以使用平台本身的构建流水线
    • 如需使用社区/开源工具,需确保能访问外网或已准备好离线包
  • 了解基本的 Dockerfile 编写知识
    • 可以参考 Dockerfile 官方文档
    • 了解 Dockerfile 最佳实践
  • 一个 Dockerfile 文件及相关配置

#操作步骤

#1. 确认基础镜像

首先需要确认基础镜像的发行版本,不同发行版本创建用户的命令可能不同:

# 查看基础镜像的发行版本
$ docker run -it --rm ${registry} cat /etc/os-release

# 可能的输出示例
NAME="Alpine Linux"
# 或
NAME="Debian GNU/Linux"
# 或
NAME="Ubuntu"
# 或
NAME="CentOS Linux"

#2. 添加非 root 用户

在 Dockerfile 中添加非 root 用户(建议使用 UID 65532):

# 根据基础镜像选择对应的命令

# Alpine
RUN adduser -u 65532 -h /home/nonroot -D nonroot

# Debian
RUN adduser --home /home/nonroot --uid 65532 nonroot --disabled-password --gecos ""

# Ubuntu
RUN apt-get update && apt-get install -y adduser \
    && adduser --home /home/nonroot --uid 65532 nonroot --disabled-password --gecos ""

# CentOS
RUN groupadd -g 65532 nonroot && useradd -u 65532 -U -d /home/nonroot -m nonroot

#3. 为该用户添加必要的权限(可选)

如果需要使用该用户访问某些目录或文件,需要为该用户添加必要的权限。

# 将目录或文件的拥有者设置为 nonroot
RUN chown -R nonroot:nonroot /path/to/directory

# 或者将目录或文件的权限设置为 所有人可读写 或其他最小权限
RUN chmod -R a+rwx /path/to/directory

#4. 设置默认用户

在 Dockerfile 中设置默认用户(使用 UID 而不是用户名):

因为 Pods 配置了 runAsNonRoot 时,会检查用户 ID 是否为非 root 用户,而不是检查用户名。

# 设置默认用户为 nonroot(使用 UID)
USER 65532

#5. 验证镜像

构建完成后,验证镜像是否可以正常运行:

# 验证用户配置
$ docker run -it --rm ${registry} id

# 预期输出
uid=65532(nonroot) gid=65532(nonroot) groups=65532(nonroot)

# 验证应用程序权限
$ docker run -it --rm ${registry} ls -la /home/nonroot

#操作结果

这样配置后:

  1. 用户配置

    • 统一使用 UID 65532,便于多个 Task 中生成的文件具有一致的访问权限
    • 确保用户有适当的工作目录权限
    • 避免使用 root 用户或 UID 0
  2. 应用程序配置

    • 确保应用程序能够以非 root 用户正常运行
    • 在 Dockerfile 中提前配置好必要的目录权限
    • 使用 VOLUME 指令定义需要持久化的目录
  3. 安全建议

    • 定期更新基础镜像以修复安全漏洞
    • 使用多阶段构建减小镜像体积
    • 遵循最小权限原则配置用户权限

#故障排查

如果镜像在 Task 中运行时遇到权限问题,可以:

  1. 检查 Pod 事件中的错误信息
  2. 验证镜像中的用户配置是否正确
  3. 确认应用程序所需的权限是否已配置

#了解更多

  • Dockerfile 官方文档
  • Dockerfile 最佳实践