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 上编辑此页
上一页调整子组件的可选配置项
下一页Pod 模板配置指南

#配置流水线组件的资源配额

#目录

#Overview

配置与 Pipeline 组件相关的资源配额。

#Use Cases

  • 调整 Pipeline 组件的资源配额
  • 设置 TaskRun 创建的 init-containers 和 containers 的默认资源配额

#Prerequisites

  • 必须已安装 Tekton Operator 组件
  • 环境中必须已自动创建 TektonConfig 资源
  • 应阅读文档 调整子组件的可选配置项

#Resource Configuration Guidelines

在配置资源配额之前:

  • 评估集群的可用资源和容量
  • 考虑工作负载特性和性能需求
  • 从保守值开始,根据监控数据进行调整
  • 先在非生产环境中测试配置

#Steps

#Step 1

编辑 TektonConfig 资源

$ kubectl edit tektonconfigs.operator.tekton.dev config

#Step 2

WARNING

修改配置可能会触发组件 Pods 的滚动更新,可能导致服务短暂不可用。请在合适的时间执行。

修改 spec.pipeline.options.deployments 配置示例:

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  pipeline:
    options:
      disabled: false

      configMaps:
        config-defaults:
          data:
            # 添加默认容器资源配额
            # 根据集群资源容量和工作负载需求调整以下数值
            default-container-resource-requirements: |
              place-scripts: # 更新 'place-scripts' 容器的资源需求
                requests:
                  memory: "<MEMORY_REQUEST>"  # 例如 "128Mi"
                  cpu: "<CPU_REQUEST>"        # 例如 "250m"
                limits:
                  memory: "<MEMORY_LIMIT>"    # 例如 "512Mi"
                  cpu: "<CPU_LIMIT>"          # 例如 "500m"

              prepare: # 更新 'prepare' 容器的资源需求
                requests:
                  memory: "<MEMORY_REQUEST>"  # 例如 "128Mi"
                  cpu: "<CPU_REQUEST>"        # 例如 "250m"
                limits:
                  memory: "<MEMORY_LIMIT>"    # 例如 "256Mi"
                  cpu: "<CPU_LIMIT>"          # 例如 "500m"

              working-dir-initializer: # 更新 'working-dir-initializer' 容器的资源需求
                requests:
                  memory: "<MEMORY_REQUEST>"  # 例如 "128Mi"
                  cpu: "<CPU_REQUEST>"        # 例如 "250m"
                limits:
                  memory: "<MEMORY_LIMIT>"    # 例如 "512Mi"
                  cpu: "<CPU_LIMIT>"          # 例如 "500m"

              prefix-scripts: # 更新以 'scripts-' 开头的容器的资源需求
                requests:
                  memory: "<MEMORY_REQUEST>"  # 例如 "128Mi"
                  cpu: "<CPU_REQUEST>"        # 例如 "250m"
                limits:
                  memory: "<MEMORY_LIMIT>"    # 例如 "512Mi"
                  cpu: "<CPU_LIMIT>"          # 例如 "500m"

              prefix-sidecar-scripts: # 更新以 'sidecar-scripts-' 开头的容器的资源需求
                requests:
                  memory: "<MEMORY_REQUEST>"  # 例如 "128Mi"
                  cpu: "<CPU_REQUEST>"        # 例如 "250m"
                limits:
                  memory: "<MEMORY_LIMIT>"    # 例如 "512Mi"
                  cpu: "<CPU_LIMIT>"          # 例如 "500m"

              sidecar-tekton-log-results: # 更新 'sidecar-tekton-log-results' 容器的资源需求
                requests:
                  memory: "<MEMORY_REQUEST>"  # 例如 "128Mi"
                  cpu: "<CPU_REQUEST>"        # 例如 "100m"
                limits:
                  memory: "<MEMORY_LIMIT>"    # 例如 "256Mi"
                  cpu: "<CPU_LIMIT>"          # 例如 "250m"

      deployments:
        # 根据集群容量和性能需求调整以下资源数值
        tekton-pipelines-controller:
          spec:
            replicas: <REPLICA_COUNT>  # 例如 1
            template:
              spec:
                containers:
                  - name: tekton-pipelines-controller
                    resources:
                      requests:
                        cpu: <CPU_REQUEST>        # 例如 "500m"
                        memory: <MEMORY_REQUEST>  # 例如 "512Mi"
                      limits:
                        cpu: <CPU_LIMIT>          # 例如 "1"
                        memory: <MEMORY_LIMIT>    # 例如 "1Gi"

        tekton-pipelines-remote-resolvers:
          spec:
            replicas: <REPLICA_COUNT>  # 例如 1
            template:
              spec:
                containers:
                  - name: controller
                    resources:
                      requests:
                        cpu: <CPU_REQUEST>        # 例如 "200m"
                        memory: <MEMORY_REQUEST>  # 例如 "256Mi"
                      limits:
                        cpu: <CPU_LIMIT>          # 例如 "500m"
                        memory: <MEMORY_LIMIT>    # 例如 "512Mi"

        tekton-pipelines-webhook:
          spec:
            replicas: <REPLICA_COUNT>  # 例如 1
            template:
              spec:
                containers:
                  - name: webhook
                    resources:
                      requests:
                        cpu: <CPU_REQUEST>        # 例如 "500m"
                        memory: <MEMORY_REQUEST>  # 例如 "256Mi"
                      limits:
                        cpu: <CPU_LIMIT>          # 例如 "1"
                        memory: <MEMORY_LIMIT>    # 例如 "500Mi"

        tekton-events-controller:
          spec:
            replicas: <REPLICA_COUNT>  # 例如 1
            template:
              spec:
                containers:
                  - name: tekton-events-controller
                    resources:
                      requests:
                        cpu: <CPU_REQUEST>        # 例如 "100m"
                        memory: <MEMORY_REQUEST>  # 例如 "100Mi"
                      limits:
                        cpu: <CPU_LIMIT>          # 例如 "200m"
                        memory: <MEMORY_LIMIT>    # 例如 "256Mi"

#Step 3

提交配置并等待 Pods 更新。

$ kubectl get pods -n tekton-pipelines -w

NAME                                                    READY   STATUS    RESTARTS   AGE
tekton-pipelines-controller-648d87488b-fq9bc            1/1     Running   0          2m21s
tekton-pipelines-remote-resolvers-79554f5959-cbm6x      1/1     Running   0          2m21s
tekton-pipelines-webhook-5cd9847998-864zf               1/1     Running   0          2m20s
tekton-events-controller-5c97b7554c-m59m6               1/1     Running   0          2m21s

#Operation Result

您可以看到与 Pipeline 相关组件的资源配额配置已生效。

$ kubectl get deployments.apps -n tekton-pipelines tekton-pipelines-controller tekton-pipelines-remote-resolvers tekton-pipelines-webhook tekton-events-controller -o yaml | grep 'resources:' -A 6

          resources:
            limits:
              cpu: "1"
              memory: 1Gi
            requests:
              cpu: 500m
              memory: 512Mi
--
          resources:
            limits:
              cpu: 500m
              memory: 512Mi
            requests:
              cpu: 200m
              memory: 256Mi
--
          resources:
            limits:
              cpu: "2"
              memory: 500Mi
            requests:
              cpu: "1"
              memory: 256Mi
--
          resources:
            limits:
              cpu: 200m
              memory: 256Mi
            requests:
              cpu: 100m
              memory: 100Mi

#验证 Pod 资源配额配置

#创建一个 TaskRun

$ cat <<'EOF' | kubectl create -f -
apiVersion: tekton.dev/v1
kind: TaskRun
metadata:
  name: hello
  namespace: default
spec:
  taskSpec:
    steps:
      - name: hello
        image: alpine
        command: ["echo", "hello"]
EOF

#等待 TaskRun 完成

$ kubectl get taskruns.tekton.dev -n default hello

NAME    SUCCEEDED   REASON      STARTTIME   COMPLETIONTIME
hello   True        Succeeded   2m41s       2m28s

#查看 Pod 资源配额配置

$ kubectl get pods -n default hello-hello-pod -o yaml

apiVersion: v1
kind: Pod
metadata:
  name: hello-pod
  namespace: default
spec:
  containers:
    - image: alpine
      name: step-hello
      resources: {}
  initContainers:
    - name: prepare
      resources:
        limits:
          cpu: 100m
          memory: 256Mi
        requests:
          cpu: 50m
          memory: 64Mi

您可以看到 Pod 中 initContainers 容器 prepare 的资源配额与 config-defaults ConfigMap 中配置的资源配额相匹配。

#References

  • Official Documentation: Configuring Default Resource Requirements
  • Related Code