第 4 章 Pipelines

Pipeline 运行和任务运行将由目标命名空间中的 cron 作业自动修剪。cron 作业使用 IMAGE_JOB_PRUNER_TKN 环境变量来获取 tkn image 的值。在这个版本中，TektonConfig 自定义资源包括以下字段：

...
pruner:
  resources:
    - pipelinerun
    - taskrun
  schedule: "*/5 * * * *" # cron schedule
  keep: 2 # delete all keeping n
...

...
pruner:
  resources:
    - pipelinerun
    - taskrun
  schedule: "*/5 * * * *" # cron schedule
  keep: 2 # delete all keeping n
...

在 OpenShift Container Platform 中，您可以通过修改 TektonConfig 自定义资源中的新参数 clusterTasks 和 pipelinesTemplates 的值来自定义 Tekton Add-ons 组件的安装：

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  profile: all
  targetNamespace: openshift-pipelines
  addon:
    params:
    - name: clusterTasks
      value: "true"
    - name: pipelineTemplates
      value: "true"
...

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  profile: all
  targetNamespace: openshift-pipelines
  addon:
    params:
    - name: clusterTasks
      value: "true"
    - name: pipelineTemplates
      value: "true"
...

如果您使用 TektonConfig 创建附加组件，或者直接使用 Tekton Add-ons 创建附加组件，则允许进行自定义。但是，如果没有传递参数，控制器会添加带有默认值的参数。

enableMetrics 参数添加到 TektonConfig 自定义资源中。您可以使用它来禁用服务监控器，这是 OpenShift Container Platform 的 Tekton Pipelines 的一部分。

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  profile: all
  targetNamespace: openshift-pipelines
  pipeline:
    params:
    - name: enableMetrics
      value: "true"
...

apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  profile: all
  targetNamespace: openshift-pipelines
  pipeline:
    params:
    - name: enableMetrics
      value: "true"
...

添加了用于注册拦截器的 ClusterInterceptor 自定义资源定义，允许您注册您可以插入的新 Interceptor 类型。另外，还会进行以下相关更改：

tkn start [task | clustertask | pipeline] 命令以互动方式启动，并询问 params 值，即使指定了默认参数也是如此。若要停止交互式提示，可在调用 命令时传递 --use-param-defaults 标志。例如：

tkn pipeline start build-and-deploy \
    -w name=shared-workspace,volumeClaimTemplateFile=https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.5/01_pipeline/03_persistent_volume_claim.yaml \
    -p deployment-name=pipelines-vote-api \
    -p git-url=https://github.com/openshift/pipelines-vote-api.git \
    -p IMAGE=image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/pipelines-vote-api \
    --use-param-defaults

$ tkn pipeline start build-and-deploy \
    -w name=shared-workspace,volumeClaimTemplateFile=https://raw.githubusercontent.com/openshift/pipelines-tutorial/pipelines-1.5/01_pipeline/03_persistent_volume_claim.yaml \
    -p deployment-name=pipelines-vote-api \
    -p git-url=https://github.com/openshift/pipelines-vote-api.git \
    -p IMAGE=image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/pipelines-vote-api \
    --use-param-defaults

在 when 表达式中，对写入的字段的支持会被删除。when 表达式仅支持使用小写字母编写的字段。

当您将 Red Hat OpenShift Pipelines Operator 升级到 v1.5 时，openshift-client 和 openshift-client-v-1-5-0 集群任务会具有 SCRIPT 参数。但是，ARGS 参数和 git 资源会从 openshift-client 集群任务的规格中删除。这个变化可能会造成问题，只有在 ClusterTask 资源的 name 字段中没有特定版本的集群任务才可以无缝地进行升级。

要防止管道运行出现问题，在升级后使用 SCRIPT 参数，因为它会将之前在 ARGS 参数中指定的值移到集群任务的 SCRIPT 参数中。例如：

...
- name: deploy
  params:
  - name: SCRIPT
    value: oc rollout status <deployment-name>
  runAfter:
    - build
  taskRef:
    kind: ClusterTask
    name: openshift-client
...

...
- name: deploy
  params:
  - name: SCRIPT
    value: oc rollout status <deployment-name>
  runAfter:
    - build
  taskRef:
    kind: ClusterTask
    name: openshift-client
...

当您从 Red Hat OpenShift Pipelines Operator v1.4 升级到 v1.5 时，TektonConfig 自定义资源的配置集名称现在会改变。

disable-home-env-overwrite 和 disable-working-dir-overwrite 字段现已弃用，并将在以后的发行版本中删除。在本发行版本中，这些标志的默认值被设置为 true，以便向后兼容。

EventListener 资源的状态有一个名为 Ready 的新条件。

replicas 在 EventListener spec 中已被弃用。相反，spec.replicas 字段移到 KubernetesResource spec 中的 spec.resources.kubernetesResource.replicas。

git-cli 集群任务使用 alpine/git 基础镜像构建，它预期 /root 作为用户的主目录。但是，这并没有在 git-cli 集群任务中显式设置。

在 Tekton 中，任务的每个步骤都会使用 /tekton/home 覆盖默认主目录，除非另有指定。这会覆盖基础镜像的 $HOME 环境变量，从而导致 git-cli 集群任务失败。

此问题有望在即将发布的版本中解决。对于 Red Hat OpenShift Pipelines 1.5 及更早的版本，您可以使用以下任一临时解决方案来避免 git-cli 集群任务失败：

自定义任务有以下改进：

finally 的任务包括以下改进：

pipelines-scc 安全性上下文约束（SCC）与默认的 pipeline 服务帐户一同使用。此新服务帐户与 anyuid 类似，但 OpenShift Container Platform 4.7 的 SCC 在 YAML 中定义中有一个小的差别：

fsGroup:
  type: MustRunAs

fsGroup:
  type: MustRunAs

在触发器 spec 和绑定中，弃用的字段 template.name 已被删除，并使用 template.ref 替代。您应该更新所有 eventListener 定义，以使用 ref 字段。

如果您在触发器绑定中有以下配置，触发器会因为不正确处理 JSON 格式抛出错误：

params:
  - name: github_json
    value: $(body)

params:
  - name: github_json
    value: $(body)

要解决这个问题：

卸载 Red Hat OpenShift Pipelines Operator 不会删除事件监听程序。

作为临时解决方案，删除 EventListener 和 Pod CRD:

当您运行多架构容器镜像任务时，如果在 IBM Power Systems(ppc64le)或 IBM Z(s390x)集群上没有命令规格，则 TaskRun 资源会失败，并显示以下错误：

Error executing command: fork/exec /bin/bash: exec format error

Error executing command: fork/exec /bin/bash: exec format error

作为临时解决方案，使用特定架构的容器镜像或指定 sha256 摘要指向正确的架构。要获得 sha256 摘要，请输入：

skopeo inspect --raw <image_name>| jq '.manifests[] | select(.platform.architecture == "<architecture>") | .digest'

$ skopeo inspect --raw <image_name>| jq '.manifests[] | select(.platform.architecture == "<architecture>") | .digest'

Steps 规格中的环境变量 $HOME，变量 workingDir 已被弃用，并可能在以后的发行版本中有所变化。目前，在 Step 容器中，HOME 和 workingDir 变量会分别被 /tekton/home 和 /workspace 变量覆盖。

在以后的发行版本中，这两个字段将不会被修改，它将被设置为容器镜像和 Task YAML 中定义的值。在本发行版本中，使用 disable-home-env-overwrite 和 disable-working-directory-overwrite 标记来禁用覆盖 HOME 和 workingDir 变量。

当一个新用户添加到容器时，buildah 集群任务无法正常工作。

当安装 Operator 时，buildah 集群任务的 --storage-driver 标志没有指定，因此它会被设置为默认值。在某些情况下，这会导致存储驱动程序设置不正确。当添加一个新用户时，错误的 storage-driver 会造成 buildah 集群任务失败并带有以下错误：

useradd: /etc/passwd.8: lock file already used
useradd: cannot lock /etc/passwd; try again later.

useradd: /etc/passwd.8: lock file already used
useradd: cannot lock /etc/passwd; try again later.

作为临时解决方案，在 buildah-task.yaml 文件中手工把 --storage-driver 标识的值设置为 overlay：

另外，您还可以直接在 web 控制台中直接修改 buildah 集群任务 YAML 文件：进入 Pipelines Cluster Tasks buildah。从 Actions 菜单中选择 Edit Cluster Task，如前所示替换 command 项。