第 4 章 Pipelines

当您运行 Maven 和 Jib-Maven 集群任务时，默认容器镜像仅支持 Intel(x86)架构。因此，在 IBM Power Systems(ppc64le)、IBM Z 和 LinuxONE(s390x)集群上的任务将失败。作为临时解决方案，您可以通过将 MAVEN_IMAGE 参数值设置为 maven:3.6.3-adoptopenjdk-11 来指定自定义镜像。

您无法使用 nodejs:14-ubi8-minimal 镜像流，因为这样做会生成以下错误：

STEP 7: RUN /usr/libexec/s2i/assemble
/bin/sh: /usr/libexec/s2i/assemble: No such file or directory
subprocess exited with status 127
subprocess exited with status 127
error building at STEP "RUN /usr/libexec/s2i/assemble": exit status 127
time="2021-11-04T13:05:26Z" level=error msg="exit status 127"

在这个版本中添加了 v1beta1 Go API 类型。在这个版本中，触发器支持 v1beta1 API 版本。

在当前发行版本中，v1alpha1 功能已弃用，并将在以后的发行版本中删除。改为使用 v1beta1 功能替代。

在当前发行版本中，默认启用自动运行资源。另外，您可以使用以下新注解为每个命名空间单独配置自动运行任务运行和管道运行：

引入了以下 alpha 功能：

当前发行版本允许您通过在 TektonConfig 自定义资源(CR)中指定 nodeSelector 和 tolerations 值来配置节点选择。Operator 将这些值添加到它创建的所有部署中。

在 Tekton Triggers v0.16.0 中，冗余的 status 标签已从 EventListener 资源的指标中删除。

在当前发行版本中，EventListener 资源会在触发器完成处理前发送响应。

当前发行版本从 EventListener 资源中删除 podTemplate 字段。

当前发行版本从 EventListener 资源规格中删除已弃用的 replicas 字段。

在 Red Hat OpenShift Pipelines 1.6 中，HOME="/tekton/home" 和 workingDir="/workspace" 的值从 Step 对象的规格中删除。

相反，Red Hat OpenShift Pipelines 将 HOME 和 workingDir 设置为运行 Step 对象的容器定义的值。您可以在 Step 对象的规格中覆盖这些值。

要使用旧的行为，您可以将 TektonConfig CR 中的 disable-working-directory-overwrite 和 disable-home-env-overwrite 字段改为 false ：

apiVersion: operator.tekton.dev/v1alpha1
  kind: TektonConfig
  metadata:
    name: config
  spec:
    pipeline:
      disable-working-directory-overwrite: false
      disable-home-env-overwrite: false
  ...

您无法使用 nodejs:14-ubi8-minimal 镜像流，因为这样做会生成以下错误：

STEP 7: RUN /usr/libexec/s2i/assemble
/bin/sh: /usr/libexec/s2i/assemble: No such file or directory
subprocess exited with status 127
subprocess exited with status 127
error building at STEP "RUN /usr/libexec/s2i/assemble": exit status 127
time="2021-11-04T13:05:26Z" level=error msg="exit status 127"

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

...
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"
...

如果您使用 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"
...

添加了用于注册拦截器的 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.7/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
...

当您从 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

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

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

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

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

$ 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.

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

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