CI/CD

• .gitconfig 文件
• 基本身份验证
• SSH 密钥身份验证
• 可信证书颁发机构

• 使用 secret 数据创建 secret 对象。
• 更新 pod 的服务帐户以允许引用该 secret。
• 创建以环境变量或文件（使用 secret 卷）形式消耗 secret 的 pod。

流程

• 使用创建命令从 JSON 或 YAML 文件创建 secret 对象：

  $ oc create -f <filename>

  例如，您可以从本地的 .docker/config.json 文件创建一个 secret：

  $ oc create secret generic dockerhub \
      --from-file=.dockerconfigjson=<path/to/.docker/config.json> \
      --type=kubernetes.io/dockerconfigjson

  此命令将生成名为 dockerhub 的 secret JSON 规格并创建该对象。

  YAML Opaque Secret 对象定义

  apiVersion: v1
  kind: Secret
  metadata:
    name: mysecret
  type: Opaque 1
  data:
    username: dXNlci1uYW1l
    password: cGFzc3dvcmQ=

  1

  指定一个 opaque secret。

  Docker 配置 JSON 文件对象定义

  apiVersion: v1
  kind: Secret
  metadata:
    name: aregistrykey
    namespace: myapps
  type: kubernetes.io/dockerconfigjson 1
  data:
    .dockerconfigjson:bm5ubm5ubm5ubm5ubm5ubm5ubm5ubmdnZ2dnZ2dnZ2dnZ2dnZ2dnZ2cgYXV0aCBrZXlzCg== 2

  1

  指定该 secret 使用 docker 配置 JSON 文件。

  2

  base64 编码的 docker 配置 JSON 文件

流程

• 将 fieldPath 环境变量源设置为您有兴趣获取其值的字段的 JsonPath：

  env:
    - name: FIELDREF_ENV
      valueFrom:
        fieldRef:
          fieldPath: metadata.name

流程

• 要将 secret 用作环境变量，请设置 valueFrom 语法：

  apiVersion: build.openshift.io/v1
  kind: BuildConfig
  metadata:
    name: secret-example-bc
  spec:
    strategy:
      sourceStrategy:
        env:
        - name: MYVAL
          valueFrom:
            secretKeyRef:
              key: myval
              name: mysecret

流程

• 将 imageOptimizationPolicy 设置为 SkipLayers：

  strategy:
    dockerStrategy:
      imageOptimizationPolicy: SkipLayers

流程

• 要创建增量构建，请创建对策略定义进行以下修改：

  strategy:
    sourceStrategy:
      from:
        kind: "ImageStreamTag"
        name: "incremental-image:latest" 1
      incremental: true 2

  1

  指定支持增量构建的镜像。请参考构建器镜像的文档，以确定它是否支持此行为。

  2

  此标志（flag）控制是否尝试增量构建。如果构建器镜像不支持增量构建，则构建仍将成功，但您会收到一条日志消息，指出增量构建因为缺少 save-artifacts 脚本而未能成功。

• 在应用程序源存储库的 .s2i/bin 目录中提供 assemble、run 或 save-artifacts 脚本。

• 提供包含脚本的目录的 URL，作为策略定义的一部分。例如：

  strategy:
    sourceStrategy:
      from:
        kind: "ImageStreamTag"
        name: "builder-image:latest"
      scripts: "http://somehost.com/scripts_directory" 1

  1

  此路径会将 run、assemble 和 save-artifacts 附加到其中。如果找到任何或所有脚本，将使用它们代替镜像中提供的同名脚本。

流程

• 设置 customStrategy.from 部分：

  strategy:
    customStrategy:
      from:
        kind: "DockerImage"
        name: "openshift/sti-image-builder"

流程

• 要将各个 secret 挂载到特定位置，编辑 策略 YAML 文件的 secretSource 和 mountPath 字段：

  strategy:
    customStrategy:
      secrets:
        - secretSource: 1
            name: "secret1"
          mountPath: "/tmp/secret1" 2
        - secretSource:
            name: "secret2"
          mountPath: "/tmp/secret2"

  1

  secretSource 是对与构建相同的命名空间中的 secret 的引用。

  2

  mountPath 是自定义构建器中应挂载 secret 的路径。

• Jenkins 中动态作业并运行创建。
• 从镜像流、镜像流标签或配置映射动态创建代理 Pod 模板。
• 注入环境变量。
• OpenShift Container Platform Web 控制台中的管道视觉化。
• 与 Jenkins Git 插件集成，后者将 OpenShift Container Platform 构建的提交信息传递给 Jenkins Git 插件。
• 将 secret 同步到 Jenkins 凭证条目。

• 构建配置中的内联 jenkinsfile 字段。
• 构建配置中的 jenkinsfilePath 字段，该字段引用要使用的 jenkinsfile 的位置，该位置相对于源 contextDir。

• 位于源代码存储库中的文件。
• 使用 jenkinsfile 字段嵌入为构建配置的一部分。

• 存储库根目录下名为 jenkinsfile 的文件。
• 存储库的源 contextDir 的根目录下名为 jenkinsfile 的文件。
• 通过 BuildConfig 的 JenkinsPipelineStrategy 部分的 jenkinsfilePath 字段指定的文件名；若提供，则路径相对于源 contextDir，否则默认为存储库的根目录。

• 在构建配置中嵌入 Jenkins 文件。
• 在构建配置中包含对包含 Jenkins 文件的 Git 存储库的引用。

流程

• 要定义在构建期间使用的环境变量，编辑 YAML 文件：

  jenkinsPipelineStrategy:
  ...
    env:
      - name: "FOO"
        value: "BAR"

流程

• 要手动重新运行构建，请输入以下命令：

  $ oc start-build --from-build=<build_name>

流程

• 要在 stdout 中手动输出构建日志，请输入以下命令：

  $ oc start-build <buildconfig_name> --follow

流程

• 要指定所需的环境变量，请输入以下命令：

  $ oc start-build <buildconfig_name> --env=<key>=<value>

流程

• 使用以下命令从源启动构建，以将本地 Git 存储库的内容作为标签 v2 的存档发送：

  $ oc start-build hello-world --from-repo=../hello-world --commit=v2

流程

• 要手动取消多个构建，请输入以下命令：

  $ oc cancel-build <build1_name> <build2_name> <build3_name>

流程

• 要取消所有构建，请输入以下命令：

  $ oc cancel-build bc/<buildconfig_name>

流程

• 要取消给定状态下的所有内容，请输入以下命令：

  $ oc cancel-build bc/<buildconfig_name>

流程

• 要输出 BuildConfig 的最新构建的日志，请输入以下命令：

  $ oc logs -f bc/<buildconfig_name>

流程

• 要输出 BuildConfig 的给定版本构建的日志，请输入以下命令：

  $ oc logs --version=<number> bc/<buildconfig_name>

流程

• 要启用更为详细的输出，请传递 BUILD_LOGLEVEL 环境变量作为 BuildConfig 中 sourceStrategy 或 dockerStrategy 的一部分：

  sourceStrategy:
  ...
    env:
      - name: "BUILD_LOGLEVEL"
        value: "2" 1

  1

  将此值调整为所需的日志级别。

先决条件

• 您已配置了多个镜像更改触发器。这些触发器已触发一个或多个构建。

• lastTriggeredImageID：此字段在 OpenShift Container Platform 4.8 中已弃用，并将在以后的发行版本中被忽略。它包含从此 BuildConfig 触发最后一次构建时的 ImageStreamTag 的已解析镜像引用。
• paused：您可以使用此字段（示例中未显示）暂时禁用此特定镜像更改触发器。
• from：您使用此字段引用驱动此镜像更改触发器的 ImageStreamTag。其类型是核心 Kubernetes 类型 OwnerReference。

流程

• Shell 脚本：

  postCommit:
    script: "bundle exec rake test --verbose"

  script 值是通过 /bin/sh -ic 执行的 shell 脚本。当 shell 脚本适合执行构建 hook 时可使用此选项。例如，用于运行前文所述的单元测试。若要控制镜像入口点，或者如果镜像没有 /bin/sh，可使用 command 和/或 args。

  注意

  引入的额外 -i 标志用于改进搭配 CentOS 和 RHEL 镜像时的体验，未来的发行版中可能会剔除。

• 命令作为镜像入口点：

  postCommit:
    command: ["/bin/bash", "-c", "bundle exec rake test --verbose"]

  在这种形式中，command 是要运行的命令，它会覆盖 exec 形式中的镜像入口点，如 Dockerfile 引用中所述。如果镜像没有 /bin/sh，或者您不想使用 shell，则需要这样做。在所有其他情形中，使用 script 可能更为方便。

• 命令带有参数：

  postCommit:
    command: ["bundle", "exec", "rake", "test"]
    args: ["--verbose"]

  这种形式相当于将参数附加到 command。

先决条件

• 您必须提供或创建与 yum 兼容的存储库配置文件，该文件将从 Satellite 实例下载内容。

  仓库配置示例

  [test-<name>]
  name=test-<number>
  baseurl = https://satellite.../content/dist/rhel/server/7/7Server/x86_64/os
  enabled=1
  gpgcheck=0
  sslverify=0
  sslclientkey = /etc/pki/entitlement/...-key.pem
  sslclientcert = /etc/pki/entitlement/....pem

先决条件

• 必须将权利密钥和 Satellite 存储库配置添加为构建输入。

• 管道（Pipeline）：利用 Groovy 语法自动化构建、测试和部署应用的整个流程。
• 节点（Node）：能够编配或执行脚本化管道的计算机。
• 阶段（Stage）：在管道中执行的概念上不同的任务子集。插件或用户界面通常使用此块来显示任务的状态或进度。
• 步骤（Step）：一项任务指定要执行的确切操作，可使用命令或脚本。

• 频道（Pipeline）：一组串行或并行（或两者）任务。
• 任务（Task） ：作为命令、二进制文件或脚本的步骤序列。
• 管道运行（PipelineRun）：执行包含一个或多个任务的管道。

• 任务运行（TaskRun）：通过一个或多个步骤执行任务。

  注意

  您可以使用一组输入（如参数和工作区）启动 PipelineRun 或 TaskRun，执行会产生一组输出和工件。

• 工作区（Workspace）：在 Tekton 中，工作区是概念块，用于以下目的：

  • 存储输入、输出和构建工件.
  • 在任务间共享数据的通用空间.
  • 在 secret 中保存的凭证挂载点、配置映射中保存的配置以及机构共享的通用工具。
  注意

  在 Jenkins 中，没有 Tekton 工作区直接等效的工作区。您可以将控制节点视为工作区，因为它存储克隆的代码存储库、构建历史记录和工件。当作业分配到其他节点时，克隆的代码和生成的工件会存储在该节点中，但构建历史记录由控制节点维护。

• TP: 技术预览
• GA: 正式发行

• 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 创建附加组件，则允许进行自定义。但是，如果没有传递参数，控制器会添加带有默认值的参数。

  注意
  • 如果使用 TektonConfig 自定义资源创建附加组件，并且稍后在 Addon 自定义资源中更改参数值，则 TektonConfig 自定义资源中的值将覆盖更改。
  • 只有在 clusterTasks 参数的值为 true 时，才可将 pipelinesTemplates 参数的值设置为 true。

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

• 添加了 EventListener OpenCensus 指标（在进程级别捕获指标）。
• 触发器现在具有标签选择器；您可以使用标签为事件监听程序配置触发器。

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

  • 在触发器规格中，您可以使用包含 ref 字段的新 API 来配置拦截器来引用集群拦截器。另外，您可以使用 params 字段添加传递到拦截器进行处理的参数。
  • 捆绑的拦截器 CEL、GitHub、GitLab 和 BitBucket 已迁移。它们使用新的 ClusterInterceptor 自定义资源定义来实施。
  • 核心拦截器迁移到新格式，使用旧语法创建的任何新触发器都会自动切换到新的 ref 或 params 语法。
• 要在显示日志时禁用任务名称的前缀或步骤，可将 --prefix 选项用于 log 命令。
• 要显示特定组件的版本，请使用 tkn version 命令中的新的 --component 标志。
• 添加了 tkn hub check-upgrade 命令，其他命令会根据管道版本进行修改。此外，search 命令输出中也会显示目录名称。
• 在 start 命令中添加了对可选工作区的支持。
• 如果 plugins 目录中不存在插件，则会在当前路径中搜索它们。

• 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

• version 字段在 tkn task describe 命令中添加。
• 如果只有一个资源，则会自动选择 TriggerTemplate 或 TriggerBinding 或 ClusterTriggerBinding 或 Eventlistener 等资源的选项会添加到 describe 命令中。
• 在 tkn pr describe 命令中添加了跳过的任务部分。
• 添加了对 tkn clustertask logs 的支持。
• 移除 config.yaml 中的 YAML 合并和变量。另外，现在 kustomize 和 ytt 等工具可以更轻松地使用 release.yaml 文件。
• 添加了对包含句点字符(".")的资源名称的支持。
• PodTemplate 规格中的 hostAliases 数组添加到主机名解析的 pod 级别覆盖中。它通过修改 /etc/hosts 文件来实现。
• 引入了一个变量 $(tasks.status)，用于访问任务的聚合执行状态。
• 为 Windows 添加入口点二进制构建。

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

  注意

  如果您在 Tekton Pipelines v0.16 (Operator v1.2.x) 中应用了一个带有 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 自定义资源的配置集名称现在会改变。

  表 4.2. TektonConfig 自定义资源的配置集

  Pipelines 1.5 中的配置集	Pipelines 1.4 中的对应的配置集	安装的 Tekton 组件
  All (默认配置集)	All (默认配置集)	Pipelines、Triggers、Add-ons
  Basic	默认	Pipelines、Triggers
  Lite	Basic	Pipelines

  注意

  如果在 TektonConfig 自定义资源的 config 实例中使用 profile: all，则不需要更改资源规格。

  但是，如果安装的 Operator 在升级前是 Default 或 Basic 配置集，则必须在升级后编辑 TektonConfig 自定义资源的 config 实例。例如，如果配置在升级前是 profile: basic，请确保在升级到 Pipelines 1.5 后为 profile: lite。

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

  注意

  在下一个发行版本 (Red Hat OpenShift Pipelines 1.6) 中，HOME 环境变量不会自动设置为 /tekton/home，对于任务运行的默认工作目录也不会设置为 /workspace。这些默认设置与步骤中镜像 Dockerfile 设置的任何值冲突。

• ServiceType 和 podTemplate 字段已从 EventListener spec 中删除。
• 控制器服务帐户不再请求集群范围的权限来列出和监视命名空间。

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

  注意

  将来，EventListener 资源的其他状态条件将会被弃用，而使用 Ready 状态条件。

• EventListener 响应中的 eventListener 和 namespace 字段已弃用。现在改为使用 eventListenerUID 字段。

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

  注意

  replicas 字段将在以后的发行版本中删除。

• 配置内核拦截器的旧方法已弃用。但是，它会继续正常工作，直到在以后的版本中被删除。现在，Trigger 资源中的拦截器被配置为使用新的基于 ref 和 params 的语法。生成的默认 webhook 会自动将旧语法的使用切换为新触发器的新语法。
• 对于 ClusterRoleBinding 资源，使用 Userbac.authorization.k8s.io/v1 而不是已弃用的 deprecatedrbac.authorization.k8s.io/v1beta1。
• 在集群角色中，对资源（如 serviceaccounts、secrets、configmaps 和 limitranges 等）的集群范围的写访问权限已被移除。另外，对资源（如 deployments、statefulsets 和 deployment/finalizers 等）的集群范围的访问权限也被移除。
• Tekton 不再使用 caching.internal.knative.dev 组中的 image 自定义资源定义，它已在此发行版本中排除。

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

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

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

  • 在步骤中设置 $HOME 环境变量，使其不会被覆盖。

    1. [可选] 如果您使用 Operator 安装了 Red Hat OpenShift Pipelines，然后将 git-cli 集群任务克隆到一个单独的任务中。此方法可确保 Operator 不会覆盖对集群任务所做的更改。
    2. 执行 oc edit clustertasks git-cli 命令。

    3. 将预期的 HOME 环境变量添加到步骤的 YAML 中：

       ...
       steps:
         - name: git
           env:
           - name: HOME
             value: /root
           image: $(params.BASE_IMAGE)
           workingDir: $(workspaces.source.path)
       ...

       警告

       对于 Operator 安装的 Red Hat OpenShift Pipelines，如果您在更改 HOME 环境变量前没有将 git-cli 集群任务克隆到单独的任务中，则会在 Operator 协调过程中覆盖更改。

  • 禁用在 feature-flags 配置映射中覆盖 HOME 环境变量。

    1. 执行 oc edit -n openshift-pipelines configmap feature-flags 命令。

    2. 将 disable-home-env-overwrite 标志的值设置为 true。

       警告
       • 如果使用 Operator 安装 Red Hat OpenShift Pipelines，则在 Operator 协调过程中会覆盖更改。
       • 修改 disable-home-env-overwrite 标志的默认值可能会破坏其他任务和集群任务，因为它会更改所有任务的默认值。

  • 为 git-cli 集群任务使用其他服务帐户，因为在使用管道的默认服务帐户时会覆盖 HOME 环境变量。

    1. 创建新服务帐户。
    2. 将您的 Git secret 链接到您刚才创建的服务帐户。
    3. 在执行任务或管道时使用服务帐户。
• 在 IBM Power Systems、IBM Z 和 LinuxONE 中，不支持 s2i-dotnet 集群任务和 tkn hub 命令。
• 当您在 IBM Power Systems(ppc64le)、IBM Z 和 LinuxONE(s390x)集群上运行 Maven 和 Jib-Maven 集群任务时，将 MAVEN_IMAGE 参数值设置为 maven:3.6.3-adoptopenjdk-11。

• dag 任务中的 when 表达式不允许指定任何其他任务访问执行状态的上下文变量 （$(tasks.<pipelineTask>.status)）。
• 使用 Owner UID 而不是 Owner 名称，这有助于在 PipelineRun 资源快速删除并重新创建的情况下，避免通过删除 volumeClaimTemplate PVC 创建的竞争条件。
• 为非 root 用户触发的 build-base 镜像添加了 pullrequest-init 的新 Dockerfile。
• 当一个管道或任务在运行时使用 -f 选项，且它的定义中的 param 中没有定义 type，将生成一个验证错误，而不是管道或任务以静默方式运行失败。
• 对于 tkn start [task | pipeline | clustertask] 命令，--workspace 标记的描述现在一致。
• 在解析参数时，如果遇到空数组，则对应的交互式帮助现在会显示为空字符串。

• TP: 技术预览
• GA: 正式发行

• 自定义任务有以下改进：

  • Pipeline 结果现在可以引用自定义任务生成的结果。
  • 自定义任务现在可以使用工作区、服务帐户和 pod 模板来构建更复杂的自定义任务。

• finally 的任务包括以下改进：

  • 在 finally 任务中支持 when 表达式，它可以有效地保证执行，并提高了任务的可重复使用性。

  • finally 任务可以被配置为消耗同一管道中任何任务的结果。

    注意

    OpenShift Container Platform 4.7 web 控制台中不支持 when 表达式和 finally 任务。

• 添加了对 dockercfg 或 dockerconfigjson 类型的多个 secret 的支持，以便在运行时进行身份验证。
• 添加支持 git-clone 任务的 sparse-checkout 的功能。这可让您将存储库的子集克隆为本地副本，并帮助您限制克隆的存储库的大小。
• 您可以创建管道以待处理状态运行，而无需实际启动它们。在负载非常重的集群中，这允许 Operator 控制管道运行的开始时间。
• 确保为控制器手动设置 SYSTEM_NAMESPACE 环境变量 ; 这在之前被默认设置。
• 现在，一个非 root 用户被添加到管道的构建基础镜像中，以便 git-init 能够以非 root 用户身份克隆存储库。
• 支持在管道运行启动前在已解析的资源间验证依赖项。管道中的所有结果变量都必须有效，管道中的可选工作区只能传递给期望管道启动运行的任务。
• controller 和 Webhook 作为非 root 组运行，并且删除了它们的多余功能，以使它们更加安全。
• 您可以使用 tkn pr logs 命令查看重试任务运行的日志流。
• 您可以使用 tkn tr delete 命令中的 --clustertask 选项删除与特定集群任务关联的所有任务。
• 通过引入一个新的 customResource 字段，增加了对在 EventListener 资源中使用 Knative 服务的支持。
• 当事件有效负载没有使用 JSON 格式时，会显示错误消息。
• 源控制拦截器（如 GitLab、BitBucket 和 GitHub）现在使用新的 InterceptorRequest 或 InterceptorResponse 类型的接口。
• 新的 CEL 功能 marsagingJSON 被实现，以便您可以将 JSON 对象或数组编码到字符串。
• 为 CEL 添加了 HTTP 处理器，并添加了源控制内核拦截器。它将四个核心拦截器打包到单一 HTTP 服务器中，该服务器部署在 tekton-pipelines 命名空间中。EventListener 对象通过 HTTP 服务器将事件转发到拦截器。每个拦截器都位于不同的路径。例如，CEL 拦截器位于 /cel 路径中。

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

  fsGroup:
    type: MustRunAs

• 不支持 pipeline 资源存储中的 build-gcs 子类型和 gcs-fetcher 镜像。
• 在集群任务的 TaskRun 字段中，删除标签 tekton.dev/task。
• 对于 webhook，移除了与字段 admissionReviewVersions 对应的 v1beta1 值。
• 用于构建和部署的 creds-init 帮助程序镜像已被删除。

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

  注意

  从 Pipelines 1.3.x 和早期版本升级到 Pipelines 1.4.0 会中断事件监听程序，因为 template.name 字段不可用。在这种情况下，使用 Pipelines 1.4.1 来提供恢复的 template.name 字段。

• 对于 EventListener 自定义资源/对象，PodTemplate 和 ServiceType 字段已弃用，并使用 Resource 替代。
• 过时的 spec 风格内嵌绑定已被删除。
• spec 字段已从 triggerSpecBinding 中删除。
• 事件 ID 已从包括五个字符的随机字符串改为 UUID。

• 在 Developer 视角中，管道指标和触发器功能仅适用于 OpenShift Container Platform 4.7.6 或更高版本。
• 在 IBM Power Systems、IBM Z 和 LinuxONE 中，不支持 tkn hub 命令。
• 当您在 IBM Power Systems（ppc64le）、IBM Z 和 LinuxONE（s390x）集群上运行 Maven 和 Jib Maven 集群任务时，将 MAVEN_IMAGE 参数值设置为 maven:3.6.3-adoptopenjdk-11。

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

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

  要解决这个问题：

  • 如果您使用触发器 v0.11.0 及更高版本，请使用 marshalJSON CEL 函数，该函数使用 JSON 对象或数组，并将该对象或数组的 JSON 编码作为字符串返回。

  • 如果使用旧的触发器版本，请在触发器模板中添加以下注解：

    annotations:
      triggers.tekton.dev/old-escape-quotes: "true"

• 当从 Pipelines 1.3.x 升级到 1.4.x 时，您必须重新创建路由。

• 在以前的版本中，tekton.dev/task 标签已从集群任务运行中删除，并且引进了 tekton.dev/clusterTask 标签。此更改导致的问题可以通过修复 clustertask describe 和 delete 命令来解决。另外，也修改了任务的 lastrun 功能，从而解决应用到在旧版管道中运行任务中的 tekton.dev/task 标签的问题。
• 当进行交互式 tkn pipeline start pipelinename 时，会以互动方式创建一个 PipelineResource。如果资源状态不是 nil，tkn p start 命令会输出资源状态。
• 在以前的版本中，tekton.dev/task=name 标签已从集群任务创建的任务中删除。在这个版本中，使用 --last 标志修改 tkn clustertask start 命令，以检查所创建的任务运行中的 tekton.dev/task=name 标签。
• 当任务使用内联任务规格时，在运行 tkn pipeline describe 命令时对应的任务运行会被嵌入到管道中，任务名称返回为内嵌。
• 修复了 tkn version 命令，显示已安装的 Tekton CLI 工具的版本，无需配置的 kubeConfiguration 命名空间或对集群的访问。
• 如果使用意外的参数或者使用多个参数，则 tkn completion 命令会出错。
• 在以前的版本中，当管道转换为 v1alpha1 版本并恢复到 v1beta1 版本时，带有嵌套在一个管道规格中的 finally 的任务将会丢失那些 finally 任务。修复了转换过程中发生的这个错误，以避免潜在的数据丢失。现在，带有嵌套在管道规格中的 finally 任务的管道运行会被序列化并存储在 alpha 版本中，它们只会在以后进行反序列化。
• 在以前的版本中，当服务帐户中的 secrets 字段被设置为 {} 时，pod 生成中会出现一个错误。任务运行失败，显示 CouldntGetTask，因为带有空 secret 名称的 GET 请求返回了一个错误，表示资源名称可能不是空的。这个问题已通过避免 kubeclient GET 请求中的空 secret 名称来解决。
• 现在，可以请求带有 v1beta1 API 版本的管道和 v1alpha1 版本，而不会丢失 finall 任务。应用返回的 v1alpha1 版本将以 v1beta1 来保存资源，finally 部分恢复到其原始状态。
• 在以前的版本中，控制器中的一个未设置的 selfLink 字段在 Kubernetes v1.20 集群中造成错误。作为一个临时修复，在没有自动填充的 selfLink 字段的值时，CloudEvent source 字段被设置为与当前源 URI 匹配的值。
• 在以前的版本中，带有点（如 gcr.io ）的 secret 名称会导致任务运行创建失败。这是因为内部使用的 secret 名称作为卷挂载名称的一部分。卷挂载名称遵循 RFC1123 DNS 标签标准，它不允许使用点作为名称的一部分。这个问题已通过将点替换为横线来解决。
• 现在，上下文变量会在 finally 任务中进行验证。
• 在以前的版本中，当任务运行协调器传递了一个任务运行，且没有之前的状态更新，其中包含它创建的 pod 的名称时，任务运行协调程序会列出与任务运行关联的 pod。任务运行协调程序使用任务运行标签（被传播到 pod）来查找 pod。在任务运行期间更改这些标签，会导致代码找不到现有的 pod。因此，会创建重复的 pod。这个问题已通过在查找 pod 时将任务运行协调器更改为只使用 tekton.dev/taskRun Tekton 控制的标签来解决。
• 在以前的版本中，当管道接受一个可选的工作区并将其传递给管道任务时，如果未提供工作区，管道运行协调器会停止并出错，即使缺少的工作区绑定是可选工作区的有效状态。这个问题已被解决，确保管道运行的协调器不会无法创建任务运行，即使未提供可选的工作区。
• 排序步骤状态的顺序与步骤容器的顺序匹配。
• 在以前的版本中，当 Pod 遇到 CreateContainerConfigError 原因时，任务运行状态被设置为 unknown，这意味着任务和管道会运行，直到 pod 超时为止。这个问题已通过将任务运行状态设置为 false 来解决这个问题，因此当 pod 遇到 CreateContainerConfigError 原因时，任务被设置为 failed。
• 在以前的版本中，管道结果会在管道运行完成后在第一次协调时解析。这可能会导致管道运行的 Succeeded 条件被覆盖。因此，最终状态信息丢失，可能会使监视管道运行条件的任何服务混淆。当管道运行进入 Succeeded 或 True 条件时，这个问题可以通过将管道结果解析移到协调结束时来解决。
• 现在，执行状态变量已被验证。这可避免在验证上下文变量来访问执行状态时验证任务结果。
• 在以前的版本中，包含无效变量的管道结果将添加到管道运行中，并包含变量的字面表达式。因此，很难评估结果是否正确填充。这个问题已通过过滤管道运行结果来解决，该结果引用了失败的任务运行。现在，包含无效变量的管道结果将完全不会被管道运行发送。
• 现在，tkn eventlistener describe 命令已被修复，以避免在没有模板的情况下崩溃。它还显示有关触发器引用的详情。
• 由于 template.name 不可用，从 Pipelines 1.3.x 及早期版本升级到 Pipelines 1.4.0 会破坏事件监听程序。在 Pipelines 1.4.1 中，template.name 已恢复，以避免触发器中的事件监听程序。
• 在 Pipelines 1.4.1 中，ConsoleQuickStart 自定义资源已更新，以符合 OpenShift Container Platform 4.7 的功能和行为。

• Tekton Pipelines 0.19.0
• Tekton tkn CLI 0.15.0
• Tekton Triggers 0.10.2
• 基于 Tekton Catalog 0.19.0 的集群任务
• OpenShift Container Platform 4.7 中的 IBM Power Systems
• OpenShift Container Platform 4.7 上的 IBM Z 和 LinuxONE

• 使用 PipelineResources CRD 的管道模板现已弃用，并将在以后的发行版本中删除。
• template.name 字段已弃用，被 template.ref 字段替代，并将在以后的发行版本中删除。
• 使用 -c 作为 --check 命令的缩写已被删除。另外，全局 tkn 标志被添加到 version 命令中。

• CEL 覆盖在新的顶层 extensions 功能中添加字段，而不是修改传入的事件正文。TriggerBinding 资源可以使用 $(extensions.<key>) 语法访问这个新 extensions 功能中的值。更新您的绑定，使用 $(extensions.<key>) 语法而不是 $(body.<overlay-key>) 语法。
• 把 " 替换为 \" 的参数转义行为现在已被删除。如果您需要保留旧的转义参数行为，请在 TriggerTemplate 规格中添加 tekton.dev/old-escape-quotes: true" 注解。
• 您可以使用触发器中的 name 和 value 字段，或事件监听程序来嵌入 TriggerBinding 资源。但是，您无法为单个绑定指定 name 和 ref 字段。使用 ref 字段引用 TriggerBinding 资源以及内嵌绑定的 name 字段。
• 拦截器无法试图引用 EventListener 资源命名空间以外的 secret。您必须在 'EventListener' 资源的命名空间中包含 secret。
• 在 Triggers 0.9.0 及之后的版本中，如果基于正文或标头的 TriggerBinding 参数在事件有效负载中缺失或格式不正确，则使用默认值而不是显示错误。
• 通过使用 Tekton Pipelines 0.16.x 的 WhenExpression 对象创建的任务和管道必须重新应用来修复它们的 JSON 注解。
• 当管道接受一个可选的工作区，并将其提供给某个任务时，如果未提供工作区，管道会运行停止。
• 要在断开连接的环境中使用 Buildah 集群任务，请确保 Dockerfile 使用作为基础镜像的内部镜像流，然后使用与任何 S2I 集群任务相同的方法。

• CEL 拦截器添加的扩展通过在事件正文中添加 Extensions 字段传递给 Webhook 拦截器。
• 现在，日志读取器的活动超时可以使用 LogOptions 字段进行配置。但是，10 秒的默认超时行为会被保留。
• 当一个任务运行或管道运行完成后，log 命令会忽略 --follow 标记，它会读取可用的日志而不是实时的日志。
• 对以下 Tekton 资源的引用现在标准化，并在 tkn 命令中的所有面向用户的信息中保持一致： EventListener、TriggerBinding、ClusterTriggerBinding、Condition 和 TriggerTemplate。
• 在以前的版本中，如果您启动了使用 --use-taskrun <canceled-task-run-name>、--use-pipelinerun <canceled-pipeline-run-name> 或 --last 标记的、已被取消的任务运行或管道运行，新的运行将会被取消。这个程序漏洞现已解决。
• 现在，tkn pr desc 命令已被改进，以便在管道有条件运行时不会失败。
• 当使用 --task 选项删除使用 tkn tr delete 运行的任务时，且集群任务具有相同名称的集群任务存在时，集群任务运行的任务也会被删除。作为临时解决方案，使用 TaskRefKind 字段过滤运行的任务。
• tkn triggertemplate describe 命令在输出中只会显示 apiVersion 值的一部分。例如，只显示 triggers.tekton.dev，而不是 triggers.tekton.dev/v1alpha1。这个程序漏洞现已解决。
• 在某些情况下，webhook 无法获取租期且无法正常工作。这个程序漏洞现已解决。
• 在 v0.16.3 中创建的带有 when 表达式的管道现在可以在 v0.17.1 及之后的版本中运行。升级后，您不需要重新应用之前版本中创建的管道定义，因为现在支持注解中第一个字母的大写和小写。
• 默认情况下，leader-election-ha 字段为高可用性启用。当 disable-ha 控制器标记设置为 true 时，它会禁用高可用性支持。
• 现在，解决了重复云事件的问题。现在，只有在条件改变状态、原因或消息时才发送云事件。
• 当 PipelineRun 或 TaskRun spec 中没有服务帐户名称时，控制器会使用 config-defaults 配置映射中的服务帐户名称。如果在 config-defaults 配置映射中也缺少服务帐户名称，控制器现在会在 spec 中将其设置为 default。
• 现在，当同一个持久性卷声明用于多个工作区，但具有不同子路径时，支持验证是否与关联性偏好兼容。

• Tekton Pipelines 0.16.3
• Tekton tkn CLI 0.13.1
• Tekton Triggers 0.8.1
• 基于 Tekton Catalog 0.16 的集群任务
• OpenShift Container Platform 4.6 中的 IBM Power Systems
• OpenShift Container Platform 4.6 上的 IBM Z 和 LinuxONE

• $(params) 参数现已从 triggertemplate 资源中删除，由 $(tt.params) 替代，以避免 resourcetemplate 和 triggertemplate 资源参数间的混淆。
• 基于可选的基于 EventListenerTrigger 的身份验证级别的 ServiceAccount 引用，已从对象引用改为一个 ServiceAccountName 字符串。这样可确保 ServiceAccount 引用与 EventListenerTrigger 对象位于同一个命名空间中。
• Conditions 自定义资源定义（CRD）现已弃用，已使用 WhenExpressions CRD 替代。
• PipelineRun.Spec.ServiceAccountNames 对象已启用，被 PipelineRun.Spec.TaskRunSpec[].ServiceAccountName 对象替代。

• 此 Red Hat OpenShift Pipelines 发行版本添加了对断开连接的安装的支持。但是，集群任务使用的一些镜像必须进行镜像（mirror）才能在断开连接的集群中工作。
• 在卸载 Red Hat OpenShift Pipelines Operator 后，openshift 命名空间中的管道不会被删除。使用 oc delete pipelines -n openshift --all 命令删除管道。

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

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

  1. 使用 foregroundDeletion 终结器编辑 EventListener 对象：

     $ oc patch el/<eventlistener_name> -p '{"metadata":{"finalizers":["foregroundDeletion"]}}' --type=merge

     例如：

     $ oc patch el/github-listener-interceptor -p '{"metadata":{"finalizers":["foregroundDeletion"]}}' --type=merge

  2. 删除 EventListener CRD:

     $ oc patch crd/eventlisteners.triggers.tekton.dev -p '{"metadata":{"finalizers":[]}}' --type=merge

• 当您运行多架构容器镜像任务时，如果在 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'

• 现在，添加了一个简单的语法验证用于检查 CEL 过滤器、Webhook 验证器中的覆盖以及拦截器中的表达式。
• 触发器不再覆盖底层部署和服务对象上的注解。
• 在以前的版本中，事件监听器将停止接受事件。EventListener sink 增加了一个 120 秒的空闲超时来解决这个问题。
• 在以前的版本中，取消一个带有 Failed(Canceled) 状态的管道运行会给出一个成功信息。这个问题已被解决，现在在这种情况下会显示错误。
• tkn eventlistener list 命令现在提供列出的事件监听器的状态，从而使您可以轻松地识别可用的事件。
• 现在，当没有安装触发器或没有找到资源时，triggers list 和 triggers describe 命令会显示一致的错误信息。
• 在以前的版本中，在云事件交付过程中会产生大量闲置连接。DisableKeepAlives: true 参数添加到 cloudeventclient 配置来修复这个问题。因此，会为每个云事件设置一个新的连接。
• 在以前的版本中，creds-init 代码也会向磁盘写入空文件，即使未提供给定类型的凭证。在这个版本中，creds-init 代码只为从正确注解的 secret 中挂载的凭证写入文件。

• Tekton Pipelines 0.14.3
• Tekton tkn CLI 0.11.0
• Tekton Triggers 0.6.1
• 基于 Tekton Catalog 0.14 的集群任务

• 所有集群范围命令（包括 clustertask 和 clustertriggerbinding 命令）的 --namespace 或 -n 标志都已弃用。它将在以后的发行版本中被删除。
• 事件监听器中的 triggers.bindings 中的 name 字段已弃用。现在使用 ref 字段替代，并将在以后的发行版本中删除。
• 使用 $(params) 的触发器模板中的变量插值已经被弃用，现在使用 $(tt.params) 来减少与管道变量插入语法的混乱。在以后的发行版本中会删除 $(params.<paramName>) 语法。
• 在集群任务中弃用了 tekton.dev/task 标签。
• TaskRun.Status.ResourceResults.ResourceRef 字段已弃用，并将被删除。
• tkn pipeline create、tkn task create 和 tkn resource create -f 子命令已被删除。
• 从 tkn 命令中删除了命名空间验证。
• tkn ct start 命令中的默认超时时间（1h）以及 -t 标志已被删除。
• s2i 集群任务已弃用。

• 条件（Conditions）不支持工作区。
• tkn clustertask start 命令不支持 --workspace 选项和互动模式。
• 支持 $(params.<paramName>) 语法的向后兼容性会强制您使用带有特定管道参数的触发器模板，因为触发器 s Webhook 无法将触发器参数与管道参数区分开。
• 当针对 tekton_taskrun_count 和 tekton_taskrun_duration_seconds_count 运行一个 promQL 查询时，Pipeline metrics 会报告不正确的值。
• 当为一个工作区指定了一个不存在的 PVC 名称时，管道运行和任务运行会维持在 Running 和 Running(Pending) 的状态。

• 在以前的版本中，如果任务和集群任务的名称是相同的，则 tkn task delete <name> --trs 命令会同时删除 Task 和 ClusterTask。在这个版本中，该命令只删除任务 <name> 创建的任务运行。
• 以前，tkn pr delete -p <name> --keep 2 命令会在使用 --keep 是忽略 -p 标志，并将删除除最后两个以外的所有管道运行。在这个版本中，命令只删除由管道 <name> 创建的管道运行，但最后两个除外。
• tkn triggertemplate describe 输出现在以表格式而不是 YAML 格式显示资源模板。
• 在以前的版本中，当一个新用户添加到容器时，buildah 集群任务会失败。在这个版本中，这个问题已被解决。

• Tekton Pipelines 0.11.3
• Tekton tkn CLI 0.9.0
• Tekton Triggers 0.4.0
• 基于 Tekton Catalog 0.11 的集群任务

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

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

• 以下命令已弃用，并可能在以后的发行版本中删除： tkn pipeline create、tkn task create。
• 在 tkn resource create 命令中使用 -f 标志现已弃用。以后的发行版本中可能会删除它。
• tkn clustertask create 命令中的 -t 标记和 --timeout 标记（使用秒格式）现已被弃用。现在只支持持续超时格式，例如 1h30s。这些已弃用的标记可能会在以后的版本中删除。

• 如果您要从 Red Hat OpenShift Pipelines 的旧版本升级，则必须删除您现有的部署，然后再升级到 Red Hat OpenShift Pipelines 版本 1.0。要删除现有的部署，您必须首先删除自定义资源，然后卸载 Red Hat OpenShift Pipelines Operator。如需了解更多详细信息，请参阅卸载 Red Hat OpenShift Pipelines 部分。
• 提交相同的 v1alpha1 任务多次会导致错误。在重新提交一个 v1alpha1 任务时，使用 oc replace 命令而不是 oc apply。

• 当一个新用户添加到容器时，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：

  1. 以 cluster-admin 身份登录到集群:

     $ oc login -u <login> -p <password> https://openshift.example.com:6443

  2. 使用 oc edit 命令编辑 buildah 集群任务：

     $ oc edit clustertask buildah

     buildah clustertask YAML 文件的最新版本会在由 EDITOR 环境变量指定的编辑器中打开。

  3. 在 Steps 字段中找到以下 command 字段：

      command: ['buildah', 'bud', '--format=$(params.FORMAT)', '--tls-verify=$(params.TLSVERIFY)', '--layers', '-f', '$(params.DOCKERFILE)', '-t', '$(resources.outputs.image.url)', '$(params.CONTEXT)']

  4. 使用以下内容替换 command 字段：

      command: ['buildah', '--storage-driver=overlay', 'bud', '--format=$(params.FORMAT)', '--tls-verify=$(params.TLSVERIFY)', '--no-cache', '-f', '$(params.DOCKERFILE)', '-t', '$(params.IMAGE)', '$(params.CONTEXT)']

  5. 保存文件并退出。

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

• 在以前的版本中，即使镜像构建已在进行中，DeploymentConfig 任务也会触发新的部署构建。这会导致管道部署失败。在这个版本中，deploy task 命令被 oc rollout status 命令替代，它会等待正在进行中的部署完成。
• 现在在管道模板中添加了对 APP_NAME 参数的支持。
• 在以前的版本中，Java S2I 的管道模板无法在 registry 中查找镜像。在这个版本中，使用现有镜像管道资源而不是用户提供的 IMAGE_NAME 参数来查找镜像。
• 所有 OpenShift Pipelines 镜像现在都基于 Red Hat Universal Base Images（UBI）。
• 在以前的版本中，当管道在 tekton-pipelines 以外的命名空间中安装时，tkn version 命令会将管道版本显示为 unknown 。在这个版本中，tkn version 命令会在任意命名空间中显示正确的管道版本。
• tkn version 命令不再支持 -c 标志。
• 非管理员用户现在可以列出集群触发器绑定。
• 现在为 CEL 拦截器修复了事件监听程序 CompareSecret 功能。
• 现在，当任务和集群任务的名称相同时，任务和集群任务的 list、describe 和 start 子命令可以正确地显示输出。
• 在以前的版本中，OpenShift Pipelines Operator 修改了特权安全性上下文约束 (SCC)，这会在集群升级过程中造成错误。这个错误现已解决。
• 在 tekton-pipelines 命名空间中，现在将所有任务运行和管道运行的超时设置为使用配置映射的 default-timeout-minutes 字段。
• 在以前的版本中，Web 控制台中的管道部分没有为非管理员用户显示。这个问题现已解决。

• input：指定静态输入或变量，如参数、任务结果和执行状态。您必须输入有效的输入。如果没有输入有效输入，则其值默认为空字符串。
• operator：指定一个输入与一组 values 的关系。输入 in 或 notin 作为 operator 的值。
• values：指定字符串值的数组。输入由静态值或变量组成的非空数组，如参数、结果和工作空间的绑定状态。

• 上一任务的结果如预期所示。
• 之前的提交中更改了 Git 存储库中的文件。
• 镜像是否存在于 registry 中。
• 有可选的工作区可用。

• 所有条件都满足：任务和 when 表达式符号（以钻石形表示）为绿色。
• 有任何一个条件不符合：任务被跳过。跳过的任务和 when 表达式符号为灰色。
• 未满足任何条件：任务被跳过。跳过的任务和 when 表达式符号为灰色。
• 任务运行失败：失败的任务和 when 表达式符号为红色。

• 存储任务输入和输出
• 任务间共享数据
• 使用它作为 Secret 中持有的凭证的挂载点
• 使用它作为 ConfigMap 中保存的配置的挂载点
• 使用它作为机构共享的通用工具的挂载点
• 创建可加快作业的构建工件缓存

• 只读 ConfigMap 或 Secret
• 与其他任务共享的现有 PersistentVolumeClaim
• 来自提供的 VolumeClaimTemplate 的 PersistentVolumeClaim
• TaskRun 完成后丢弃的 emptyDir

• TriggerBinding 资源从事件有效负载中提取字段，并将它们保存为参数。

  以下示例显示了 TriggerBinding 资源的代码片段,它从接收的事件有效负载中提取 Git 存储库信息：

  apiVersion: triggers.tekton.dev/v1alpha1 1
  kind: TriggerBinding 2
  metadata:
    name: vote-app 3
  spec:
    params: 4
    - name: git-repo-url
      value: $(body.repository.url)
    - name: git-repo-name
      value: $(body.repository.name)
    - name: git-revision
      value: $(body.head_commit.id)

  1

  TriggerBinding 资源的 API 版本。在本例中，v1alpha1。

  2

  指定 Kubernetes 对象的类型。在本例中，TriggerBinding。

  3

  用于标识 TriggerBinding 资源的唯一名称。

  4

  从接收的事件有效负载中提取并传递给 TriggerTemplate 的参数列表。在本例中，Git 仓库 URL、名称和修订版本是从事件有效负载主体中提取的。

• TriggerTemplate 资源充当创建资源的方式标准。它指定了 TriggerBinding 资源中参数化数据的方式。触发器模板从触发器绑定接收输入，然后执行一系列操作来创建新管道资源，并启动新管道运行。

  以下示例显示了 TriggerTemplate 资源的代码片段，它使用您刚创建的 TriggerBinding 资源提供的 Git 存储库信息创建一个管道运行：

  apiVersion: triggers.tekton.dev/v1alpha1 1
  kind: TriggerTemplate 2
  metadata:
    name: vote-app 3
  spec:
    params: 4
    - name: git-repo-url
      description: The git repository url
    - name: git-revision
      description: The git revision
      default: pipelines-1.5
    - name: git-repo-name
      description: The name of the deployment to be created / patched
  
    resourcetemplates: 5
    - apiVersion: tekton.dev/v1beta1
      kind: PipelineRun
      metadata:
        name: build-deploy-$(tt.params.git-repo-name)-$(uid)
      spec:
        serviceAccountName: pipeline
        pipelineRef:
          name: build-and-deploy
        params:
        - name: deployment-name
          value: $(tt.params.git-repo-name)
        - name: git-url
          value: $(tt.params.git-repo-url)
        - name: git-revision
          value: $(tt.params.git-revision)
        - name: IMAGE
          value: image-registry.openshift-image-registry.svc:5000/pipelines-tutorial/$(tt.params.git-repo-name)
        workspaces:
        - name: shared-workspace
          volumeClaimTemplate:
           spec:
            accessModes:
             - ReadWriteOnce
            resources:
              requests:
                storage: 500Mi

  1

  TriggerTemplate 资源的 API 版本。在本例中，v1alpha1。

  2

  指定 Kubernetes 对象的类型。在本例中，TriggerTemplate。

  3

  用于标识 TriggerTemplate 资源的唯一名称。

  4

  TriggerBinding 资源提供的参数。

  5

  指定使用 TriggerBinding 或 EventListener 资源接收的参数创建资源方法的模板列表。

• Trigger 资源组合了 TriggerBinding 和 TriggerTemplate 资源，以及可选的 interceptors 事件处理器。

  拦截器会处理在 TriggerBinding 资源之前运行的特定平台的所有事件。您可以使用拦截器过滤载荷，验证事件，定义和测试触发器条件，以及实施其他有用的处理。拦截器使用 secret 进行事件验证。在事件数据穿过拦截器后，在将有效负载数据传递给触发器之前，它会被发送到触发器。您还可以使用拦截器修改 EventListener 规格中引用的关联触发器的行为。

  以下示例显示了一个 Trigger 资源的代码片段，名为 vote-trigger，它连接 TriggerBinding 和 TriggerTemplate 资源，以及 interceptors 事件处理器。

  apiVersion: triggers.tekton.dev/v1alpha1 1
  kind: Trigger 2
  metadata:
    name: vote-trigger 3
  spec:
    serviceAccountName: pipeline 4
    interceptors:
      - ref:
          name: "github" 5
        params: 6
          - name: "secretRef"
            value:
              secretName: github-secret
              secretKey: secretToken
          - name: "eventTypes"
            value: ["push"]
    bindings:
      - ref: vote-app 7
    template: 8
       ref: vote-app
  ---
  apiVersion: v1
  kind: Secret 9
  metadata:
    name: github-secret
  type: Opaque
  stringData:
    secretToken: "1234567"

  1

  Trigger 资源的 API 版本。在本例中，v1alpha1。

  2

  指定 Kubernetes 对象的类型。在本例中, Trigger。

  3

  用于标识 Trigger 资源的唯一名称。

  4

  要使用的服务帐户名称。

  5

  要被引用的拦截器名称。在本例中，是 github。

  6

  要指定的参数.

  7

  连接到 TriggerTemplate 资源的 TriggerBinding 资源的名称。

  8

  连接到 TriggerBinding 资源的 TriggerTemplate 资源的名称。

  9

  用于验证事件的 Secret。

• EventListener 资源提供一个端点或事件接收器（sink），用于使用 JSON 有效负载侦听传入的基于 HTTP 的事件。它从每个 TriggerBinding 资源提取事件参数，然后处理此数据以按照对应的 TriggerTemplate 资源指定的 Kubernetes 资源创建 Kubernetes 资源。EventListener 资源还使用事件 interceptors（拦截器） 在有效负载上执行轻量级事件处理或基本过滤，这可识别有效负载类型并进行自选修改。目前，管道触发器支持五种拦截器：Webhook Interceptors, GitHub 拦截器、GitLab 拦截器、Bitbucket 拦截器 和 Common Expression Language (CEL) 拦截器。

  以下示例显示了一个 EventListener 资源，它引用名为 vote-trigger 的 Trigger 资源。

  apiVersion: triggers.tekton.dev/v1alpha1 1
  kind: EventListener 2
  metadata:
    name: vote-app 3
  spec:
    serviceAccountName: pipeline 4
    triggers:
      - triggerRef: vote-trigger 5

  1

  EventListener 资源的 API 版本。在本例中，v1alpha1。

  2

  指定 Kubernetes 对象的类型。在本例中，EventListener。

  3

  用于标识 EventListener 资源的唯一名称。

  4

  要使用的服务帐户名称。

  5

  EventListener 资源引用的 Trigger 资源的名称。