调整子组件的可选配置项

功能概述

通过调整 TektonConfig 资源中各个组件的 options 配置，可以实现对子组件的自定义配置。

本文档介绍 options 支持的配置项，以及如何配置这些项。

使用场景

Tekton 支持通过 TektonConfig 资源部署子组件。该资源在 spec.pipeline、spec.trigger、spec.hub、spec.chain 和 spec.result 字段下都有一个公共配置项 options。

通过 options 配置，可以实现：

组件的定点部署
修改高可用设置
修改组件副本数
修改组件资源配额
修改默认 ConfigMap 配置项

详细可配置项

修改组件 Deployment 的配置，例如：
- labels 和 annotations 配置
- 副本数 replicas
- 亲和性规则 affinity
- 优先级类 priorityClassName
- 节点选择器 nodeSelector
- 容忍规则 tolerations
- 拓扑分布约束 topologySpreadConstraints
- 运行时类 runtimeClassName
- 卷 volumes
- 容器 containers 和 initContainers
  - 资源配额 resources.limits 和 resources.requests
  - 环境变量 env
  - 卷 volumes
  - 执行参数 args
修改组件 ConfigMap 的配置，例如：
- labels 和 annotations 配置
- 更新或新增 data 配置项
修改组件 Ingress 的配置，例如：
- ingressClassName，用于覆盖默认的 ingressClass 配置
- rules，用于覆盖默认路由规则
- tls，用于覆盖默认证书配置
修改组件 HorizontalPodAutoscaler 的自动扩缩容配置，例如：
- 添加此配置
- 修改 minReplicas 和 maxReplicas 配置
- 修改 targetCPUUtilizationPercentage 配置等
修改组件 StatefulSet 的配置
修改组件 ValidatingWebhookConfiguration 和 MutatingWebhookConfiguration 的配置

前提条件

在使用该功能前，请确保：

已安装 Tekton Operator 组件
环境中已自动创建 TektonConfig 资源
您已基本了解 TektonConfig 中支持的配置项

以下是一个典型的 options 配置示例：

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  targetNamespace: tekton-pipelines
  hub: {}
  chain: {}
  trigger: {}
  pipeline:
    options:
      # 是否启用 options 配置，默认值为 false。设为 true 时，options 下的所有配置都不会生效。
      disabled: false

      # 配置 ConfigMap 的配置
      configMaps:
        # 要修改或新增的 ConfigMap 名称
        config-defaults:
          data:
            # 要修改或新增的配置项
            default-container-resource-requirements: |
              place-scripts: # updates resource requirements of a 'place-scripts' container
                requests:
                  memory: "64Mi"
                  cpu: "50m"
                limits:
                  memory: "128Mi"
                  cpu: "100m"

      # 配置 Deployment 的配置
      deployments:
        # 要修改的 Deployment 名称
        tekton-events-controller:
          metadata:
            # 要修改的 Deployment 的 labels 配置
            labels:
              key: value
            # 要修改的 Deployment 的 annotations 配置
            annotations:
              key: value
          spec:
            # 要修改的 Deployment 副本数
            replicas: 1
            # 要修改的模板配置
            template:
              metadata:
                # 要修改的 labels 配置
                labels:
                  key1: value
                # 要修改的 annotations 配置
                annotations:
                  key1: value
              spec:
                # 要修改的亲和性配置
                affinity:
                  nodeAffinity:
                    requiredDuringSchedulingIgnoredDuringExecution:
                      nodeSelectorTerms:
                        - matchExpressions:
                          - key: kubernetes.io/os
                            operator: In
                            values:
                              - linux

                # 要修改的节点选择器配置
                nodeSelector:
                  kubernetes.io/os: linux

                # 要修改的容忍规则配置
                tolerations:
                  - effect: NoSchedule
                    key: node-role.kubernetes.io/master
                    operator: Exists

                # priorityClassName: ""
                # topologySpreadConstraints: ""
                # runtimeClassName: ""
                # volumes: []
                # initContainers: []

                containers:
                  # 要修改的容器名称
                  - name: tekton-events-controller
                    # 要修改的资源配额
                    resources:
                      limits:
                        cpu: "1"
                        memory: 1Gi
                      requests:
                        cpu: 500m
                        memory: 512Mi

                    # 要修改的环境变量
                    env:
                      - name: key
                        value: value

                    # 要修改的卷配置
                    # volumes: []

                    # 要添加的执行参数
                    # args: []

      # 要修改或新增的 HorizontalPodAutoscaler 配置
      horizontalPodAutoscalers:
        # 要修改的 horizontalPodAutoscaler 名称
        tekton-pipelines-remote-resolvers:
          metadata:
            # 要修改的 annotations 配置
            # 要修改的 labels 配置
            labels:
              key: value
            annotations:
              key: value
          spec:
            # 要修改的 MinReplicas 配置
            minReplicas: 1
            # 要修改的 MaxReplicas 配置
            maxReplicas: 5
            # 要修改的 Metrics 配置
            metrics:
              - resource:
                  name: cpu
                  target:
                    averageUtilization: 50
                    type: Utilization
                type: Resource
              - resource:
                  name: memory
                  target:
                    averageUtilization: 50
                    type: Utilization
                type: Resource
            # 要修改的 scaleTargetRef 配置
            scaleTargetRef:
              apiVersion: apps/v1
              kind: Deployment
              name: tekton-pipelines-remote-resolvers

操作步骤

以下以 pipeline 组件为例，说明如何配置资源配额。

步骤 1

编辑 TektonConfig 资源

$ kubectl edit tektonconfigs.operator.tekton.dev config

步骤 2

WARNING

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

按如下方式修改 spec.pipeline.options.deployments 配置：

将 Deployment tekton-events-controller 的副本数改为 2
修改 Deployment tekton-events-controller 的 resources 配置

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  targetNamespace: tekton-pipelines
  hub: {}
  chain: {}
  trigger: {}
  pipeline:
    options:
      disabled: false
      deployments:
        tekton-events-controller:
          spec:
            replicas: 2
            template:
              spec:
                containers:
                  - name: tekton-events-controller
                    resources:
                      limits:
                        cpu: "1"
                        memory: 1Gi
                      requests:
                        cpu: 500m
                        memory: 512Mi

步骤 3

提交配置并等待 Pod 更新。

$ kubectl get pods -n tekton-pipelines -l app=tekton-events-controller -w

NAME                                       READY   STATUS    RESTARTS   AGE
tekton-events-controller-fcd56975b-knvzx   1/1     Running   0          20s
tekton-events-controller-fcd56975b-qqprt   1/1     Running   0          31s

操作结果

可以看到 tekton-events-controller 的副本数已变为 2，且 resources 配置已生效。

$ kubectl get deployments.apps -n tekton-pipelines tekton-events-controller -o yaml

apiVersion: apps/v1
kind: Deployment
metadata:
  name: tekton-events-controller
  namespace: tekton-pipelines
spec:
  replicas: 2
  template:
    metadata:
    spec:
      containers:
      - name: tekton-events-controller
        resources:
          limits:
            cpu: "1"
            memory: 1Gi
          requests:
            cpu: 500m
            memory: 512Mi

后续操作

如果需要修改其他组件的配置，可以参考上述步骤修改其他组件的 options 配置。

调整子组件的可选配置项

目录

功能概述

使用场景

详细可配置项

前提条件

操作步骤

步骤 1

步骤 2

步骤 3

操作结果

后续操作

参考资料

#调整子组件的可选配置项

#目录

#功能概述

#使用场景

#详细可配置项

#前提条件

#操作步骤

#步骤 1

#步骤 2

#步骤 3

#操作结果

#后续操作

#参考资料

调整子组件的可选配置项

目录

功能概述

使用场景

详细可配置项

前提条件

操作步骤

步骤 1

步骤 2

步骤 3

操作结果

后续操作

参考资料