Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 4 章 Pipelines

4.1. Red Hat OpenShift Pipelines 发行注记
复制链接

Red Hat OpenShift Pipelines 是基于 Tekton 项目的一个云原生 CI/CD 环境，它提供：

  • 标准 Kubernetes 原生管道定义 (CRD)。
  • 无需 CI 服务器管理开销的无服务器管道。
  • 使用任何 Kubernetes 工具（如 S2I、Buildah、JIB 和 Kaniko）构建镜像。
  • 不同 Kubernetes 发布系统间的可移植性。
  • 用于与管道交互的强大 CLI。
  • 使用 OpenShift Container Platform Web 控制台的 Developer 视角集成用户体验。

如需了解 Red Hat OpenShift Pipelines 的概述，请参阅了解 OpenShift Pipelines。

4.1.1. 兼容性和支持列表
复制链接

这个版本中的一些功能当前还只是一个技术预览。它们并不适用于在生产环境中使用。

在下表中，被标记为以下状态的功能：

TP

技术预览

GA

公开发行

Expand
表 4.1. 兼容性和支持列表
Red Hat OpenShift Pipelines 版本组件版本OpenShift 版本支持状态

Operator

Pipelines

触发器

CLI

目录

链

Hub

Pipelines 作为代码

  

1.10

0.44.x

0.23.x

0.30.x

不适用

0.15.x (TP)

1.12.x (TP)

0.17.x (GA)

4.10, 4.11, 4.12, 4.13

GA

1.9

0.41.x

0.22.x

0.28.x

不适用

0.13.x (TP)

1.11.x (TP)

0.15.x (GA)

4.10, 4.11, 4.12, 4.13

GA

1.8

0.37.x

0.20.x

0.24.x

不适用

0.9.0 (TP)

1.8.x (TP)

0.10.x (TP)

4.10, 4.11, 4.12

GA

1.7

0.33.x

0.19.x

0.23.x

0.33

0.8.0 (TP)

1.7.0 (TP)

0.5.x (TP)

4.9, 4.10, 4.11

GA

1.6

0.28.x

0.16.x

0.21.x

0.28

N/A

N/A

N/A

4.9

GA

1.5

0.24.x

0.14.x (TP)

0.19.x

0.24

N/A

N/A

N/A

4.8

GA

1.4

0.22.x

0.12.x (TP)

0.17.x

0.22

N/A

N/A

N/A

4.7

GA

另外，在 ARM 硬件上运行 Red Hat OpenShift Pipelines 当前只是一个技术预览。

如果您有疑问或希望提供反馈信息，请向产品团队发送邮件 pipelines-interest@redhat.com。

4.1.2. 使开源包含更多
复制链接

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。我们从这四个术语开始：master、slave、黑名单和白名单。由于此项工作十分艰巨，这些更改将在即将推出的几个发行版本中逐步实施。有关更多详情，请参阅我们的首席技术官 Chris Wright 提供的消息。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.10 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.3.1. 新功能
复制链接

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.10 中的新内容。

4.1.3.1.1. Pipelines
复制链接
  • 在这个版本中，您可以在 PipelineRun 或 TaskRun pod 模板中指定环境变量来覆盖或附加任务或步骤中配置的变量。另外，您可以在默认 pod 模板中指定环境变量，以对所有 PipelineRuns 和 TaskRuns 全局使用这些变量。在这个版本中，添加了一个名为 forbidden-envs 的新默认配置来过滤环境变量，同时从 pod 模板传播。

  • 在这个版本中，管道中的自定义任务会被默认启用。

    注意

    要禁用此次更新，请在 feature-flags 配置自定义资源中将 enable-custom-tasks 标志设置为 false。

  • 在这个版本中，支持 v1beta1.CustomRun API 版本进行自定义任务。

  • 在这个版本中，增加了对 PipelineRun reconciler 的支持，以创建自定义运行。例如，从 PipelineRuns 创建的自定义 TaskRuns 现在可以使用 v1beta1.CustomRun API 版本而不是 v1alpha1.Run，如果 custom-task-version 功能标记被设置为 v1beta1，而不是默认值 v1alpha1。

    注意

    您需要更新自定义任务控制器，以侦听 *v1beta1.CustomRun API 版本，而不是 *v1alpha1.Run 以响应 v1beta1.CustomRun 请求。

  • 在这个版本中，在 v1beta1.TaskRun 和 v1.TaskRun 规格中添加了一个新的 retries 字段。
4.1.3.1.2. 触发器
复制链接
  • 在这个版本中，触发器支持创建 v1 API 版本的 Pipelines, Tasks, PipelineRuns, 和 TaskRuns 对象，以及 v1beta1 API 版本的 CustomRun 对象。

  • 在这个版本中，GitHub Interceptor 会阻止执行拉取请求触发器，除非由拥有者调用或所有者使用可配置的注释。

    注意

    要启用或禁用此更新，请在 GitHub Interceptor 配置文件中将 githubOwners 参数的值设置为 true 或 false。

  • 在这个版本中，GitHub Interceptor 能够添加以逗号分隔的、用于推送和拉取请求事件更改的所有文件的列表。更改的文件列表添加到顶层 extensions 字段中事件有效负载的 changed_files 属性中。
  • 在这个版本中，TLS 的 MinVersion 改为 tls.VersionTLS12，以便在启用了联邦信息处理标准 (FIPS) 模式时在 OpenShift Container Platform 上运行触发器。
4.1.3.1.3. CLI
复制链接
  • 在这个版本中，增加了对在启动一个 Task, ClusterTask 或 Pipeline 时传递一个 CSI（Container Storage Interface）文件作为工作区的功能。
  • 在这个版本中，为与任务、管道运行和任务运行资源关联的所有 CLI 命令添加了 v1 API 支持。Tekton CLI 适用于这些资源的 v1beta1 和 v1 API。
  • 在这个版本中，增加了对 start 和 describe 命令中的对象类型参数的支持。
4.1.3.1.4. Operator
复制链接
  • 在这个版本中，在可选管道属性中添加了 default-forbidden-env 参数。参数包括禁止的环境变量，在通过 pod 模板提供时不应传播它们。
  • 在这个版本中，增加了对 Tekton Hub UI 中的自定义徽标的支持。要添加自定义徽标，请在 Tekton Hub CR 中将 customLogo 参数的值设置为 base64 编码 URI。
  • 在这个版本中，git-clone 任务的版本号增加到 0.9。
4.1.3.1.5. Tekton Chains
复制链接
重要

Tekton 链只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，在测试时为 PipelineRun 和 TaskRun 添加注解和标签。
  • 此更新添加了一个名为 slsa/v1 的新格式，它生成与以 in-toto 格式请求时生成的相同度。
  • 在这个版本中，Sigstore 功能从实验性功能中移出。
  • 在这个版本中，predicate.materials 函数包括来自 TaskRun 对象的所有步骤和 sidecar 的镜像 URI 和摘要信息。
4.1.3.1.6. Tekton Hub
复制链接
重要

Tekton Hub 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，支持在集群中安装、升级或降级 v1 API 版本的 Tekton 资源。
  • 在这个版本中，支持添加自定义徽标来代替 UI 中的 Tekton Hub 徽标。
  • 在这个版本中，对 tkn hub install 命令进行了扩展，增加了一个 --type artifact 标记，它会从 Artifact Hub 获取资源并将其安装到集群中。
  • 在这个版本中，增加了将 tier, catalog, 和 org 的信息作为标签添加到从 Artifact Hub 安装到您的集群中的资源的支持。
4.1.3.1.7. Pipelines 作为代码（Pipelines as Code）
复制链接
  • 这个版本增强了传入的 Webhook 支持。对于在 OpenShift Container Platform 集群上安装的 GitHub 应用程序，您不需要为传入的 webhook 提供 git_provider 规格。相反，Pipelines as Code 会检测 secret，并将其用于传入的 Webhook。
  • 在这个版本中，您可以使用同一令牌从带有非默认分支的 GitHub 上的同一主机获取远程任务。
  • 在这个版本中，Pipelines 作为代码支持 Tekton v1 模板。您可以使用 v1 和 v1beta1 模板，Pipelines 作为 PR 生成的代码读取。PR 在集群上以 v1 的形式创建。
  • 在此次更新之前，当 OpenShift 命名空间中找不到运行时模板时，OpenShift 控制台 UI 将使用硬编码的管道运行模板作为回退模板。在这个版本中，pipelines-as-code 配置映射中提供了一个新的默认管道运行模板，名为 pipelines-as-code-template-default 供控制台使用。
  • 在这个版本中，Pipelines as Code 支持 Tekton Pipelines 0.44.0 最小状态。
  • 在这个版本中，Pipelines as Code 支持 Tekton v1 API，这意味着 Pipelines as Code 现在与 Tekton v0.44 及更新的版本兼容。
  • 在这个版本中，除了为 OpenShift 和 Tekton 仪表板为 k8s 配置控制台外，您还可以配置自定义控制台仪表板。
  • 在这个版本中，Pipelines as Code 会检测使用 tkn pac create repo 命令启动的 GitHub 应用程序的安装，如果全局安装，则不需要 GitHub Webhook。
  • 在此次更新之前，如果 PipelineRun 执行出现错误，而不是附加到 PipelineRun 的任务，Pipelines as Code 无法正确报告失败。在这个版本中，Pipelines as Code 会在无法创建 PipelineRun 时在 GitHub 检查中正确报告错误。
  • 在这个版本中，Pipelines as Code 包含一个 target_namespace 变量，它扩展至执行 PipelineRun 的当前运行命名空间。
  • 在这个版本中，Pipelines 作为代码可让您绕过 CLI bootstrap GitHub 应用程序中的 GitHub Enterprise 问题。
  • 在这个版本中，当找不到存储库 CR 时，Pipelines as Code 不会报告错误。
  • 在这个版本中，如果找到多个管道使用相同名称运行，Pipelines as Code 会报告一个错误。

4.1.3.2. 可能会造成问题的更改
复制链接

  • 在这个版本中，tkn 命令的早期版本与 Red Hat OpenShift Pipelines 1.10 不兼容。
  • 在这个版本中，从 Tekton CLI 删除了对 Cluster 和 CloudEvent 管道资源的支持。您不能使用 tkn pipelineresource create 命令创建管道资源。另外，任务、集群任务或管道的 start 命令中不再支持管道资源。
  • 在这个版本中，从 Tekton 链中删除 tekton 作为公认格式。

4.1.3.3. 弃用和删除的功能
复制链接

  • 在 Red Hat OpenShift Pipelines 1.10 中，ClusterTask 命令现已弃用，计划在以后的发行版本中删除。此更新中还弃用了 tkn task create 命令。
  • 在 Red Hat OpenShift Pipelines 1.10 中，tkn task start 命令中使用的标记 -i 和 -o 现已弃用，因为 v1 API 不支持管道资源。
  • 在 Red Hat OpenShift Pipelines 1.10 中，tkn pipeline start 命令一起使用的标志 -r 已被弃用，因为 v1 API 不支持管道资源。
  • Red Hat OpenShift Pipelines 1.10 更新将 openshiftDefaultEmbeddedStatus 参数设置为 both，带有 full 和 minimal 嵌入式状态。更改默认嵌入式状态的标记也已弃用，并将被删除。另外，管道默认嵌入式状态将在以后的版本中更改为 minimal。

4.1.3.4. 已知问题
复制链接

  • 这个版本包括以下向后兼容的更改：

    • 删除 PipelineResources 集群
    • 删除 PipelineResources 云事件

  • 如果在集群升级后管道指标功能无法正常工作，请运行以下命令作为临时解决方案： 

    $ oc get tektoninstallersets.operator.tekton.dev | awk '/pipeline-main-static/ {print $1}' | xargs oc delete tektoninstallersets
    Copy to Clipboard Toggle word wrap
  • 在这个版本中，IBM Power、IBM Z 和 {linuxoneProductName} 不支持使用外部数据库，如 Crunchy PostgreSQL。反之，使用默认的 Tekton Hub 数据库。

4.1.3.5. 修复的问题
复制链接

  • 在此次更新之前，opc pac 命令会生成一个运行时错误，而不是显示任何帮助。在这个版本中修复了 opc pac 命令来显示帮助信息。
  • 在此次更新之前，运行 tkn pac create repo 命令创建仓库需要 Webhook 详情。在这个版本中，tkn-pac create repo 命令在安装 GitHub 应用程序时不会配置 Webhook。
  • 在此次更新之前，当 Tekton Pipelines 创建 PipelineRun 资源时遇到问题时，Pipelines as Code 不会报告管道运行创建错误。例如，管道运行中的不存在的任务不会显示任何状态。在这个版本中，Pipelines as Code 显示来自 Tekton Pipelines 的正确错误消息以及缺少的任务。
  • 在这个版本中，UI 页面在成功身份验证后重定向。现在，您会被重定向到您试图登录到 Tekton Hub 的同一页面。
  • 在这个版本中修复了带有标志 --all-namespaces 和 --output=yaml 的 list 命令，用于集群任务、单个任务和管道。
  • 在这个版本中，删除了 repo.spec.url URL 末尾的正斜杠，使其与来自 GitHub 的 URL 匹配。
  • 在此次更新之前，marshalJSON 函数不会编译对象列表。在这个版本中，marshalJSON 函数会对对象列表进行 marshals 处理。
  • 在这个版本中，Pipelines 作为代码可让您绕过 CLI bootstrap GitHub 应用程序中的 GitHub Enterprise 问题。
  • 在这个版本中，当您的存储库有超过 100 个用户时，GitHub collaborator 会检查。
  • 在这个版本中，任务或管道的 sign 和 verify 命令现在可以在没有 kubernetes 配置文件的情况下正常工作。
  • 在这个版本中，如果在命名空间中跳过修剪器，Tekton Operator 会清理保留的修剪器 cron 作业。
  • 在此次更新之前，API ConfigMap 对象不会更新为目录刷新间隔配置的值。在这个版本中修复了 Tekon Hub CR 中的 CATALOG_REFRESH_INTERVAL API。

  • 在这个版本中，在更改 EmbeddedStatus 功能标记时，PipelineStatus 的协调已被修复。在这个版本中重置以下参数：

    • status.runs 和 status.taskruns 参数为 nil，带有 minimal EmbeddedStatus
    • status.childReferences 参数为 nil，带有 full EmbeddedStatus
  • 在这个版本中，添加了一个到 ResolutionRequest CRD 的转换配置。在这个版本中，可以正确地配置从 v1alpha1.ResolutionRequest 请求到 v1beta1.ResolutionRequest 请求的转换。
  • 在这个版本中会检查与一个管道任务关联的重复工作区。
  • 在这个版本中修复了在代码中启用解析器的默认值。
  • 在这个版本中，使用解析器修复了 TaskRef 和 PipelineRef 名称转换的问题。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.10.1 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.3.6.1. 修复了 Pipelines as Code 的问题
复制链接
  • 在此次更新之前，如果来自有效负载的源分支信息包含 refs/heads/，但用户配置的目标分支仅包含分支名称，main 在 CEL 表达式中，推送请求将失败。在这个版本中，Pipelines as Code 会传递推送请求，并在有效负载中基本分支或目标分支具有 refs/heads/ 时触发管道。
  • 在此次更新之前，当无法创建 PipelineRun 对象时，从 Tekton 控制器接收的错误不会被报告给用户。在这个版本中，Pipelines as Code 会向 GitHub 界面报告错误消息，以便用户可以对错误进行故障排除。Pipelines as Code 还会报告管道执行过程中发生的错误。
  • 在这个版本中，当因为基础架构问题而无法在 OpenShift Container Platform 集群中创建 secret 时，Pipelines as Code 不会将 secret 回滚到 GitHub 检查接口。
  • 在这个版本中，删除了从 Red Hat OpenShift Pipelines 不再使用的已弃用的 API。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.10.2 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.3.7.1. 修复的问题
复制链接

在此次更新之前，Tekton Operator 中的一个问题会阻止用户将 enable-api-fields 标志的值设置为 beta。在这个版本中解决了这个问题。现在，您可以在 TektonConfig CR 中将 enable-api-fields 标志的值设置为 beta。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.10.3 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.3.8.1. 修复的问题
复制链接

在此次更新之前，Tekton Operator 不会公开任何自定义的性能配置字段。在这个版本中，作为集群管理员，您可以根据您的需要自定义 TektonConfig CR 中的以下性能配置字段：

  • disable-ha
  • bucket
  • kube-api-qps
  • kube-api-burst
  • threads-per-controller

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.10.4 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.3.9.1. 修复的问题
复制链接
  • 在这个版本中解决了管道运行中的 PipelineRef 字段的捆绑包解析器转换问题。现在，转换功能会在转换后将 kind 字段的值设置为 Pipeline 。
  • 在此次更新之前，pipelinerun.timeouts 字段被重置为 timeout.pipeline 值，忽略 timeout.tasks 和 timeout.finally 值。在这个版本中解决了这个问题，并为 PipelineRun 资源设置正确的默认超时值。
  • 在此次更新之前，控制器日志包含不必要的数据。在这个版本中解决了这个问题。

在这个版本中，除了 4.11、4.12 和 4.13 外，Red Hat OpenShift Pipelines 正式发布 (GA) 1.10.5 包括在 OpenShift Container Platform 4.10 中。

重要

Red Hat OpenShift Pipelines 1.10.5 仅适用于 OpenShift Container Platform 4.10、4.11、4.12 和 4.13 上的 pipelines-1.10 频道。它不适用于任何 OpenShift Container Platform 版本的 latest 频道。

4.1.3.10.1. 修复的问题
复制链接
  • 在此次更新之前，使用 oc 和 tkn 命令无法列出或删除大型管道运行。在这个版本中，通过压缩导致这个问题的巨页注解解决了这个问题。请注意，如果管道运行在压缩后仍然太大，则还会出现同样的错误。
  • 在此次更新之前，只有 pipelineRun.spec.taskRunSpecs[].podTemplate 对象中指定的 pod 模板才会被视为管道运行。在这个版本中，pipelineRun.spec.podTemplate 对象中指定的 pod 模板也会被考虑，并与 pipelineRun.spec.taskRunSpecs[].podTemplate 对象中指定的模板合并。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.9 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.4.1. 新功能
复制链接

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.9 中的新内容。

4.1.4.1.1. Pipelines
复制链接
  • 在这个版本中，您可以指定管道参数，并产生数组和对象字典形式。
  • 在这个版本中，为您的工作区提供 Container Storage Interface (CSI) 和投射卷支持。
  • 在这个版本中，您可以在定义管道步骤时指定 stdoutConfig 和 stderrConfig 参数。定义这些参数有助于将标准输出和标准错误（与步骤相关联）捕获到本地文件。
  • 在这个版本中，您可以在 steps[].onError 事件处理程序中添加变量，例如 $(params.CONTINUE)。
  • 在这个版本中，您可以使用 PipelineResults 定义中的 finally 任务的输出。例如，$(finally.<pipelinetask-name>.result.<result-name>)，其中 <pipelinetask-name> 代表管道任务名称，<result-name> 代表结果名称。
  • 在这个版本中，支持任务运行的任务级资源要求。
  • 在这个版本中，您不需要根据名称重新创建在管道和定义的任务之间共享的参数。这个版本是开发人员预览功能的一部分。
  • 在这个版本中，增加了对远程解析的支持，如内置 git、集群、捆绑包和 hub 解析器。
4.1.4.1.2. 触发器
复制链接
  • 在这个版本中，添加了 Interceptor CRD 来定义 NamespacedInterceptor。您可以在触发器的拦截器引用的 kind 部分，或 EventListener 规格中使用 NamespacedInterceptor。
  • 这个版本启用了 CloudEvents。
  • 在这个版本中，您可以在定义触发器时配置 Webhook 端口号。
  • 在这个版本中，支持使用触发器 eventID 作为 TriggerBinding 的输入。

  • 在这个版本中，支持为 ClusterInterceptor 服务器验证和轮转证书。 

    • 触发器对核心拦截器执行证书验证，并在其证书过期时将新证书轮转到 ClusterInterceptor。
4.1.4.1.3. CLI 
复制链接
  • 在这个版本中，支持在 describe 命令中显示注释。
  • 此更新支持在 pr describe 命令中显示管道、任务和超时。
  • 在这个版本中，添加了在 pipeline start 命令中提供管道、任务和超时的标志。
  • 在这个版本中，支持在任务和管道的 describe 命令中显示工作区（可选或强制）存在。
  • 在这个版本中，添加了 timestamp 标记来显示带有时间戳的日志。
  • 在这个版本中，添加了一个新的标记 --ignore-running-pipelinerun，它会忽略删除与 PipelineRun 关联的 TaskRun。
  • 在这个版本中，增加了对实验性命令的支持。在这个版本中，对 tkn CLI 工具增加了实验性的子命令 sign 和 verify。
  • 在这个版本中，Zsh (Zsh) 完成功能可在不生成任何文件的情况下使用。

  • 此更新引入了一个名为 opc 的新 CLI 工具。预计即将推出的发行版本会将 tkn CLI 工具替换为 opc。

    重要
    • 新的 CLI 工具 opc 是一个技术预览功能。
    • opc 将是一个带有额外 Red Hat OpenShift Pipelines 特定功能的 tkn 的替代，这些功能不一定适合 tkn。
4.1.4.1.4. Operator
复制链接

  • 在这个版本中，Pipelines as Code 会被默认安装。您可以使用 -p 标志禁用 Pipelines as Code: 

    $ oc patch tektonconfig config --type="merge" -p '{"spec": {"platforms": {"openshift":{"pipelinesAsCode": {"enable": false}}}}}'
    Copy to Clipboard Toggle word wrap
  • 在这个版本中，您还可以在 TektonConfig CRD 中修改 Pipelines 作为代码配置。
  • 在这个版本中，如果禁用了开发人员视角，Operator 不会安装与开发人员控制台相关的自定义资源。
  • 在这个版本中，包括对 Bitbucket 服务器和 Bitbucket 云的 ClusterTriggerBinding 支持，可帮助您在整个集群中重复使用 TriggerBinding 。
4.1.4.1.5. 解析器
复制链接
重要

解析器只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，您可以在 TektonConfig CRD 中配置管道解析器。您可以启用或禁用这些管道解析器： enable-bundles-resolver,enable-cluster-resolver,enable-git-resolver, 和 enable-hub-resolver。 

    apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  pipeline:
    enable-bundles-resolver: true
    enable-cluster-resolver: true
    enable-git-resolver: true
    enable-hub-resolver: true
...
    Copy to Clipboard Toggle word wrap

    您还可以在 TektonConfig 中提供特定于解析器的配置。例如，您可以使用 map[string]string 格式定义以下字段来为单个解析器设置配置： 

    apiVersion: operator.tekton.dev/v1alpha1
kind: TektonConfig
metadata:
  name: config
spec:
  pipeline:
    bundles-resolver-config:
      default-service-account: pipelines
    cluster-resolver-config:
      default-namespace: test
    git-resolver-config:
      server-url: localhost.com
    hub-resolver-config:
      default-tekton-hub-catalog: tekton
...
    Copy to Clipboard Toggle word wrap
4.1.4.1.6. Tekton Chains
复制链接
重要

Tekton 链只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在此次更新之前，只有开放容器项目 (OCI) 镜像可以作为 in-toto provenance 代理的 TaskRun 输出被支持。在这个版本中，通过使用以下后缀增加了 in-toto provenance 元数据作为输出的支持：ARTIFACT_URI 和 ARTIFACT_DIGEST。
  • 在此次更新之前，只支持 TaskRun attestations。在这个版本中，还添加了对 PipelineRun attestations 的支持。
  • 在这个版本中，添加了对 Tekton Chains 的支持，以获取 pod 模板中的 imgPullSecret 参数。在这个版本中，您可以基于每个管道运行或任务运行配置存储库身份验证，而无需修改服务帐户。
4.1.4.1.7. Tekton Hub
复制链接
重要

Tekton Hub 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，作为管理员，您可以使用外部数据库，如带有 Tekton Hub 的 Crunchy PostgreSQL，而不是使用默认的 Tekton Hub 数据库。这个版本可帮助您执行以下操作：

    • 指定用于 Tekton Hub 的外部数据库的协调
    • 禁用 Operator 部署的默认 Tekton Hub 数据库

  • 在这个版本中，config.yaml 从外部 Git 存储库删除依赖项，并将完整的配置数据移到 API ConfigMap 中。这个版本可帮助管理员执行以下操作：

    • 在 Tekton Hub 自定义资源中添加配置数据，如类别、目录、范围和 defaultScope。
    • 修改集群中的 Tekton Hub 配置数据。所有修改都会在 Operator 升级时保留。
    • 更新 Tekton Hub 目录列表

    • 更改 Tekton Hub 的类别

      注意

      如果没有添加任何配置数据，您可以使用 Tekton Hub 配置的 API ConfigMap 中的默认数据。

4.1.4.1.8. Pipelines 作为代码（Pipelines as Code）
复制链接
  • 在这个版本中，增加了对 Repository CRD 中并发限制的支持，以定义一次为仓库运行的最大 PipelineRuns 数。来自拉取请求或推送事件的 PipelineRuns 以字母顺序排列。
  • 在这个版本中，添加了一个新的命令 tkn pac logs，用于显示仓库的最新管道运行的日志。

  • 在这个版本中，支持在文件路径上实现高级事件匹配，以便推送和拉取请求到 GitHub 和 GitLab。例如，只有当一个路径在 docs 目录中的任何 markdown 文件中都更改时，您才可以使用 Common Expression Language (CEL) 来运行管道。 

      ...
  annotations:
     pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && "docs/*.md".pathChanged()
    Copy to Clipboard Toggle word wrap
  • 在这个版本中，您可以使用注解在 pipelineRef: 对象中引用远程管道。
  • 在这个版本中，您可以使用 Pipelines 作为代码自动配置新的 GitHub 仓库，它会设置命名空间并为 GitHub 仓库创建 Repository CRD。
  • 在这个版本中，Pipelines 作为代码为 PipelineRuns 生成指标，并带有供应商信息。

  • 在这个版本中，为 tkn-pac 插件提供以下改进：

    • 正确检测运行的管道
    • 修复了在没有失败完成时间显示持续时间的修复
    • 在 tkn-pac describe 命令中显示错误片段，并突出显示错误的正则表达式模式
    • 在 tkn-pac ls 和 tkn-pac describe 命令中添加 use-real-time 开关
    • 导入 tkn-pac 日志文档
    • 在 tkn-pac ls 和 tkn-pac describe 命令中显示 pipelineruntimeout 作为失败。
    • 使用 --target-pipelinerun 选项显示特定的管道运行失败。
  • 在这个版本中，您可以使用版本控制系统 (VCS) 注释或 GitHub 检查中的小片断的形式查看管道运行的错误。
  • 在这个版本中，Pipelines 作为代码可以选择地检测任务中的错误（如果它们是简单格式），并在 GitHub 中将这些任务添加为注解。这个版本是开发人员预览功能的一部分。

  • 在这个版本中添加了以下新命令：

    • tkn-pac webhook add ：在项目存储库设置中添加了一个 webhook，并在现有的 k8s Secret 对象中更新了 webhook.secret 键，而无需更新存储库。
    • tkn-pac webhook update-token: 更新现有 k8s Secret 对象的供应商令牌，而无需更新存储库。
  • 这个版本增强了 tkn-pac create repo 命令的功能，该命令为 GitHub、GitLab 和 BitbucketCloud 创建并配置 Webhook，以及创建存储库。
  • 在这个版本中，tkn-pac describe 命令以一定的排序顺序显示最新的五十个事件。
  • 在这个版本中，在 tkn-pac logs 命令中添加了 --last 选项。
  • 在这个版本中，tkn-pac resolve 命令会在文件模板中检测 git_auth_secret 时提示输入令牌。
  • 在这个版本中，Pipelines 作为代码从日志片断中隐藏 secret，以避免在 GitHub 界面中公开 secret。
  • 在这个版本中，为 git_auth_secret 自动生成 secret 是 PipelineRun 的所有者引用。使用 PipelineRun 清理 secret，而不是在管道运行执行后进行。
  • 在这个版本中，增加了对使用 /cancel 注释取消管道运行的支持。

  • 在此次更新之前，没有定义 GitHub 应用程序令牌范围，并将在每个存储库安装中使用令牌。在这个版本中，您可以使用以下参数将 GitHub 应用令牌范围到目标存储库：

    • secret-github-app-token-scoped ：将应用程序令牌范围到目标仓库，而不是应用程序安装可访问的每个存储库。
    • secret-github-app-scope-extra-repos ：使用额外的所有者或存储库自定义应用程序令牌的范围。
  • 在这个版本中，您可以将 Pipelines 用作代码与在 GitLab 上托管的自己的 Git 存储库一起使用。
  • 在这个版本中，您可以使用命名空间中的 kubernetes 事件的形式访问管道执行详情。这些详细信息可帮助您对管道错误进行故障排除，而无需访问 admin 命名空间。
  • 在这个版本中，支持通过 Git 供应商在 Pipelines 中作为代码解析器验证 URL。
  • 在这个版本中，您可以使用 pipelines-as-code 配置映射中的设置来设置 hub 目录的名称。
  • 在这个版本中，您可以为 max-keep-run 参数设置最大和默认限值。
  • 在这个版本中，添加了有关如何注入 Pipelines 作为代码中的自定义安全套接字层 (SSL) 证书的文档，可让您使用自定义证书连接到供应商实例。
  • 在这个版本中，PipelineRun 资源定义包含的日志 URL 作为注解。例如，tkn-pac describe 命令在描述 PipelineRun 时显示日志链接。
  • 在这个版本中，tkn-pac 日志显示存储库名称，而不是 PipelineRun 名称。

4.1.4.2. 可能会造成问题的更改
复制链接

  • 在这个版本中，Conditions 自定义资源定义(CRD) 类型已被删除。作为替代方案，请使用 WhenExpressions 替代。
  • 在这个版本中，删除了 tekton.dev/v1alpha1 API pipeline 资源，如 Pipeline、PipelineRun、Task、Clustertask 和 TaskRun。
  • 在这个版本中，tkn-pac setup 命令已被删除。使用 tkn-pac webhook add 命令将 webhook 重新添加到现有 Git 仓库。使用 tkn-pac webhook update-token 命令为 Git 仓库中的现有 Secret 对象更新个人供应商访问令牌。
  • 在这个版本中，运行带有默认设置的管道的命名空间不会将 pod-security.kubernetes.io/enforce:privileged 标签应用到工作负载。

4.1.4.3. 弃用和删除的功能
复制链接

  • 在 Red Hat OpenShift Pipelines 1.9.0 发行版本中，ClusterTasks 已被弃用，计划在以后的发行版本中删除。作为替代方案，您可以使用 Cluster Resolver。
  • 在 Red Hat OpenShift Pipelines 1.9.0 发行版本中，在单个 EventListener 规格中使用 triggers 和 namespaceSelector 字段已弃用，并计划在以后的发行版本中删除。您可以在不同的 EventListener 规格中成功使用这些字段。
  • 在 Red Hat OpenShift Pipelines 1.9.0 发行版本中，tkn pipelinerun describe 命令不会显示 PipelineRun 资源的超时。
  • 在 Red Hat OpenShift Pipelines 1.9.0 发行版本中，PipelineResource' 自定义资源(CR) 已被弃用。PipelineResource CR 是一个技术预览功能，它是 tekton.dev/v1alpha1 API 的一部分。
  • 在 Red Hat OpenShift Pipelines 1.9.0 发行版本中，集群任务中的自定义镜像参数已弃用。另外，您可以复制集群任务并在其中使用自定义镜像。

4.1.4.4. 已知问题
复制链接

  • 卸载 Red Hat OpenShift Pipelines Operator 后会删除 chains-secret 和 chains-config 配置映射。当它们包含用户数据时，应保留且不删除它们。

  • 当在 Windows 上运行 tkn pac 命令集时，您可能会收到以下出错信息： Command finished with error: not supported by Windows。

    临时解决方案：将 NO_COLOR 环境变量设置为 true。

  • 如果 tkn pac resolve 命令使用已模板化的参数值，则运行 tkn pac resolve -f <filename> | oc create -f 命令可能无法提供预期的结果。

    临时解决方案： 要缓解这个问题，请通过运行 tkn pac resolve -f <filename> -o tempfile.yaml 命令将 tkn pac resolve 命令的输出保持在一个临时文件中，然后运行 oc create -f tempfile.yaml 命令。例如：tkn pac resolve -f <filename> -o /tmp/pull-request-resolved.yaml && oc create -f /tmp/pull-request-resolved.yaml。

4.1.4.5. 修复的问题
复制链接

  • 在此次更新之前，在替换空数组后，原始阵列返回一个空字符串，从而导致其中的参数无效。在这个版本中，这个问题已被解决，原始阵列返回为空。
  • 在此次更新之前，如果管道运行的服务帐户中存在重复的 secret，则会导致任务 pod 创建失败。在这个版本中，这个问题已解决，即使服务帐户中存在重复的 secret，任务 pod 也会成功创建。
  • 在此次更新之前，通过查看 TaskRun 的 spec.StatusMessage 字段，用户无法区分 TaskRun 是否已被用户取消或作为它一部分的 PipelineRun。在这个版本中，这个问题已被解决，用户可以通过查看 TaskRun 的 spec.StatusMessage 字段来区分 TaskRun 的状态。
  • 在此次更新之前，在删除旧版本的无效对象时，webhook 验证会被删除。在这个版本中，这个问题已解决。

  • 在此次更新之前，如果您将 timeouts.pipeline 参数设置为 0，您将无法设置 timeouts.tasks 参数或 timeouts.finally 参数。这个版本解决了这个问题。现在，当您设置 timeouts.pipeline 参数值时，可以设置 `timeouts.tasks` 参数或 timeouts.finally 参数。例如： 

    yaml
kind: PipelineRun
spec:
  timeouts:
    pipeline: "0"  # No timeout
    tasks: "0h3m0s"
    Copy to Clipboard Toggle word wrap
  • 在此次更新之前，如果 PipelineRun 或 TaskRun 上的另一个工具更新了标签或注解，则可能会出现竞争条件。在这个版本中，这个问题已被解决，您可以合并标签或注解。
  • 在此次更新之前，日志密钥与管道控制器中的密钥不同。在这个版本中，这个问题已被解决，日志密钥已被更新，以匹配管道控制器的日志流。日志中的键已从 "ts" 改为 "timestamp"，从 "level" 改为 "severity"，从 "message" 改为 "msg"。
  • 在此次更新之前，如果一个 PipelineRun 被删除并带有未知状态，则不会生成错误消息。在这个版本中，这个问题已解决，并生成错误消息。
  • 在此次更新之前，若要访问 list 和 push 等捆绑包命令，需要使用 kubeconfig 文件。在这个版本中，这个问题已被解决，且 kubeconfig 文件不需要访问捆绑包命令。
  • 在此次更新之前，如果在删除 TaskRuns 时运行父 PipelineRun，则将删除 TaskRuns。在这个版本中，这个问题已被解决，如果父 PipelineRun 正在运行，TaskRuns 不会被删除。
  • 在此次更新之前，如果用户试图构建带有超过管道控制器的对象的捆绑包，Tekton CLI 不会显示错误消息。在这个版本中，这个问题已解决，如果用户试图构建比管道控制器中允许的限制更多的对象，Tekton CLI 会显示错误消息。
  • 在此次更新之前，如果从集群中删除命名空间，Operator 不会从 ClusterInterceptor ClusterRoleBinding 主题中删除命名空间。在这个版本中，这个问题已被解决，Operator 会从 ClusterInterceptor ClusterRoleBinding 主题中删除命名空间。
  • 在此次更新之前，Red Hat OpenShift Pipelines Operator 的默认安装会导致集群中的 pipelines-scc-rolebinding 安全上下文约束 (SCC) 角色绑定资源。在这个版本中，Red Hat OpenShift Pipelines Operator 的默认安装会导致 pipelines-scc-rolebinding 安全性上下文约束 (SCC) 角色绑定资源被从集群中移除。
  • 在此次更新之前，Pipelines as Code 不会从 Pipelines as Code ConfigMap 对象获取更新的值。在这个版本中，这个问题已被解决，Pipelines as Code ConfigMap 对象会查找任何新的更改。
  • 在此次更新之前，Pipelines as Code 控制器不会等待 tekton.dev/pipeline 标签被更新并添加 checkrun id 标签，这会导致竞争条件。在这个版本中，Pipelines as Code 控制器会等待 tekton.dev/pipeline 标签更新，然后添加 checkrun id 标签，这有助于避免竞争条件。
  • 在此次更新之前，如果 git 仓库中已存在，tkn-pac create repo 命令不会覆盖 PipelineRun。在这个版本中，tkn-pac create 命令已被修复，如果 git 仓库中存在 PipelineRun，这会成功覆盖它。
  • 在此次更新之前，tkn pac describe 命令不会显示每个消息的原因。在这个版本中，这个问题已被解决，tkn pac describe 命令会显示每个消息的原因。
  • 在此次更新之前，如果使用 regex 表单的注解中的用户提供值，则拉取请求会失败，如 refs/head/rel-*。拉取请求失败，因为它在基础分支中缺少 refs/heads。在这个版本中，添加了前缀，并检查它是否匹配。这解决了这个问题，拉取请求可以成功。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.9.1 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.4.7. 修复的问题
复制链接

  • 在此次更新之前，tkn pac repo list 命令不会在 Microsoft Windows 上运行。在这个版本中解决了这个问题，您可以在 Microsoft Windows 上运行 tkn pac repo list 命令。
  • 在此次更新之前，Pipelines as Code watcher 不会接收所有配置更改事件。在这个版本中，Pipelines as Code watcher 已被更新，现在 Pipelines as Code watcher 不会丢失配置更改事件。
  • 在此次更新之前，由 Pipelines as Code 创建的 pod，如 TaskRuns 或 PipelineRuns 无法访问集群中用户公开的自定义证书。在这个版本中解决了这个问题，您可以从集群中的 TaskRuns 或 PipelineRuns pod 访问自定义证书。
  • 在此次更新之前，在使用 FIPS 启用的集群中，Trigger 资源中使用的 tekton-triggers-core-interceptors 内核拦截器在 Pipelines Operator 升级到 1.9 后无法正常工作。这个版本解决了这个问题。现在，OpenShift 将 MInTLS 1.2 用于其所有组件。因此，tekton-triggers-core-interceptors core interceptor 对 TLS 版本 1.2 及其功能进行准确运行。

  • 在此次更新之前，当使用带有内部 OpenShift 镜像 registry 的管道运行时，必须在管道运行定义中硬编码到镜像的 URL。例如： 

    ...
  - name: IMAGE_NAME
    value: 'image-registry.openshift-image-registry.svc:5000/<test_namespace>/<test_pipelinerun>'
...
    Copy to Clipboard Toggle word wrap

    当在 Pipelines 作为代码上下文中使用管道运行时，这些硬编码值会阻止管道运行定义在不同的集群和命名空间中使用。

    在这个版本中，您可以使用动态模板变量，而不是硬编码命名空间和管道运行名称的值，以常规化管道运行定义。例如： 

    ...
  - name: IMAGE_NAME
    value: 'image-registry.openshift-image-registry.svc:5000/{{ target_namespace }}/$(context.pipelineRun.name)'
...
    Copy to Clipboard Toggle word wrap
  • 在此次更新之前，Pipelines as Code 使用相同的 GitHub 令牌获取默认 GitHub 分支上同一主机上提供的远程任务。这个版本解决了这个问题。现在，Pipelines as Code 使用相同的 GitHub 令牌从任何 GitHub 分支获取远程任务。

4.1.4.8. 已知问题
复制链接

  • CATALOG_REFRESH_INTERVAL 的值(Tekton Hub CR 中使用的 Hub API ConfigMap 对象中的一个字段)不会更新，无法使用用户提供的自定义值进行更新。

    临时解决方案：无.您可以跟踪问题 SRVKP-2854。

4.1.4.9. 可能会造成问题的更改
复制链接

  • 在这个版本中，引入了一个 OLM 错误配置问题，这会阻止升级 OpenShift Container Platform。这个问题将在以后的发行版本中解决。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.9.2 包括在 OpenShift Container Platform 4.11、4.12 和 4.13 中。

4.1.4.11. 修复的问题
复制链接

  • 在此次更新之前，之前的版本中引入了一个 OLM 错误配置问题，这会阻止 OpenShift Container Platform 升级。在这个版本中，这个错误问题已被修复。

在这个版本中，除了 4.11、4.12 和 4.13 外，Red Hat OpenShift Pipelines 正式发布 (GA) 1.9.3 包括在 OpenShift Container Platform 4.10 中。

4.1.4.13. 修复的问题
复制链接

  • 在这个版本中解决了大型管道的性能问题。现在，CPU 的使用率减少了 61%，内存用量减少了 44%。
  • 在此次更新之前，如果某个任务因为 when 表达式而没有运行，则管道运行会失败。在这个版本中，通过防止在管道结果中验证跳过的任务结果解决了这个问题。现在，管道结果不会被发送，管道运行不会因为缺少结果而失败。
  • 在这个版本中，为 v1beta1 API 修复了 pipelineref.bundle 转换到捆绑包解析器的问题。现在，转换功能会在转换完成后将 kind 字段的值设置为 Pipeline。
  • 在此次更新之前，Pipelines Operator 中的一个问题会阻止用户将 spec.pipeline.enable-api-fields 字段的值设置为 beta。在这个版本中解决了这个问题。现在，您可以在 TektonConfig 自定义资源中将值设为 beta、alpha 和 stable。
  • 在此次更新之前，因为集群错误，Pipelines as Code 无法创建 secret 时，它会在 GitHub 的 check run 过程中显示临时令牌（这个过程是公开的）。在这个版本中解决了这个问题。现在，在创建 secret 失败时，这个令牌不再显示在 GitHub 检查界面中。

4.1.4.14. 已知问题
复制链接

  • 目前，在 OpenShift Container Platform Web 控制台中的管道运行的 stop 选项存在一个已知问题。Actions 下拉列表中的 stop 选项无法正常工作，它无法取消管道运行。

  • 因为自定义资源定义转换失败，升级到 Pipelines 版本 1.9.x 存在一个已知问题。

    临时解决方案：在升级到 Pipelines 版本 1.9.x 之前，请执行红帽客户门户网站中解决方案中提到的步骤。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.8 包括在 OpenShift Container Platform 4.10, 4.11 和 4.12 中。

4.1.5.1. 新功能
复制链接

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.8 中的新内容。

4.1.5.1.1. Pipelines
复制链接
  • 在这个版本中，您可以在在 ARM 硬件上运行 Red Hat OpenShift Pipelines GA 1.8 及更新的版本。这包括对 ClusterTask 资源和 tkn CLI 工具的支持。
重要

在 ARM 硬件上运行 Red Hat OpenShift Pipelines 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，为 TaskRun 资源实现了 Step 和 Sidecar 覆盖。

  • 在这个版本中，在 PipelineRun 状态下添加了最小的 TaskRun 和 Run 状态。

    要启用此功能，在 TektonConfig 自定义资源定义的 pipeline 部分，您必须将 enable-api-fields 字段设置为 alpha。

  • 在这个版本中，管道运行功能的安全终止会从 alpha 功能提升到 stable 功能。因此，之前弃用的 PipelineRunCancelled 状态会保持弃用，计划在以后的发行版本中被删除。

    由于这个功能默认可用，所以您不再需要在 TektonConfig 自定义资源定义中将 pipeline.enable-api-fields 字段设置为 alpha。

  • 在这个版本中，您可以使用工作区名称为管道任务指定工作区。这个更改可让您更轻松地为 Pipeline 和 PipelineTask 资源指定共享的工作区。您还可以继续显式映射工作区。

    要启用此功能，在 TektonConfig 自定义资源定义的 pipeline 部分，您必须将 enable-api-fields 字段设置为 alpha。

  • 在这个版本中，内嵌规格中的参数会在不修改的情况下传播。
  • 在这个版本中，您可以使用注解和标签指定 PipelineRun 资源引用的 Task 资源所需的元数据。这样，在管道运行过程中，依赖执行上下文的 Task 元数据可用。
  • 在这个版本中，params 和 results 值增加了对象和字典类型。这个变化会影响向后兼容性，有时会破坏转发兼容性，比如使用较早的客户端和以后的 Red Hat OpenShift Pipelines 版本。这个版本更改了 ArrayOrStruct 结构，它会影响使用 Go 语言 API 作为库的项目。
  • 在这个版本中，为 PipelineRun 状态字段的 SkippedTasks 字段添加了一个 SkippingReason 值，以便用户了解跳过给定 PipelineTask 的原因。

  • 在这个版本中，支持一个 alpha 功能，您可以使用 数组 类型从 Task 对象发出结果。结果类型从字符串改为ArrayOrString。例如，任务可以指定类型来生成数组结果： 

    kind: Task
apiVersion: tekton.dev/v1beta1
metadata:
  name: write-array
  annotations:
    description: |
      A simple task that writes array
spec:
  results:
    - name: array-results
      type: array
      description: The array results
...
    Copy to Clipboard Toggle word wrap

    另外，您可以运行一个任务脚本来填充数组的结果： 

    $ echo -n "[\"hello\",\"world\"]" | tee $(results.array-results.path)
    Copy to Clipboard Toggle word wrap

    要启用此功能，在 TektonConfig 自定义资源定义的 pipeline 部分，您必须将 enable-api-fields 字段设置为 alpha。

    这个功能正在进行中，它是 TEP-0076 的一部分。

4.1.5.1.2. 触发器
复制链接

  • 在这个版本中，EventListener 规格中的 TriggerGroups 字段从 alpha 功能转换为 stable 功能。使用此字段，您可以在选择和运行一组触发器前指定一组拦截器。

    由于这个功能默认可用，所以您不再需要在 TektonConfig 自定义资源定义中将 pipeline.enable-api-fields 字段设置为 alpha。

  • 在这个版本中，Trigger 资源通过运行使用 HTTPS 的 ClusterInterceptor 服务器来支持端到端安全连接。
4.1.5.1.3. CLI
复制链接
  • 在这个版本中，您可以使用 tkn taskrun export 命令，将集群中运行的 live 任务导出到 YAML 文件，您可以使用它来将任务运行导入到另一个集群。
  • 在这个版本中，您可以在 tkn pipeline start 命令中添加 -o name 标志，以便在启动后打印管道运行的名称。
  • 在这个版本中，在 tkn --help 命令的输出中添加了可用插件列表。
  • 在这个版本中，在删除管道运行或任务运行时，您可以同时使用 --keep 和 --keep-since 标志。
  • 在这个版本中，您可以使用 Cancelled 作为 spec.status 字段的值，而不是弃用的 PipelineRunCancelled 值。
4.1.5.1.4. Operator
复制链接
  • 在这个版本中，作为管理员，您可以将本地 Tekton Hub 实例配置为使用自定义数据库，而不是默认数据库。

  • 在这个版本中，作为集群管理员，如果您启用本地 Tekton Hub 实例，它会定期刷新数据库，以便目录中的更改出现在 Tekton Hub web 控制台中。您可以调整刷新之间的周期。

    在以前的版本中，要将目录中的任务和管道添加到数据库中，您需要手动执行该任务或设置 cron 任务来为您完成这个任务。

  • 在这个版本中，您可以使用最小配置安装并运行 Tekton Hub 实例。这样，您可以开始使用团队来确定他们可能需要的其他自定义。
  • 在这个版本中，将 GIT_SSL_CAINFO 添加到 git-clone 任务，以便您可以克隆安全的存储库。
4.1.5.1.5. Tekton Chains
复制链接
重要

Tekton 链只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，您可以使用 OIDC 而不是静态令牌登录到 vault。这个更改意味着 Spire 可以生成 OIDC 凭证，以便只允许可信工作负载登录到 vault。另外，您可以将 vault 地址作为配置值传递，而不是将其作为环境变量注入。
  • 在升级 Red Hat OpenShift Pipelines Operator 后，openshift-pipelines 命名空间中的 Tekton Chains 的 chains-config 配置映射会自动重置为 default，因为在使用 Red Hat OpenShift Pipelines Operator 安装时不支持直接更新配置映射。但是，在此次更新中，您可以使用 TektonChain 自定义资源配置 Tekton 链。这个功能可让您在升级后保留配置，这与 chains-config 配置映射不同，这在升级过程中会被覆盖。
4.1.5.1.6. Tekton Hub
复制链接
重要

Tekton Hub 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，如果您使用 Operator 安装一个新的 Tekton Hub 实例，则 Tekton Hub 登录默认是禁用的。要启用登录和评级功能，必须在安装 Tekton Hub 时创建 Hub API secret。

    注意

    因为在 Red Hat OpenShift Pipelines 1.7 中默认启用了 Tekton Hub 登录，所以如果升级 Operator，在 Red Hat OpenShift Pipelines 1.8 中会默认启用登录。要禁用此登录，请参阅从 OpenShift Pipelines 1.7.x -→ 1.8.x 升级后禁用 Tekton Hub 登录

  • 在这个版本中，作为管理员，您可以将本地 Tekton Hub 实例配置为使用自定义 PostgreSQL 13 数据库，而不是默认数据库。为此，请创建一个名为 tekton-hub-db 的 Secret 资源。例如： 

    apiVersion: v1
kind: Secret
metadata:
  name: tekton-hub-db
  labels:
    app: tekton-hub-db
type: Opaque
stringData:
  POSTGRES_HOST: <hostname>
  POSTGRES_DB: <database_name>
  POSTGRES_USER: <username>
  POSTGRES_PASSWORD: <password>
  POSTGRES_PORT: <listening_port_number>
    Copy to Clipboard Toggle word wrap
  • 在这个版本中，您不再需要登录到 Tekton Hub web 控制台，将目录中的资源添加到数据库。现在，当 Tekton Hub API 首次运行时，这些资源会自动添加。
  • 在这个版本中，通过调用目录刷新 API 作业，每 30 分钟自动刷新目录。用户可以配置这个间隔。
4.1.5.1.7. Pipelines 作为代码（Pipelines as Code）
复制链接
重要

Pipelines as Code (PAC) 只是一个技术预览功能。技术预览功能不受红帽产品服务等级协议（SLA）支持，且功能可能并不完整。红帽不推荐在生产环境中使用它们。这些技术预览功能可以使用户提早试用新的功能，并有机会在开发阶段提供反馈意见。

有关红帽技术预览功能支持范围的更多信息，请参阅技术预览功能支持范围。

  • 在这个版本中，作为开发人员，如果您试图将重复的存储库添加到 Pipelines 作为代码运行，则从 tkn-pac CLI 工具获得通知。输入 tkn pac create repository 时，每个仓库必须具有一个唯一的 URL。此通知还有助于防止劫持漏洞攻击。
  • 在这个版本中，作为开发人员，您可以使用新的 tkn-pac setup cli 命令，使用 webhook 机制将 Git 存储库作为代码添加到 Pipelines 中。这样，即使在使用 GitHub Apps 时也可以使用 Pipelines 作为代码。此功能包括对 GitHub、GitLab 和 BitBucket 上的存储库的支持。

  • 在这个版本中，Pipelines 作为代码支持 GitLab 与特征集成，如下所示：

    • 项目或组的 ACL（访问权限控制列表）
    • 允许的用户的 /ok-to-test 支持
    • /retest 支持。

  • 在这个版本中，您可以使用通用表达式语言 (CEL) 执行高级管道过滤。使用 CEL，您可以使用 PipelineRun 资源中的注解匹配带有不同 Git 供应商事件的管道运行。例如： 

      ...
  annotations:
     pipelinesascode.tekton.dev/on-cel-expression: |
      event == "pull_request" && target_branch == "main" && source_branch == "wip"
    Copy to Clipboard Toggle word wrap
  • 在以前的版本中，作为开发人员，每个 Git 事件在 .tekton 目录中只能运行一个管道运行，如拉取请求。在这个版本中，您可以在 .tekton 目录中运行多个管道。Web 控制台显示运行的状态和报告。管道并行运行，并报告回 Git 提供程序接口。
  • 在这个版本中，您可以通过对拉取请求为 /test 或 /retest 添加注释来测试或重新测试管道运行。您还可以按名称指定管道运行。例如，您可以输入 /test <pipelinerun_name> 或 /retest <pipelinerun-name>。
  • 在这个版本中，您可以使用新的 tkn-pac delete repository 命令删除存储库自定义资源及其关联的 secret。

4.1.5.2. 可能会造成问题的更改
复制链接

  • 在这个版本中，TaskRun 和 PipelineRun 资源的默认指标级别改为以下值： 

    apiVersion: v1
kind: ConfigMap
metadata:
  name: config-observability
  namespace: tekton-pipelines
  labels:
    app.kubernetes.io/instance: default
    app.kubernetes.io/part-of: tekton-pipelines
data:
  _example: |
  ...
    metrics.taskrun.level: "task"
    metrics.taskrun.duration-type: "histogram"
    metrics.pipelinerun.level: "pipeline"
    metrics.pipelinerun.duration-type: "histogram"
    Copy to Clipboard Toggle word wrap
  • 在这个版本中，如果 Pipeline 和 PipelineRun 资源中存在注解或标签，Run 类型中的值将具有优先权。如果 Task 和 TaskRun 资源中存在注解或标签，则也是如此。
  • 在 Red Hat OpenShift Pipelines 1.8 中，之前弃用的 PipelineRun.Spec.ServiceAccountNames 字段已被删除。使用 PipelineRun.Spec.TaskRunSpecs 字段替代。
  • 在 Red Hat OpenShift Pipelines 1.8 中，之前已弃用的 TaskRun.Status.ResourceResults.ResourceRef 字段已被删除。使用 TaskRun.Status.ResourceResults.ResourceName 字段。
  • 在 Red Hat OpenShift Pipelines 1.8 中，之前已弃用的 Conditions 资源类型已被删除。从包含它的 Pipeline 资源定义中删除 Conditions 资源。在 PipelineRun 定义中使用 when 表达式。
  • 对于 Tekton 链，在这个发行版本中删除了 tekton-provenance 格式。通过在 TektonChain 自定义资源中设置 "artifacts.taskrun.format": "in-toto" 来使用 in-toto 格式。

  • Red Hat OpenShift Pipelines 1.7.x 作为代码 0.5.x 附带。当前的更新附带了 Pipelines，作为代码 0.10.x。此更改在新控制器的 openshift-pipelines 命名空间中创建新路由。您必须在使用 Pipelines 作为代码的 GitHub Apps 或 Webhook 中更新此路由。要获取路由，请使用以下命令： 

    $ oc get route -n openshift-pipelines pipelines-as-code-controller \
  --template='https://{{ .spec.host }}'
    Copy to Clipboard Toggle word wrap
  • 在这个版本中，Pipelines 作为 Code 会重命名 Repository 自定义资源定义 (CRD) 的默认 secret 密钥。在 CRD 中，将 token 替换为 provider.token，并将 secret 替换为 webhook.secret。
  • 在这个版本中，Pipelines 作为代码将特殊模板变量替换为支持用于私有仓库的多个管道运行的特殊模板变量。在管道运行中，将 secret: pac-git-basic-auth-{{repo_owner}}-{{repo_name}} 替换为 secret: {{ git_auth_secret }}。

  • 在这个版本中，Pipelines as Code 更新 tkn-pac CLI 工具中的以下命令：

    • 将 tkn pac repository create 替换为 tkn pac create repository。
    • 将 tkn pac repository delete 替换为 tkn pac delete repository。
    • 将 tkn pac repository list 替换为 tkn pac list。

4.1.5.3. 弃用和删除的功能
复制链接

  • 从 OpenShift Container Platform 4.11 开始，会删除用于安装和升级 Red Hat OpenShift Pipelines Operator 的 preview 和 stable 频道。要安装和升级 Operator，请使用适当的 pipelines-<version> 频道，或最新稳定版本的 latest 频道。例如，要安装 Pipelines Operator 版本 1.8.x，请使用 pipelines-1.8 频道。

    注意

    在 OpenShift Container Platform 4.10 及更早的版本中，您可以使用 preview 和 stable 频道来安装和升级 Operator。

  • 对 tekton.dev/v1alpha1 API 版本的支持（在 Red Hat OpenShift Pipelines GA 1.6 中已弃用）计划在以后的 Red Hat OpenShift Pipelines GA 1.9 发行版本中删除。

    此更改会影响管道组件，其中包括 TaskRun, PipelineRun, Task, Pipeline, 和 tekton.dev/v1alpha1 类似。另外，将现有资源更新为使用 apiVersion: tekton.dev/v1beta1，如 Migrating From Tekton v1alpha1 to Tekton v1beta1 所述。

    对 tekton.dev/v1alpha1 API 版本的程序错误修复和支持仅到当前 GA 1.8 生命周期结束为止。

    重要

    对于 Tekton Operator，operator.tekton.dev/v1alpha1 API 版本没有弃用。您不需要更改此值。

  • 在 Red Hat OpenShift Pipelines 1.8 中，PipelineResource 自定义资源 (CR) 可用，但不再被支持。PipelineResource CR 是一个技术预览功能，它属于 tekton.dev/v1alpha1 API 的一部分，它已被弃用，并计划在以后的 Red Hat OpenShift Pipelines GA 1.9 发行版本中删除。
  • 在 Red Hat OpenShift Pipelines 1.8 中，Condition 自定义资源 (CR) 已删除。Condition CR 是 tekton.dev/v1alpha1 API 的一部分，它已被弃用，计划在以后的 Red Hat OpenShift Pipelines GA 1.9 发行版本中删除。
  • 在 Red Hat OpenShift Pipelines 1.8 中，gsutil 的 gcr.io 镜像已被删除。这个删除可能会破坏带有依赖于此镜像的 Pipeline 资源的集群。程序错误修复和支持只到 Red Hat OpenShift Pipelines 1.7 生命周期结束为主。
  • 在 Red Hat OpenShift Pipelines 1.8 中，Pipeline.Status.TaskRuns 和 PipelineRun.Status.Runs 字段已弃用，计划在以后的发行版本中被删除。请参阅 PipelineRuns 中的 TEP-0100: 嵌入式 TaskRuns 和 Runs Status。

  • 在 Red Hat OpenShift Pipelines 1.8 中，pipelineRunCancelled 状态已弃用，计划在以后的发行版本中被删除。现在，PipelineRun 对象的安全终止已从 alpha 功能提升到 stable 功能。（请参阅 TEP-0058: Graceful Pipeline Run Termination。） 另外，您可以使用 Cancelled 状态替换 pipelineRunCancelled 状态。

    您不需要更改 Pipeline 和 Task 资源。如果您有会取消管道运行的工具，则必须在下一个发行版本中更新这些工具。这个更改也会影响 CLI、IDE 扩展等工具，以便支持新的 PipelineRun 状态。

    由于这个功能默认可用，所以您不再需要在 TektonConfig 自定义资源定义中将 pipeline.enable-api-fields 字段设置为 alpha。

  • 在 Red Hat OpenShift Pipelines 1.8 中，PipelineRun 中的 timeout 字段已弃用。反之，使用 PipelineRun.Timeouts 字段，它现在从 alpha 功能提升到 stable 功能。

    由于这个功能默认可用，所以您不再需要在 TektonConfig 自定义资源定义中将 pipeline.enable-api-fields 字段设置为 alpha。

  • 在 Red Hat OpenShift Pipelines 1.8 中，init 容器在 LimitRange 对象的默认请求计算中省略。

4.1.5.4. 已知问题
复制链接

  • s2i-nodejs 管道无法使用 nodejs:14-ubi8-minimal 镜像流来执行 source-to-image (S2I) 构建。使用该镜像流会生成一个 error building at STEP "RUN /usr/libexec/s2i/assemble": exit status 127 信息。

    临时解决方案： 使用 nodejs:14-ubi8 而不是 nodejs:14-ubi8-minimal 镜像流。

  • 当您运行 Maven 和 Jib-Maven 集群任务时，默认容器镜像仅支持 Intel(x86)架构。因此，在 ARM、IBM Power Systems(ppc64le)、IBM Z 和 LinuxONE (s390x) 集群上的任务将失败。

    作为临时解决方案，您可以通过将 MAVEN_IMAGE 参数值设置为 maven:3.6.3-adoptopenjdk-11 来指定自定义镜像。

    提示

    在您使用 tkn hub 在 ARM、IBM Power Systems(ppc64le)、IBM Z 和 LinuxONE(s390x) 上基于 Tekton Catalog 安装任务前，请验证是否可以在这些平台上执行任务。要检查 ppc64le 和 s390x 是否列在任务信息的"Platforms"部分，您可以运行以下命令： tkn hub info task <name>

  • 在 ARM、IBM Power Systems、IBM Z 和 LinuxONE 中，不支持 s2i-dotnet 集群任务。
  • 隐式参数映射会错误地将参数从顶级 Pipeline 或 PipelineRun 定义传递给 taskRef 任务。映射应该只在顶层资源中使用任务进行，并带有非线 taskSpec 规格。这个问题只通过将 TektonConfig 自定义资源定义的 pipeline 部分中的 enable-api-fields 字段设置为 alpha 来影响启用了这个功能的集群。

4.1.5.5. 修复的问题
复制链接

  • 在此次更新之前，管道的指标在 Web 控制台的 Developer 视图中运行的指标不完整且过期。在这个版本中，这个问题已被解决，指标正确。
  • 在此次更新之前，如果管道有两个失败并有 retries=2 的并行任务，则最终任务永不会运行，管道超时并且无法运行。例如，pipelines-operator-subscription 任务会间歇性地失败，并显示以下错误消息： Unable to connect to server: EOF。在这个版本中，这个问题已被解决，以便最终任务始终运行。
  • 在此次更新之前，如果管道运行因为任务运行失败而停止，则其他任务运行可能无法完成重试。因此，不会调度 finally 任务，这会导致管道挂起。 这个版本解决了这个问题。TaskRuns 和 Run 对象可以在管道运行停止时重试，即使是安全停止也是如此，以便管道运行可以完成。
  • 在这个版本中，当 TaskRun 对象的命名空间中存在一个或多个 LimitRange 对象时，会改变如何计算资源要求。现在，当从 LimitRange 对象发出请求时，调度程序现在考虑 step 容器并排除所有其他应用容器，如 sidecar 容器。
  • 在此次更新之前，在特定的条件下，标志软件包可能会错误地解析子命令，并带有双短划线终止符 --。在这种情况下，它会运行 entrypoint 子命令，而不是实际命令。在这个版本中解决了这个问题，这个问题会解决，entrypoint 会运行正确的命令。
  • 在此次更新之前，如果拉取镜像失败，控制器可能会生成多个 panics，或者其拉取 (pull) 状态不完整。在这个版本中解决了这个问题，方法是检查 step.ImageID 值而不是 status.TaskSpec 值。
  • 在此次更新之前，取消一个包含未计划的自定义任务的管道运行会生成 PipelineRunCouldntCancel 错误。在这个版本中解决了这个问题。您可以取消包含非调度自定义任务的管道运行，而不会生成这个错误。

  • 在此次更新之前，如果在 $params["<NAME>"] 或 $params['<NAME>'] 的 <NAME> 中包括了一个句点字符 (.)，则不会提取句点右侧的任何部分。例如，对于 $params["org.ipsum.lorem"]，只会提取y org 部分。

    在这个版本中解决了这个问题，$params 可以提取完整的值。例如，$params["org.ipsum.lorem"] 和 $params['org.ipsum.lorem'] 是有效的，<NAME> 的完整值 org.ipsum.lorem 都会被提取。

    如果 <NAME> 没有包含在单引号或双引号中，还会抛出一个错误。例如，$params.org.ipsum.lorem 是无效，并生成验证错误。

  • 在这个版本中，Trigger 资源支持自定义拦截器，并确保自定义拦截器服务的端口与 ClusterInterceptor 定义文件中的端口相同。
  • 在此次更新之前，Tekton Chains 和 Operator 组件的 tkn version 命令无法正常工作。在这个版本中解决了这个问题，命令可以正常工作，并返回这些组件的版本信息。
  • 在此次更新之前，如果您运行 tkn pr delete --ignore-running 命令，且管道运行没有 status.condition 值，tkn CLI 工具会生成 null-pointer 错误 (NPE)。在这个版本中解决了这个问题，CLI 工具现在会生成错误，并正确忽略仍然运行的管道运行。
  • 在此次更新之前，如果您使用 tkn pr delete --keep <value> 或 tkn tr delete --keep <value> 命令，且管道运行或任务运行的数量小于其中的值，则命令不会如预期返回一个错误。在这个版本中解决了这个问题，以便命令在这些条件下正确返回错误。
  • 在此次更新之前，如果您使用 tkn pr delete 或 tkn tr delete 命令以及 -p 或 -t 标志与 --ignore-running 标志一起，则命令会错误地删除运行或待处理资源。在这个版本中解决了这个问题，这些命令可以正确地忽略运行或待处理资源。
  • 在此版本中，您可以使用 TektonChain 自定义资源配置 Tekton 链。这个功能可让您在升级后保留配置，这与 chains-config 配置映射不同，这在升级过程中会被覆盖。
  • 在这个版本中，除了 buildah 和 s2i 集群任务外，ClusterTask 资源不再默认以 root 用户身份运行。
  • 在此次更新之前，当将 init 用作第一个参数并后跟两个或更多个参数时，Red Hat OpenShift Pipelines 1.7.1 上的任务会失败。在这个版本中，这些标志会被正确解析，任务可以运行成功。

  • 在此次更新之前，因为存在无效的角色绑定，在 OpenShift Container Platform 4.9 和 4.10 上安装 Red Hat OpenShift Pipelines Operator 会失败，并显示以下错误消息： 

    error updating rolebinding openshift-operators-prometheus-k8s-read-binding: RoleBinding.rbac.authorization.k8s.io
"openshift-operators-prometheus-k8s-read-binding" is invalid:
roleRef: Invalid value: rbac.RoleRef{APIGroup:"rbac.authorization.k8s.io", Kind:"Role", Name:"openshift-operator-read"}: cannot change roleRef
    Copy to Clipboard Toggle word wrap

    在这个版本中解决了这个问题，不再会发生失败。

  • 在以前的版本中，升级 Red Hat OpenShift Pipelines Operator 会导致重新创建 pipeline 服务帐户，这意味着链接到服务帐户的 secret 会丢失。在这个版本中解决了这个问题。在升级过程中，Operator 不再重新创建 pipeline 服务帐户。因此，已附加到 pipeline 服务帐户的 secret 在升级后会保留，资源（任务和管道）可以继续正常工作。
  • 在这个版本中，如果在 TektonConfig 自定义资源 (CR) 中配置了基础架构节点设置，Pipelines as Code pod 在基础架构节点上运行。

  • 在以前的版本中，使用资源修剪器时，每个命名空间 Operator 创建了一个在独立容器中运行的命令。这个设计在有大量命名空间的集群中消耗太多资源。例如，要运行单个命令，带有 1000 个命名空间的集群会在 pod 中生成 1000 个容器。

    在这个版本中解决了这个问题。它将基于命名空间的配置传递给作业，以便所有命令在循环中的一个容器中运行。

  • 在 Tekton Chains 中，您必须定义一个名为 signed-secrets 的 secret，以存放用于签名任务和镜像的密钥。但是，在更新前，更新 Red Hat OpenShift Pipelines Operator 会重置或覆盖这个 secret，密钥会丢失。在这个版本中解决了这个问题。现在，如果在通过 Operator 安装 Tekton Chains 后配置了 secret，secret 会保留，且升级不会覆盖它。

  • 在此次更新之前，所有 S2I 构建任务都会失败，并显示类似以下消息的错误： 

    Error: error writing "0 0 4294967295\n" to /proc/22/uid_map: write /proc/22/uid_map: operation not permitted
time="2022-03-04T09:47:57Z" level=error msg="error writing \"0 0 4294967295\\n\" to /proc/22/uid_map: write /proc/22/uid_map: operation not permitted"
time="2022-03-04T09:47:57Z" level=error msg="(unable to determine exit status)"
    Copy to Clipboard Toggle word wrap

    在这个版本中，pipeline-scc 安全性上下文约束 (SCC) 与 Buildah 和 S2I 集群任务所需的 SETFCAP 功能兼容。因此，Buildah 和 S2I 构建任务可以成功运行。

    要成功运行 Buildah 集群任务和 S2I 构建任务，适用于使用各种语言和框架编写的应用程序，添加以下适当的 steps 对象（如 build 和 push）的代码片段。 

    securityContext:
  capabilities:
    add: ["SETFCAP"]
    Copy to Clipboard Toggle word wrap
  • 在此次更新之前，安装 Red Hat OpenShift Pipelines Operator 所需的时间比预期的要长。这个版本会优化一些设置来加快安装过程。
  • 在这个版本中，Buildah 和 S2I 集群任务比之前的版本要少。有些步骤已合并到一个步骤中，它们最好使用 ResourceQuota 和 LimitRange 对象，且不需要更多资源。
  • 在这个版本中，在集群任务中升级 Buildah、tkn CLI 工具和 skopeo CLI 工具版本。
  • 在此次更新之前，如果任何命名空间处于 Terminating 状态，Operator 会在创建 RBAC 资源时失败。在这个版本中，Operator 忽略了命名空间处于 Terminating 状态，并创建 RBAC 资源。
  • 在此次更新之前，prune cronjobs 的 pod 没有在基础架构节点上调度。相反，它们被调度到 worker 节点上，或没有调度到任何节点。在这个版本中，如果在 TektonConfig 自定义资源 (CR) 中进行了配置，这些类型的 pod 可以在基础架构节点上调度。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.8.1 包括在 OpenShift Container Platform 4.10, 4.11 和 4.12 中。

4.1.5.6.1. 已知问题
复制链接

  • 默认情况下，容器具有 restricted 权限来提高安全性。restricted 权限适用于 Red Hat OpenShift Pipelines Operator 中的所有控制器 pod，以及一些集群任务。由于权限受限，git-clone 集群任务在特定配置下会失败。

    临时解决方案：无.您可以跟踪此问题 SRVKP-2634。

  • 当安装程序集合处于失败状态时，TektonConfig 自定义资源的状态会被错误地显示为 True，而不是 False。

    示例：失败的安装程序集

    $ oc get tektoninstallerset
NAME                                     READY   REASON
addon-clustertasks-nx5xz                 False   Error
addon-communityclustertasks-cfb2p        True
addon-consolecli-ftrb8                   True
addon-openshift-67dj2                    True
addon-pac-cf7pz                          True
addon-pipelines-fvllm                    True
addon-triggers-b2wtt                     True
addon-versioned-clustertasks-1-8-hqhnw   False   Error
pipeline-w75ww                           True
postpipeline-lrs22                       True
prepipeline-ldlhw                        True
rhosp-rbac-4dmgb                         True
trigger-hfg64                            True
validating-mutating-webhoook-28rf7       True
    Copy to Clipboard Toggle word wrap

    示例： 不正确的 TektonConfig 状态

    $ oc get tektonconfig config
NAME     VERSION   READY   REASON
config   1.8.1     True
    Copy to Clipboard Toggle word wrap

4.1.5.6.2. 修复的问题
复制链接
  • 在此次更新之前，pruner 会删除运行管道的任务运行，并显示以下警告：some tasks were indicated completed without ancestors being done。在这个版本中，pruner 会保留作为运行管道一部分的任务运行。
  • 在此次更新之前，pipeline-1.8 是安装 Red Hat OpenShift Pipelines Operator 1.8.x 的默认频道。在这个版本中，latest 是默认频道。
  • 在此次更新之前，作为 Code 控制器 pod 的 Pipelines 无法访问用户公开的证书。在这个版本中，Pipelines as Code 可以访问路由，Git 存储库由自签名或自定义证书保护。
  • 在此次更新之前，在从 Red Hat OpenShift Pipelines 1.7.2 升级到 1.8.0 后，任务会失败并带有 RBAC 错误。在这个版本中，任务会成功运行，不会出现 RBAC 错误。
  • 在此次更新之前，无法使用 tkn CLI 工具删除包含类型为 array 的 result 对象的任务运行和管道运行。在这个版本中，可以使用 tkn CLI 工具删除包含类型为 array 的 result 对象的任务运行和管道运行。
  • 在此次更新之前，如果管道规格包含带有类型为 array 的 ENV_VARS 参数的任务，则管道运行会失败，并带有以下错误：invalid input params for task func-buildpacks: param types don’t match the user-specified type: [ENV_VARS]。在这个版本中，带有这样的管道和任务规格的管道不会失败。
  • 在此次更新之前，集群管理员无法向 Buildah 集群任务提供 config.json 文件来访问容器 registry。在这个版本中，集群管理员可以使用 dockerconfig 工作区为 Buildah 集群任务提供 config.json 文件。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA) 1.8.2 包括在 OpenShift Container Platform 4.10, 4.11 和 4.12 中。

4.1.5.7.1. 修复的问题
复制链接
  • 在此次更新之前，当使用 SSH 密钥克隆存储库时，git-clone 任务会失败。在这个版本中，git-init 任务中的非 root 用户的角色会被删除，SSH 程序会在 $HOME/.ssh/ 目录中查找正确的密钥。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA)1.7 包括在 OpenShift Container Platform 4.9, 4.10, 和 4.11 中。

4.1.6.1. 新功能
复制链接

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.7 中的新内容。

4.1.6.1.1. Pipelines
复制链接

  • 在这个版本中，pipelines-<version> 是安装 Red Hat OpenShift Pipelines Operator 的默认频道。例如，安装 Pipelines Operator 1.7 的默认频道是 pipelines-1.7。集群管理员还可使用 latest 频道来安装 Operator 的最新稳定版本。

    注意

    preview 和 stable 频道将在以后的版本中被弃用并删除。

  • 当您在用户命名空间中运行命令时，您的容器以 root 身份运行（用户 ID 0），但对主机具有用户特权。在这个版本中，要在用户命名空间中运行 pod，您必须传递 CRI-O 期望的注解。

    • 要为所有用户添加这些注解，请运行 oc edit clustertask buildah 命令并编辑 buildah 集群任务。
    • 要将注解添加到特定命名空间，请将集群任务导出为该命名空间的任务。

  • 在此次更新之前，如果没有满足某些条件，则 when 表达式会跳过一个 Task 对象及其依赖的任务。在这个版本中，您可以限制 when 表达式只保护 Task 对象，而不是它的依赖项任务。要启用此更新，请在 TektonConfig CRD 中将 scope-when-expressions-to-task 标志设置为 true。

    注意

    scope-when-expressions-to-task 标记已弃用，并将在以后的发行版本中删除。作为 Pipelines 的最佳实践，请只使用 when 表达式范围到被保证的 Task。

  • 在这个版本中，您可以在任务中的工作区的 subPath 字段中使用变量替换。

  • 在这个版本中，您可以使用带单引号或双引号的 bracket 表示法引用参数和结果。在此次更新之前，只能使用点表示法。例如，现在以下内容等同于：

    • $(param.myparam), $(param['myparam']), and $(param["myparam"]).

      您可以使用单引号或双引号括起包含有问题的字符的参数名称，如 "."。例如，$(param['my.param']) 和 $(param["my.param"])。

  • 在这个版本中，您可以在任务定义中包含步骤的 onError 参数，而无需启用 enable-api-fields 标志。
4.1.6.1.2. 触发器
复制链接
  • 在这个版本中，feature-flag-triggers 配置映射具有一个新的字段 labels-exclusion-pattern。您可以将此字段的值设置为正则表达式(regex)模式。控制器过滤出与事件监听器从事件监听器传播到为事件监听器创建的资源匹配的正则表达式模式的标签。
  • 在这个版本中，TriggerGroups 字段添加到 EventListener 规格中。使用此字段，您可以在选择和运行一组触发器前指定要运行的拦截器。要启用此功能，在 TektonConfig 自定义资源定义的 pipeline 部分，您必须将 enable-api-fields 字段设置为 alpha。
  • 在这个版本中，Trigger 资源支持 TriggerTemplate 模板定义的自定义运行。
  • 在这个版本中，Triggers 支持从 EventListener pod 发送 Kubernetes 事件。
  • 在这个版本中，以下对象提供了计数指标： ClusterInteceptor、EventListener、TriggerTemplate、ClusterTriggerBinding 和 TriggerBinding。
  • 在这个版本中，ServicePort 规格添加到 Kubernetes 资源。您可以使用此规格来修改公开事件监听器服务的端口。默认端口为 8080。
  • 在这个版本中，您可以使用 EventListener 规格中的 targetURI 字段在触发器处理过程中发送云事件。要启用此功能，在 TektonConfig 自定义资源定义的 pipeline 部分，您必须将 enable-api-fields 字段设置为 alpha。
  • 在这个版本中，tekton-triggers-eventlistener-roles 对象除了已存在的 create 动词外，现在还添加了一个 patch 动词。
  • 在这个版本中，securityContext.runAsUser 参数会从事件监听器部署中删除。
4.1.6.1.3. CLI
复制链接

  • 在这个版本中，tkn [pipeline | pipelinerun] export 命令会导出一个管道或管道作为 YAML 文件运行。例如：

    • 在 openshift-pipelines 命名空间中导出名为 test_pipeline 的管道： 

      $ tkn pipeline export test_pipeline -n openshift-pipelines
      Copy to Clipboard Toggle word wrap

    • 在 openshift-pipelines 命名空间中导出名为 test_pipeline_run 的管道运行： 

      $ tkn pipelinerun export test_pipeline_run -n openshift-pipelines
      Copy to Clipboard Toggle word wrap
  • 在这个版本中，--grace 选项添加到 tkn pipelinerun cancel 中。使用 --grace 选项终止管道运行，而不是强制终止。要启用此功能，在 TektonConfig 自定义资源定义的 pipeline 部分，您必须将 enable-api-fields 字段设置为 alpha。

  • 在这个版本中，在 tkn version 命令的输出中添加了 Operator 和链版本。

    重要

    Tekton 链是技术预览功能。

  • 在这个版本中，当取消管道运行时，tkn pipelinerun describe 命令显示所有取消的任务运行。在此修复之前，仅显示一个任务运行。
  • 在这个版本中，您可以在运行 tkn [t | p | p | ct] start 命令时跳过使用 --skip-optional-workspace 标记时，为可选工作区提供请求规格。您也可以在以交互模式运行时跳过它。

  • 在这个版本中，您可以使用 tkn chain 命令管理 Tekton 链。您还可以使用 --chains-namespace 选项指定要安装 Tekton 链的命名空间。

    重要

    Tekton 链是技术预览功能。

4.1.6.1.4. Operator
复制链接

  • 在这个版本中，您可以使用 Red Hat OpenShift Pipelines Operator 来安装和部署 Tekton Hub 和 Tekton 链。

    重要

    集群中的 Tekton Hub 链和部署是技术预览功能。

  • 在这个版本中，您可以查找并使用 Pipelines 作为代码(PAC)作为附加选项。

    重要

    作为代码，管道是技术预览功能。

  • 在这个版本中，您可以通过将 communityClusterTasks 参数设置为 false 来禁用社区集群任务的安装。例如： 

    ...
spec:
  profile: all
  targetNamespace: openshift-pipelines
  addon:
    params:
    - name: clusterTasks
      value: "true"
    - name: pipelineTemplates
      value: "true"
    - name: communityClusterTasks
      value: "false"
...
    Copy to Clipboard Toggle word wrap

  • 在这个版本中，您可以通过 Developer 视角禁用 Tekton Hub 集成，方法是将 TektonConfig 自定义资源中的 enable-devconsole-integration 标志设置为 false。例如： 

    ...
hub:
  params:
    - name: enable-devconsole-integration
      value: "true"
...
    Copy to Clipboard Toggle word wrap
  • 在这个版本中，operator-config.yaml 配置映射启用 tkn version 命令的输出来显示 Operator 版本。
  • 在这个版本中，argocd-task-sync-and-wait 任务的版本被修改为 v0.2。
  • 对于这个版本的 TektonConfig CRD ，oc get tektonconfig 命令会显示 OPerator 版本。
  • 在这个版本中，服务监控器添加到 Triggers 指标中。
4.1.6.1.5. Hub
复制链接
重要

在集群中部署 Tekton Hub 是一个技术预览功能。

Tekton Hub 可帮助您发现、搜索和共享 CI/CD 工作流可重复使用的任务和管道。Tekton Hub 的一个公共实例位于 hub.tekton.dev 中。

集群管理员可以使用 Red Hat OpenShift Pipelines 1.7 推出，集群管理员也可以在企业集群中安装并部署 Tekton Hub 的自定义实例。您可以使用特定于您的机构的可重复使用的任务和管道来策展目录。

4.1.6.1.6. 链
复制链接
重要

Tekton 链是技术预览功能。

Tekton Chains 是一个 Kubernetes 自定义资源定义(CRD)控制器。您可以使用它来管理使用 Red Hat OpenShift Pipelines 创建的任务和管道的供应链安全。

默认情况下，Tekton Chains 会监控 OpenShift Container Platform 集群中运行的任务。链会对完成的任务运行进行快照，将其转换为一个或多个标准有效负载格式，并签署并存储所有工件。

Tekton Chains 支持以下功能：

  • 您可以使用加密密钥类型和服务（如 cosign ）为任务运行、任务运行结果和 OCI registry 镜像签名。
  • 您可以使用"测试"格式，如 in-toto。
  • 您可以使用 OCI 存储库作为存储后端安全存储签名和签名工件。
4.1.6.1.7. 管道作为代码(PAC)
复制链接
重要

作为代码，管道是技术预览功能。

使用 Pipelines 作为 Code，具有所需权限的集群管理员和用户可以将管道模板定义为源代码 Git 存储库的一部分。当由源代码推送或配置的 Git 存储库的拉取请求触发时，该功能将运行管道和报告状态。

作为代码的管道支持以下功能：

  • 拉取请求状态。在迭代拉取请求时，拉取请求的状态和控制会在托管 Git 存储库的平台上进行。
  • GitHub 检查 API 来设置管道运行的状态，包括重新检查。
  • GitHub 拉取请求和提交事件。
  • 在注释中拉取请求操作，如 /retest。
  • Git 事件过滤，以及每个事件的独立管道。
  • Pipelines 中的自动任务解析用于本地任务、Tekton Hub 和远程 URL。
  • 使用 GitHub blob 和对象 API 来检索配置。
  • 通过 GitHub 机构或使用 Prow 风格的 OWNER 文件访问控制列表(ACL)
  • tkn CLI 工具的 tkn pac 插件，您可以使用它们管理 Pipelines 作为代码软件仓库和 bootstrap。
  • 支持 GitHub 应用程序、GitHub Webhook、Bitbucket 服务器和 Bitbucket 云。

4.1.6.2. 已弃用的功能
复制链接

  • 中断更改：此更新从 TektonConfig 自定义资源(CR)中删除 disable-working-directory-overwrite 和 disable-home-env-overwrite 字段。因此，TektonConfig CR 不再自动设置 $HOME 环境变量和 workingDir 参数。您仍然可以使用 Task 自定义资源定义(CRD)中的 env 和 workingDir 字段来设置 $HOME 环境变量和 workingDir 参数。
  • Conditions 自定义资源定义(CRD)类型已弃用，计划在以后的发行版本中删除。反之，使用推荐的 when 表达式。
  • 有问题的更改： Triggers 资源验证模板，并在没有指定 EventListener 和 TriggerBinding 值时生成错误。

4.1.6.3. 已知问题
复制链接

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

    提示

    在您使用 tkn hub 在 ARM、IBM Power Systems(ppc64le)、IBM Z 和 LinuxONE(s390x) 上基于 Tekton Catalog 安装任务前，请验证是否可以在这些平台上执行任务。要检查 ppc64le 和 s390x 是否列在任务信息的"Platforms"部分，您可以运行以下命令： tkn hub info task <name>

  • 在 IBM Power Systems、IBM Z 和 LinuxONE 中，不支持 s2i-dotnet 集群任务。

  • 您无法使用 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"
    Copy to Clipboard Toggle word wrap
  • 隐式参数映射会错误地将参数从顶级 Pipeline 或 PipelineRun 定义传递给 taskRef 任务。映射应该只在顶层资源中使用任务进行，并带有非线 taskSpec 规格。这个问题只通过将 TektonConfig 自定义资源定义的 pipeline 部分中的 enable-api-fields 字段设置为 alpha 来影响启用了这个功能的集群。

4.1.6.4. 修复的问题
复制链接

  • 在这个版本中，如果 Pipeline 和 PipelineRun 对象定义中存在 labels 和 annotations 的元数据，PipelineRun 类型中的值会具有优先权。您可以观察 Task 和 TaskRun 对象的类似行为。
  • 在这个版本中，如果 timeout.tasks 字段或 timeout.finally 字段设置为 0，则 timeout.pipeline 也被设置为 0。
  • 在这个版本中，-x set 标记已从不使用 shebang 的脚本中删除。在这个版本中，减少了脚本执行的潜在数据泄漏。
  • 在这个版本中，Git 凭证中的用户名中存在的任何反斜杠字符都会被转义，并带有 .gitconfig 文件中的额外反斜杠。
  • 在这个版本中，EventListener 对象的 finalizer 属性不需要清理日志记录和配置映射。
  • 在这个版本中，与事件监听器服务器关联的默认 HTTP 客户端会被删除，并添加自定义 HTTP 客户端。因此，超时有所改进。
  • 在这个版本中，Triggers 集群角色现在可以处理所有者引用。
  • 在这个版本中，当多个拦截器返回扩展时，事件监听器中的竞争条件不会发生。
  • 在这个版本中，tkn pr delete 命令不会删除使用 ignore-running 标记运行的管道。
  • 在这个版本中，当您修改任何附加组件参数时，Operator pod 不会继续重启。
  • 在这个版本中，如果订阅和配置自定义资源中没有配置，tkn serve CLI pod 会被调度到 infra 节点上。
  • 在这个版本中，在升级过程中不会删除指定版本的集群任务。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA)1.7.1 包括在 OpenShift Container Platform 4.9, 4.10, 和 4.11 中。

4.1.6.5.1. 修复的问题
复制链接
  • 在此次更新之前，升级 Red Hat OpenShift Pipelines Operator 会删除与 Tekton Hub 关联的数据库中的数据并安装新的数据库。在这个版本中，Operator 升级会保留数据。
  • 在此次更新之前，只有集群管理员才能访问 OpenShift Container Platform 控制台中的管道指标。在这个版本中，与其他集群角色的用户也可以访问管道指标。
  • 在此次更新之前，管道对包含发出大型终止消息的任务的管道运行失败。管道运行失败，因为 pod 中所有容器的终止信息总数不能超过 12 KB。在这个版本中，使用同一镜像的 place-tools 和 step-init 初始化容器会合并，以减少每个任务的 pod 中运行的容器数量。该解决方案可减少运行失败管道的几率，这可尽量减少在任务 pod 中运行的容器数量。但是，它不会删除终止消息的最大允许大小限制。
  • 在此次更新之前，直接从 Tekton Hub web 控制台访问资源 URL 会导致 Nginx 404 错误。在这个版本中，Tekton Hub web 控制台镜像已被修复，以便直接从 Tekton Hub web 控制台访问资源 URL。
  • 在此次更新之前，对于每个命名空间，资源修剪器作业都会创建一个单独的容器来修剪资源。在这个版本中，资源修剪器作业作为一个容器中的一个循环运行所有命名空间的命令。

在这个版本中，Red Hat OpenShift Pipelines General Availability (GA)1.7.2 包括在 OpenShift Container Platform 4.9、4.10 及以后的版本中。

4.1.6.6.1. 已知问题
复制链接
  • 在升级 Red Hat OpenShift Pipelines Operator 后，openshift-pipelines 命名空间中的 Tekton Chains 的 chains-config 配置映射会自动重置为默认。目前，这个问题还没有临时解决方案。
4.1.6.6.2. 修复的问题
复制链接
  • 在此次更新之前，当将 init 用作第一个参数并后跟两个或更多个参数时，Pipelines 1.7.1 上的任务会失败。在这个版本中，这些标志会被正确解析，任务可以运行成功。

  • 在此次更新之前，因为存在无效的角色绑定，在 OpenShift Container Platform 4.9 和 4.10 上安装 Red Hat OpenShift Pipelines Operator 会失败，并显示以下错误消息： 

    error updating rolebinding openshift-operators-prometheus-k8s-read-binding: RoleBinding.rbac.authorization.k8s.io "openshift-operators-prometheus-k8s-read-binding" is invalid: roleRef: Invalid value: rbac.RoleRef{APIGroup:"rbac.authorization.k8s.io", Kind:"Role", Name:"openshift-operator-read"}: cannot change roleRef
    Copy to Clipboard Toggle word wrap

    在这个版本中，Red Hat OpenShift Pipelines Operator 安装有不同的角色绑定命名空间，以避免与其他 Operator 安装冲突。

  • 在此次更新之前，升级 Operator 会触发 Tekton Chains 的 signed-secrets secret 键重置为默认值。在这个版本中，在升级 Operator 后自定义 secret 密钥会保留。

    注意

    升级到 Red Hat OpenShift Pipelines 1.7.2 会重置密钥。但是，当您升级到将来的版本时，会需要保留该密钥。

  • 在此次更新之前，所有 S2I 构建任务都会失败，并显示类似以下消息的错误： 

    Error: error writing "0 0 4294967295\n" to /proc/22/uid_map: write /proc/22/uid_map: operation not permitted
time="2022-03-04T09:47:57Z" level=error msg="error writing \"0 0 4294967295\\n\" to /proc/22/uid_map: write /proc/22/uid_map: operation not permitted"
time="2022-03-04T09:47:57Z" level=error msg="(unable to determine exit status)"
    Copy to Clipboard Toggle word wrap

    在这个版本中，pipeline-scc 安全性上下文约束 (SCC) 与 Buildah 和 S2I 集群任务所需的 SETFCAP 功能兼容。因此，Buildah 和 S2I 构建任务可以成功运行。

    要成功运行 Buildah 集群任务和 S2I 构建任务，适用于使用各种语言和框架编写的应用程序，添加以下适当的 steps 对象（如 build 和 push）的代码片段。 

    securityContext:
  capabilities:
    add: ["SETFCAP"]
    Copy to Clipboard Toggle word wrap

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA)1.7.3 包括在 OpenShift Container Platform 4.9, 4.10, 和 4.11 中。

4.1.6.7.1. 修复的问题
复制链接
  • 在此次更新之前，如果任何命名空间处于 Terminating 状态，Operator 会在创建 RBAC 资源时失败。在这个版本中，Operator 忽略了命名空间处于 Terminating 状态，并创建 RBAC 资源。
  • 在以前的版本中，升级 Red Hat OpenShift Pipelines Operator 会导致重新创建 pipeline 服务帐户，这意味着链接到服务帐户的 secret 会丢失。在这个版本中解决了这个问题。在升级过程中，Operator 不再重新创建 pipeline 服务帐户。因此，已附加到 pipeline 服务帐户的 secret 在升级后会保留，资源（任务和管道）可以继续正常工作。

在这个版本中，Red Hat OpenShift Pipelines 正式发行(GA)1.6 包括在 OpenShift Container Platform 4.9 中。

4.1.7.1. 新功能
复制链接

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.6 中的新内容。

  • 在这个版本中，您可以配置管道或任务的 start 命令（使用 --output <string>，其中 <string> 是 yaml 或 json ）来返回 YAML 或 JSON 格式的字符串。如果没有使用 --output 选项，start 命令会返回人类友好的消息，而其他程序很难解析该消息。返回 YAML 或 JSON 格式的字符串对于持续集成(CI)环境非常有用。例如，在创建了资源后，您可以使用 yq 或 jq 解析有关资源的 YAML 或 JSON 格式消息，并等待该资源终止而不使用 showlog 选项。
  • 在这个版本中，您可以使用 Podman 的 auth.json 身份验证文件对 registry 进行身份验证。例如，您可以使用 tkn bundle push 来使用 Podman 而不是 Docker CLI 推送到远程 registry。
  • 在这个版本中，如果您使用 tkn [taskrun | pipelinerun] delete --all 命令，您可以使用新的 --keep-since <minutes> 选项来指定一个分钟数，存在时间少于这个分钟数的运行会被保留。例如，若要保持存在的时间少于五分钟的运行，输入 tkn [taskrun | pipelinerun] delete -all --keep-since 5。
  • 在这个版本中，当删除任务运行或管道运行时，您可以将 --parent-resource 和 --keep-since 选项一起使用。例如，tkn pipelinerun delete --pipeline pipelinename --keep-since 5 命令会保留其父资源名为 pipelinename，其存在时间为五分钟或更短的管道运行。对于任务运行，tkn tr delete -t <taskname> --keep-since 5 和 tkn tr delete --clustertask <taskname> --keep-since 5 有类似效果。
  • 在这个版本中，增加了对用于 v1beta1 资源的触发器资源的支持。
  • 在这个版本中，在 tkn pipelinerun delete 和 tkn taskrun delete 命令中添加了一个 ignore-running 选项。
  • 在这个版本中，为 tkn task 和 tkn clustertask 命令添加一个 create 子命令。
  • 在这个版本中，当使用 tkn pipelinerun delete --all 命令时，您可以使用新的 --label <string> 选项来根据标签过滤管道运行。另外，您还可以在 --label 选项中使用 = 和 == 作为相等运算符，或者 != 作为不相等运算符。例如，tkn pipelinerun delete --all --label asdf 和 tkn pipelinerun delete --all --label==asdf 命令都会删除带有 asdf 标签的所有管道运行。
  • 在这个版本中，您可以从配置映射获取已安装的 Tekton 组件版本，或者从部署控制器获取配置映射的版本。
  • 在这个版本中，触发器支持使用 feature-flags 和 config-defaults 配置映射来分别配置功能标记和设置默认值。
  • 在这个版本中，添加了一个新的指标 eventlistener_event_count，您可以使用它来统计 EventListener 资源接收的事件。

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

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

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

    • operator.tekton.dev/prune.schedule：如果此注解的值与 TektonConfig 自定义资源定义中指定的值不同，则会在该命名空间中创建新的 cron 作业。
    • operator.tekton.dev/prune.skip：设置为 true 时，配置它的命名空间不会被修剪。
    • operator.tekton.dev/prune.resources：此注解接受以逗号分隔的资源列表。要修剪单一资源，如管道运行，将此注解设置为 "pipelinerun"。要修剪多个资源，如任务运行和管道运行，将此注解设置为 "taskrun, pipelinerun"。
    • operator.tekton.dev/prune.keep：使用此注解保留资源而不进行修剪。

    • operator.tekton.dev/prune.keep-since：使用此注解来根据其存在的时间来保留资源。此注解的值必须等于资源的年龄（以分钟为单位）。例如，若要保留在五天内创建的资源，请将 keep-since 设置为 7200。

      注意

      keep 和 keep-since 注释是互斥的。对于任何资源，您只能配置其中一个。

    • operator.tekton.dev/prune.strategy：将此注解的值设置为 keep 或 keep-since。
  • 管理员可以禁用在整个集群中创建 pipeline 服务帐户创建，从而防止因为错误地使用关联的 SCC（这与 anyuid 非常相似）造成权限升级的问题。
  • 现在，您可以使用 TektonConfig 自定义资源(CR)和单个组件的 CR 配置功能标记和组件，如 TektonPipeline 和 TektonTriggers。此级别的颗粒度有助于为各个组件的 Tekton OCI 捆绑包自定义和测试 alpha 功能。
  • 现在，您可以为 PipelineRun 资源配置可选的 Timeouts 字段。例如，您可以单独为管道运行、每个任务运行以及 finally 任务配置超时。
  • TaskRun 资源生成的 Pod 现在会设置 pod 的 activeDeadlineSeconds 字段。这可让 OpenShift 将它们视为终止，并允许您将具有特定作用域的 ResourceQuota 对象用于容器集。
  • 您可以使用 configmaps 在任务运行、管道运行、任务和管道上消除指标标签或标签类型。另外，您可以为测量持续时间配置不同类型的指标，如直方图、量表或最后一个值。
  • 您可以统一定义 pod 的请求和限值，因为 Tekton 现在通过考虑 Min、Max、Default 和 DefaultRequest 字段来全面支持 LimitRange 对象。

  • 引入了以下 alpha 功能：

    • 现在，管道运行可以在运行 finally 任务后停止，而不是之前停止直接运行所有任务的行为。在这个版本中添加了以下 spec.status 值：

      • StoppedRunFinally 将在当前运行的任务完成后停止，然后运行 finally 任务。
      • CancelledRunFinally 将立即取消正在运行的任务，然后运行 finally 任务。

      • Cancelled 将保留 PipelineRunCancelled 状态提供的以前行为。

        注意

        Cancelled 状态替换已弃用的 PipelineRunCancelled 状态，该状态将在 v1 版本中删除。

    • 现在，您可以使用 oc debug 命令将任务运行设置为 debug 模式，这会暂停执行并允许您检查 pod 中的特定步骤。
    • 当您将一个步骤的 onError 字段设置为 continue 时，会记录该步骤的退出代码并传递给后续步骤。但是，任务运行不会失败，任务中其余步骤的执行将继续。要保留现有的行为，您可以将 onError 字段的值设置为 stopAndFail。
    • 任务现在可以接受比实际使用更多的参数。启用 alpha 功能标记时，参数可以隐式传播到内联规格。例如，内联任务可以访问其父管道运行的参数，而不必为任务明确定义每个参数。
    • 如果您为 alpha 功能启用标记，则 When 表达式下的条件将仅适用于直接关联的任务，而不是任务的依赖项。要将 When 表达式应用到关联的任务及其依赖关系中，您必须将表达式与每个相依任务单独关联。请注意，进入下一步是 Tekton 的任何新 API 版本中 When 表达式的默认行为。现有的默认行为将被弃用，而由此更新替代。

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

    • 要为 Operator 的控制器和 webhook 部署配置节点选择，请在安装 Operator 后编辑 Subscription CR 规格中的 config.nodeSelector 和 config.tolerations 字段。
    • 要在基础架构节点上部署 OpenShift Pipelines 的其余 control plane pod，请使用 nodeSelector 和 tolerations 字段更新 TektonConfig CR。然后，修改会应用到 Operator 创建的所有 pod。

4.1.7.2. 已弃用的功能
复制链接

  • 在 CLI 0.21.0 中，已弃用了对 clustertask, task, taskrun, pipeline, 和 pipelinerun 的所有 v1alpha1 资源的支持。这些资源现已过时，并将在以后的发行版本中删除。

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

    重要

    中断更改： status 标签已从 eventlistener_http_duration_seconds_* 指标中删除。删除基于 status 标签的查询。

  • 在当前发行版本中，v1alpha1 功能已弃用，并将在以后的发行版本中删除。在这个版本中，您可以改为使用 v1beta1 Go API 类型。触发器现在支持 v1beta1 API 版本。

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

    重要

    中断更改：使用此更改时，EventListener 资源会在创建资源时停止响应 201 Created 的状态代码。相反，它使用 202 Accepted 的响应代码进行响应。

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

    重要

    中断更改：删除了作为 #1100 一部分的 podTemplate 字段。

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

    重要

    中断更改：已弃用的 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
  ...
    Copy to Clipboard Toggle word wrap
    重要

    TektonConfig CR 中的 disable-working-directory-overwrite 和 disable-home-env-overwrite 字段现已弃用，并将在以后的发行版本中删除。

4.1.7.3. 已知问题
复制链接

  • 当您运行 Maven 和 Jib-Maven 集群任务时，默认容器镜像仅支持 Intel(x86)架构。因此，在 IBM Power Systems(ppc64le)、IBM Z 和 LinuxONE(s390x)集群上的任务将失败。作为临时解决方案，您可以通过将 MAVEN_IMAGE 参数值设置为 maven:3.6.3-adoptopenjdk-11 来指定自定义镜像。
  • 在 IBM Power Systems、IBM Z 和 LinuxONE 中，不支持 s2i-dotnet 集群任务。
  • 在您使用 tkn hub 在 IBM Power Systems(ppc64le)、IBM Z 和 LinuxONE(s390x) 上基于 Tekton Catalog 安装任务前，请验证是否可以在这些平台上执行任务。要检查 ppc64le 和 s390x 是否列在任务信息的"Platforms"部分，您可以运行以下命令： tkn hub info task <name>

  • 您无法使用 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"
    Copy to Clipboard Toggle word wrap

4.1.7.4. 修复的问题
复制链接

  • 现在，IBM Power Systems、IBM Z 和 LinuxONE 支持 tkn hub 命令。
  • 在更新前，当用户运行 tkn 命令并完成管道运行后，终端不可用，即使指定了 retries 也是如此。在任务运行或管道运行中指定超时无效。在这个版本中解决了这个问题，终端可以在运行命令后可用。
  • 在更新前，运行 tkn pipelinerun delete --all 会删除所有资源。在这个版本中，处于 running 状态的资源无法被删除。
  • 在这个版本中，使用 tkn version --component=<component> 命令不会返回组件版本。在这个版本中解决了这个问题，这个命令会返回组件版本。
  • 在更新前，当您使用 tkn pr logs 命令时，它会以错误的任务顺序显示管道输出日志。在这个版本中解决了这个问题，已完成的 PipelineRuns 的日志会在适当的 TaskRun 执行顺序中列出。
  • 在这个版本中，编辑正在运行的管道规格可能会阻止管道运行在完成后停止。在这个版本中，只获取定义一次，然后使用存储在状态中的规格进行验证，从而解决了这个问题。当 PipelineRun 或 TaskRun 指代的 Pipeline 或 Task 在运行时会发生变化，这个变化减少了出现竞争条件的可能性。
  • When 表达式值可以有数组参数引用，例如 values: [$(params.arrayParam[*])]。
4.1.7.5.1. 已知问题
复制链接

  • 从旧版本升级到 Red Hat OpenShift Pipelines 1.6.1 后，Pipelines 可能会进入不一致的状态，因为您无法对 Tekton 资源（tasks 和 pipelines）执行任何操作(create/delete/apply)。例如，在删除资源时，您可能会遇到以下错误： 

    Error from server (InternalError): Internal error occurred: failed calling webhook "validation.webhook.pipeline.tekton.dev": Post "https://tekton-pipelines-webhook.openshift-pipelines.svc:443/resource-validation?timeout=10s": service "tekton-pipelines-webhook" not found.
    Copy to Clipboard Toggle word wrap
4.1.7.5.2. 修复的问题
复制链接

  • Red Hat OpenShift Pipelines 设置的 SSL_CERT_DIR 环境变量(/tekton-custom-certs)不会用证书文件覆盖以下默认系统目录：

    • /etc/pki/tls/certs
    • /etc/ssl/certs
    • /system/etc/security/cacerts
  • Horizontal Pod Autoscaler 可以管理 Red Hat OpenShift Pipelines Operator 控制的部署副本数。在这个发行版本中，如果最终用户或集群代理更改了计数，Red Hat OpenShift Pipelines Operator 不会重置管理的部署的副本计数。但是，升级 Red Hat OpenShift Pipelines Operator 时会重置副本。
  • 现在，根据 TektonConfig 自定义资源中指定的节点选择器和容限(toleration)限制将把 tkn CLI 的 pod 调度到节点上。
4.1.7.6.1. 已知问题
复制链接
  • 当您创建新项目时，pipeline 服务帐户的创建会被延迟，并删除现有集群任务和管道模板需要超过 10 分钟。
4.1.7.6.2. 修复的问题
复制链接
  • 在此次更新之前，在从旧版本升级到 Red Hat OpenShift Pipelines 1.6.1 后，会为管道创建多个 Tekton 安装程序集实例。在这个版本中，Operator 可确保升级后每个类型为 TektonInstallerSet 的一个实例都存在。
  • 在此次更新之前，Operator 中的所有协调程序都使用组件版本在升级到旧版本的 Red Hat OpenShift Pipelines 1.6.1 期间决定资源重新创建。因此，这些资源不会被重新创建，其组件版本没有在升级过程中改变。在这个版本中，Operator 使用 Operator 版本而不是组件版本来决定升级过程中的资源重新创建。
  • 在此次更新之前，升级后，集群中缺少管道 Webhook 服务。这是因为配置映射上的升级死锁。在这个版本中，如果集群中不存在配置映射，添加了一个机制来禁用 Webhook 验证。因此，在升级后管道 Webhook 服务会保留在集群中。
  • 在此次更新之前，在任何配置更改到命名空间后，自动运行操作的 cron 作业会被重新创建。在这个版本中，只有在命名空间中有相关注解改变时，才会重新创建 auto-pruning 的 cron 任务。

  • Tekton Pipelines 的上游版本被修订为 v0.28.3，它包括以下修复：

    • 修复 PipelineRun 或 TaskRun 对象，以允许进行标签或注解。

    • 对于隐式参数：

      • 不要将 PipelineSpec 参数应用到 TaskRefs 对象。
      • 禁用 Pipeline 对象的隐式参数行为。
4.1.7.7.1. 修复的问题
复制链接

  • 在此次更新之前，Red Hat OpenShift Pipelines Operator 从组件（如 Pipelines 和 Triggers）中安装 Pod 安全策略。但是，作为组件的一部分提供的 Pod 安全策略在以前的版本中已被弃用。在这个版本中，Operator 会停止从组件安装 Pod 安全策略。因此，以下升级路径会受到影响：

    • 从 Pipelines 1.6.1 或 1.6.2 升级到 Pipelines 1.6.3 会删除 Pod 安全策略，包括 Pipelines 和 Triggers 组件中的 Pod 安全策略。

    • 从 Pipelines 1.5.x 升级到 1.6.3 会保留从组件安装的 Pod 安全策略。作为集群管理员，您可以手动删除它们。

      注意

      当您升级到将来的版本时，Red Hat OpenShift Pipelines Operator 会自动删除所有过时的 Pod 安全策略。

  • 在此次更新之前，只有集群管理员才能访问 OpenShift Container Platform 控制台中的管道指标。在这个版本中，与其他集群角色的用户也可以访问管道指标。
  • 在此次更新之前，带有 Pipelines Operator 的基于角色的访问控制(RBAC)问题会导致升级或安装组件的问题。这个版本提高了安装各种 Red Hat OpenShift Pipelines 组件的可靠性和一致性。
  • 在此次更新之前，在 TektonConfig CR 中将 clusterTasks 和 pipelineTemplates 字段设置为 false 时，会降低删除集群任务和管道模板。这个版本提高了 Tekton 资源（如集群任务和管道模板）的生命周期管理速度。
4.1.7.8.1. 已知问题
复制链接

  • 从 Red Hat OpenShift Pipelines 1.5.2 升级到 1.6.4 后，访问事件监听程序路由会返回 503 错误。

    临时解决方案：修改事件监听器路由的 YAML 文件中的目标端口。

    1. 为相关命名空间提取路由名称。 

      $ oc get route -n <namespace>
      Copy to Clipboard Toggle word wrap

    2. 编辑路由以修改 targetPort 字段的值。 

      $ oc edit route -n <namespace> <el-route_name>
      Copy to Clipboard Toggle word wrap

      示例：现有事件监听程序路由

      ...
spec:
  host: el-event-listener-q8c3w5-test-upgrade1.apps.ve49aws.aws.ospqa.com
  port:
    targetPort: 8000
  to:
    kind: Service
    name: el-event-listener-q8c3w5
    weight: 100
  wildcardPolicy: None
...
      Copy to Clipboard Toggle word wrap

      示例：修改事件监听程序路由

      ...
spec:
  host: el-event-listener-q8c3w5-test-upgrade1.apps.ve49aws.aws.ospqa.com
  port:
    targetPort: http-listener
  to:
    kind: Service
    name: el-event-listener-q8c3w5
    weight: 100
  wildcardPolicy: None
...
      Copy to Clipboard Toggle word wrap

4.1.7.8.2. 修复的问题
复制链接
  • 在此次更新之前，如果任何命名空间处于 Terminating 状态，Operator 会在创建 RBAC 资源时失败。在这个版本中，Operator 忽略了命名空间处于 Terminating 状态，并创建 RBAC 资源。
  • 在此次更新之前，该任务会在没有注解指定关联的 Tekton 控制器发行版本而运行失败或重启。在这个版本中，包含适当的注解会被自动运行，没有失败或重启的任务。

Red Hat OpenShift Pipelines General Availability (GA) 1.5 现在包括在 OpenShift Container Platform 4.8 中。

4.1.8.1. 兼容性和支持列表
复制链接

这个版本中的一些功能当前还只是一个技术预览。它们并不适用于在生产环境中使用。

在下表中，被标记为以下状态的功能：

TP

技术预览

GA

公开发行

请参阅红帽门户网站中关于对技术预览功能支持范围的信息：

Expand
表 4.2. 兼容性和支持列表
功能版本支持状态

Pipelines

0.24

GA

CLI

0.19

GA

目录

0.24

GA

触发器

0.14

TP

Pipeline 资源

-

TP

如果您有疑问或希望提供反馈信息，请向产品团队发送邮件 pipelines-interest@redhat.com。

4.1.8.2. 新功能
复制链接

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.5 中的新内容。

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

    ...
pruner:
  resources:
    - pipelinerun
    - taskrun
  schedule: "*/5 * * * *" # cron schedule
  keep: 2 # delete all keeping n
...
    Copy to Clipboard Toggle word wrap

  • 在 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"
...
    Copy to Clipboard Toggle word wrap

    如果您使用 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"
...
    Copy to Clipboard Toggle word wrap
  • 添加了 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.10/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
    Copy to Clipboard Toggle word wrap
  • 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 添加入口点二进制构建。

4.1.8.3. 已弃用的功能
复制链接

  • 在 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
...
    Copy to Clipboard Toggle word wrap

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

    Expand
    表 4.3. 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 自定义资源定义，它已在此发行版本中排除。

4.1.8.4. 已知问题
复制链接

  • 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)
...
        Copy to Clipboard Toggle word wrap
        警告

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

4.1.8.5. 修复的问题
复制链接

  • 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 标记的描述现在一致。
  • 在解析参数时，如果遇到空数组，则对应的交互式帮助现在会显示为空字符串。

Red Hat OpenShift Pipelines General Availability（GA）1.4 现在包括在 OpenShift Container Platform 4.7 中。

注意

除了 stable 和 preview Operator 频道外，Red Hat OpenShift Pipelines Operator 1.4.0 还带有 ocp-4.6、ocp-4.5 和 ocp-4.4 弃用的频道。这些过时的频道及其支持将在以下 Red Hat OpenShift Pipelines 发行版本中删除。

4.1.9.1. 兼容性和支持列表
复制链接

这个版本中的一些功能当前还只是一个技术预览。它们并不适用于在生产环境中使用。

在下表中，被标记为以下状态的功能：

TP

技术预览

GA

公开发行

请参阅红帽门户网站中关于对技术预览功能支持范围的信息：

Expand
表 4.4. 兼容性和支持列表
功能版本支持状态

Pipelines

0.22

GA

CLI

0.17

GA

目录

0.22

GA

触发器

0.12

TP

Pipeline 资源

-

TP

如果您有疑问或希望提供反馈信息，请向产品团队发送邮件 pipelines-interest@redhat.com。

4.1.9.2. 新功能
复制链接

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.4 中的新内容。

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

    • 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
    Copy to Clipboard Toggle word wrap

4.1.9.3. 已弃用的功能
复制链接

  • 不支持 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。

4.1.9.4. 已知问题
复制链接

  • 在 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)
    Copy to Clipboard Toggle word wrap

    要解决这个问题：

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

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

      annotations:
  triggers.tekton.dev/old-escape-quotes: "true"
      Copy to Clipboard Toggle word wrap
  • 当从 Pipelines 1.3.x 升级到 1.4.x 时，您必须重新创建路由。

4.1.9.5. 修复的问题
复制链接

  • 在以前的版本中，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 的功能和行为。

4.1.10.1. 新功能
复制链接

Red Hat OpenShift Pipelines 技术预览（TP）1.3 现在包括在 OpenShift Container Platform 4.7 中。Red Hat OpenShift Pipelines TP 1.3 更新为支持：

  • 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

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.3 中的新内容。

4.1.10.1.1. Pipelines
复制链接
  • 构建镜像的任务，如 S2I 和 Buildah 任务，现在发出构建的镜像 URL，其中包含镜像 SHA。
  • 由于 Conditions 自定义资源定义（CRD）已弃用，管道任务中引用自定义资源的条件会被禁止。
  • 现在，在 Task CRD 中为以下字段添加了变量扩展： spec.steps[].imagePullPolicy 和 spec.sidecar[].imagePullPolicy。
  • 您可以通过将 disable-creds-init feature-flag 设置为 true 来禁用 Tekton 中的内置凭证机制。
  • 现在，当在 PipelineRun 配置的 Status 字段中的 Skipped Tasks 和 Task Runs 部分中列出了表达式时，可以解析。
  • git init 命令现在可以克隆递归子模块。
  • 现在，Task CR 的作者可以为 Task spec 的一个步骤指定超时。
  • 现在，您可以将入口点镜像基于 distroless/static:nonroot 镜像，赋予将其复制到目的地的模式，而无需依赖基础镜像中存在的 cp 命令。
  • 现在，您可以使用配置标记 require-git-ssh-secret-known-hosts 来禁止在 Git SSH secret 中省略已知主机。当标志值设为 true 时，必须在 Git SSH secret 中包含 known_host 字段。标志的默认值为 false。
  • 现在引进了可选工作区的概念。任务或管道可能会声明一个工作区（workspace），并有条件地更改其行为。任务运行或管道运行可能省略了工作区，因此修改任务或管道行为。默认任务运行工作区不会添加到忽略的可选工作区。
  • 现在，在 Tekton 中进行凭证初始化会检测一个与非 SSH URL 搭配使用的 SSH 凭证，而 Git pipeline 资源与 Git pipeline 资源相同，并在步骤容器中记录警告。
  • 如果 pod 模板指定的关联性被关联性代理覆盖，则任务运行控制器会发出警告事件。
  • 任务运行协调程序现在记录了在任务运行完成后发送的云事件的指标。这包括重试。
4.1.10.1.2. Pipelines CLI
复制链接
  • 现在，在以下命令中添加了对 --no-headers flag 的支持： tkn condition list、tkn triggerbinding list、tkn eventlistener list、tkn clustertask list、tkn clustertriggerbinding list。
  • 当一起使用时，--last 或 --use 选项会覆盖 --prefix-name 和 --timeout 选项。
  • 现在，添加了 tkn eventlistener logs 命令来查看 EventListener 日志。
  • tekton hub 命令现在被集成到 tkn CLI。
  • --nocolour 选项现在改为 --no-color。
  • --all-namespaces 标志添加到以下命令中： tkn triggertemplate list、tkn condition list、tkn triggerbinding list、tkn eventlistener list。
4.1.10.1.3. 触发器
复制链接
  • 现在，您可以在 EventListener 模板中指定资源信息。
  • 现在，EventListener 服务帐户除具有所有触发器资源的 get verb 外，还具有 list 和 watch verb。这可让您使用 Listers 从 EventListener、Trigger、TriggerBinding、TriggerTemplate 和 ClusterTriggerBinding 资源中获取数据。您可以使用此功能创建 Sink 对象，而不是指定多个通知器，直接向 API 服务器发出调用。
  • 添加了一个新的 Interceptor 接口，以支持不可变的输入事件正文。拦截器现在可以在一个新的 extensions 字段中添加数据或字段，且无法修改输入正文使其不可变。CEL 拦截器使用这个新的 Interceptor 接口。
  • 在 EventListener 资源中添加了一个 namespaceSelector 字段。使用它来指定 EventListener 资源可以从中获取用于处理事件的 Trigger 对象的命名空间。要使用 namespaceSelector 字段，EventListener 资源的服务帐户必须具有集群角色。
  • 触发器 EventListener 资源现在支持到 eventlistener pod 的端到端安全连接。
  • 在 TriggerTemplates 资源中把 " 替换为 \" 的转义行为现在已被删除。
  • 一个支持 Kubernetes 资源的、新的 resources 项已作为 EventListener spec 的一部分被添加。
  • 添加了对 CEL 拦截器的新功能，它支持 ASCII 字符串的大写和小写。
  • 您可以使用触发器中的 name 和 value 字段，或事件监听程序来嵌入 TriggerBinding 资源。
  • PodSecurityPolicy 配置已更新，可在受限环境中运行。它确保容器必须以非 root 运行。另外，使用 Pod 安全策略的基于角色的访问控制也从集群范围移到命名空间范围。这样可确保触发器无法使用与命名空间不相关的其他 Pod 安全策略。
  • 现在，添加了对内嵌触发器模板的支持。您可以使用 name 字段来指代嵌入的模板，或者在 spec 字段中嵌入模板。

4.1.10.2. 已弃用的功能
复制链接

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

4.1.10.3. 已知问题
复制链接

  • 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 集群任务相同的方法。

4.1.10.4. 修复的问题
复制链接

  • 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。
  • 现在，当同一个持久性卷声明用于多个工作区，但具有不同子路径时，支持验证是否与关联性偏好兼容。

4.1.11.1. 新功能
复制链接

Red Hat OpenShift Pipelines 技术预览（TP）1.2 现在包括在 OpenShift Container Platform 4.6 中。Red Hat OpenShift Pipelines TP 1.2 更新为支持：

  • 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

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.2 中的新内容。

4.1.11.1.1. Pipelines
复制链接

  • 此 Red Hat OpenShift Pipelines 发行版本添加了对断开连接的安装的支持。

    注意

    IBM Power Systems、IBM Z 和 LinuxONE 目前不支持在受限环境中安装。

  • 现在，您可以使用 when 字段而不是 conditions 资源，仅在满足特定条件时运行任务。WhenExpression 资源的关键组件是 Input、Operator 和 Values。如果所有表达式都评估的结果都为 True， 则任务运行。如果表达式评估的结果为 False，则任务被跳过。
  • 现在，如果某个任务运行被取消或超时，则步骤（Step）状态被更新。
  • 现在，支持 Git 大文件存储（LFS）来使用 git-init 构建基础镜像。
  • 现在，当某个任务嵌入到管道中时，您可以使用 taskSpec 字段来指定元数据，如标识（label）和注解（annotation）。
  • 现在，Pipeline 运行支持云事件。现在，对于云事件管道资源发送的带有 backoff 的云事件会进行重试。
  • 现在，可以为声明了 Task、但没有明确指定 TaskRun 资源的工作区（workspace）设置一个默认的 Workspace 配置。
  • 支持 PipelineRun 命名空间和 TaskRun 命名空间的命名空间变量插入。
  • 现在，添加了对 TaskRun 对象的验证，以检查当 TaskRun 资源与 Affinity Assistant 关联时，是否使用一个以上的持久性卷声明工作区。如果使用多个持久性卷声明工作区，则任务运行会失败，并且有一个 TaskRunValidationFailed 条件。请注意，默认情况下， Affinity Assistant 在 Red Hat OpenShift Pipelines 中被禁用，因此您需要启用 Affinity Assistant 来使用它。
4.1.11.1.2. Pipelines CLI
复制链接

  • tkn task describe、tkn taskrun describe、tkn clustertask describe、tkn pipeline describe 和 tkn pipelinerun describe 命令现在：

    • 如果存在其中之一，会自动选择 Task、TaskRun、ClusterTask、Pipeline 和 PipelineRun。
    • 在相应的输出中显示 Task、TaskRun、ClusterTask、Pipeline 和 PipelineRun 资源的结果。
    • 在相应的输出中显示 Task、TaskRun、ClusterTask、Pipeline 和 PipelineRun 资源中声明的工作区。
  • 现在，您可以使用 tkn clustertask start 命令的 --prefix-name 选项指定任务运行名称前缀。
  • 现在为 tkn clustertask start 命令提供了互动模式支持。
  • 现在，您可以使用 TaskRun 和 PipelineRun 对象的本地或远程文件定义指定管道支持的 PodTemplate 属性。
  • 现在，您可以在 tkn clustertask start 命令中使用 --use-params-defaults 选项，使用 ClusterTask 配置中设置的默认值并创建任务运行。
  • 现在，如果有些参数没有指定默认值，tkn pipeline start 命令的 --use-param-defaults 标志会提示以互动模式提供。
4.1.11.1.3. 触发器
复制链接
  • 添加了一个名为 parseYAML 的通用表达语言（CEL）函数，用来将 YAML 字符串解析为一个映射的字符串。
  • 在评估表达式和解析 hook 正文以创建评估环境时，改进了解析 CEL 表达式的错误消息，使其更加精细。
  • 现在，可以支持 marsing 布尔值和映射，如果它们被用作 CEL 覆盖机制中的表达式值。

  • 在 EventListener 对象中添加了以下字段：

    • replicas 字段通过在 YAML 文件中指定副本数，使事件监听程序能够运行多个 pod。
    • NodeSelector 字段使 EventListener 对象能够将事件监听器 pod 调度到特定的节点。
  • Webhook 拦截器现在可以解析 EventListener-Request-URL 标头，从事件监听器处理的原始请求 URL 中提取参数。
  • 现在，事件监听器的注解可以被传播到部署、服务和其他 pod。请注意，服务或部署的自定义注解将被覆盖，因此必须在事件监听程序注解中添加它们以便传播它们。
  • 现在，当用户将 spec.replicas 值指定为 负数 或 零时，可以正确验证 EventListener 规格中的副本。
  • 现在，您可以在 EventListener spec 中指定 TriggerCRD 项，作为一个使用 TriggerRef 项的引用来独立创建 TriggerCRD 项，然后在EventListener spec 中绑定它。
  • 现在，提供了对 TriggerCRD 对象的验证和默认值。

4.1.11.2. 已弃用的功能
复制链接

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

4.1.11.3. 已知问题
复制链接

  • 此 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
      Copy to Clipboard Toggle word wrap

      例如： 

      $ oc patch el/github-listener-interceptor -p '{"metadata":{"finalizers":["foregroundDeletion"]}}' --type=merge
      Copy to Clipboard Toggle word wrap

    2. 删除 EventListener CRD: 

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

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

    Error executing command: fork/exec /bin/bash: exec format error
    Copy to Clipboard Toggle word wrap

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

    $ skopeo inspect --raw <image_name>| jq '.manifests[] | select(.platform.architecture == "<architecture>") | .digest'
    Copy to Clipboard Toggle word wrap

4.1.11.4. 修复的问题
复制链接

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

4.1.12.1. 新功能
复制链接

Red Hat OpenShift Pipelines 技术预览（TP）1.1 现在包括在 OpenShift Container Platform 4.5 中。Red Hat OpenShift Pipelines TP 1.1 更新为支持：

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

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.1 中的新内容。

4.1.12.1.1. Pipelines
复制链接
  • 现在可以使用工作区而不是管道资源。建议您在 OpenShift Pipelines 中使用 Workspaces 而不是 PipelineResources，因为 PipelineResources 很难调试，范围有限，且不容易重复使用。如需有关 Workspaces 的更多信息，请参阅了解 OpenShift Pipelines。

  • 添加了对卷声明模板的工作空间支持：

    • 管道运行和任务运行的卷声明模板现在可以添加为工作区的卷源。然后，tkton-controller 使用模板创建一个持久性卷声明（PVC），该模板被视为管道中运行的所有任务的 PVC。因此，您不需要在每次绑定多个任务的工作空间时都定义 PVC 配置。
    • 当卷声明模板用作卷源时，支持使用变量替换来查找 PVC 名称。

  • 支持改进的审核：

    • PipelineRun.Status 字段现在包含管道中运行的每个任务的状态，以及用于实例化用于监控管道运行进度的管道规格。
    • Pipeline 结果已添加到 pipeline 规格和 PipelineRun 状态中。
    • TaskRun.Status 字段现在包含用于实例化 TaskRun 资源的具体任务规格。
  • 支持在条件中应用默认参数。
  • 现在，通过引用集群任务创建的任务运行会添加 tekton.dev/clusterTask 标签，而不是 tekton.dev/task 标签。
  • kube config writer 现在在资源结构中添加了 ClientKeyData 和 ClientCertificateData 配置，以便使用 kubeconfig-creator 任务替换 pipeline 资源类型集群。
  • 现在，feature-flags 和 config-defaults 配置映射的名称可以自定义。
  • 现在，在任务运行使用的 pod 模板中支持主机网络。
  • 现在，可以使用 Affinity Assistant 支持任务运行中共享工作空间卷的节点关联性。默认情况下，这在 OpenShift Pipelines 上被禁用。
  • Pod 模板已更新，使用 imagePullSecrets 指定在启动一个 pod 时，容器运行时用来拉取容器镜像的 secret。
  • 如果控制器无法更新任务运行，则支持从任务运行控制器发出警告事件。
  • 在所有资源中添加了标准或者推荐的 k8s 标签，以标识属于应用程序或组件的资源。
  • 现在，Entrypoint 进程被通知有信号，然后这些信号会使用一个 Entrypoint 进程的专用 PID 组来传播这些信号。
  • pod 模板现在可以在运行时使用任务运行 specs 在任务级别设置。

  • 支持放出 Kubernetes 事件：

    • 控制器现在会为其他任务运行生命周期事件发出事件 - taskrun started 和 taskrun running。
    • 频道运行控制器现在会在管道每次启动时放出一个事件。
  • 除了默认的 Kubernetes 事件外，现在还提供对任务运行的支持。可将控制器配置为发送任何任务运行事件（如创建、启动和失败）作为云事件。
  • 支持使用 $context.<task|taskRun|pipelineRun>.name 变量来引用管道运行和任务运行时的适当名称。
  • 现在提供了管道运行参数的验证，以确保管道运行提供了管道所需的所有参数。这也允许管道运行在所需参数之外提供额外的参数。
  • 现在，您可以使用管道 YAML 文件中的 finally 字段指定管道中的任务，这些任务会在管道退出前始终执行。
  • git-clone 集群任务现在可用。
4.1.12.1.2. Pipelines CLI
复制链接
  • tkn dlistener describe 命令现在可以支持内嵌触发器绑定。
  • 支持在使用不正确的子命令时推荐子命令并给出建议。
  • 现在，如果管道中只有一个任务存在，tkn task describe 命令会自动选择该任务。
  • 现在您可以使用默认参数值启动任务，方法是在 tkn task start 命令中指定 --use-param-defaults 标记。
  • 现在，您可以使用 tkn pipeline start 或 tkn task start 命令的 --workspace 选项为管道运行或任务指定卷声明模板。
  • tkn pipelinerun logs 命令现在会显示 finally 部分中列出的最终任务的日志。
  • 现在，为 tkn task start 命令提供了互动模式支持，并为以下 tkn 资源提供 describe 子命令： pipeline, PipelineRun、task、taskrun、clustertask 和 pipelineresource。
  • tkn version 命令现在显示集群中安装的触发器版本。
  • tkn pipeline describe 命令现在显示为频道中使用的任务指定的参数值和超时。
  • 添加了对 tkn pipelinerun describe 和 tkn taskrun describe 命令的 --last 选项的支持，以分别描述最新的频道运行或任务运行。
  • tkn pipeline describe 命令现在显示管道中适用于任务的条件。
  • 现在，您可以在 tkn resource list 命令中使用 --no-headers 和 --all-namespaces 标记。
4.1.12.1.3. 触发器
复制链接

  • 现在以下通用表达式语言（CEL）功能可用：

    • parseURL 用来解析和提取一个 URL 的部分内容
    • parseJSON 用来解析嵌入在 deployment webhook 中的 payload 字段中的字符串中的 JSON 值类型
  • 添加了来自 Bitbucket 的 webhook 的新拦截器。
  • 现在，在使用 kubectl get 列出时，事件监听器会显示 Address URL 和 Available status 作为额外的项。
  • 触发器模板参数现在使用 $(tt.params.<paramName>) 语法而不是 $(params.<paramName>) 来减少触发器模板和资源模板参数之间的混淆。
  • 现在，您可以在 EventListener CRD 中添加 容限，以确保事件监听程序使用相同的配置，即使所有节点都因为安全或管理问题而产生污点也是如此。
  • 现在，您可以在 URL/live 中为事件监听器添加就绪探测（Readiness Probe）。
  • 现在，添加了对在事件监听器触发器中嵌入 TriggerBinding 规格的支持。
  • 触发器资源现在附带推荐的 app.kubernetes.io 标签注解。

4.1.12.2. 已弃用的功能
复制链接

本发行版本中已弃用了以下内容：

  • 所有集群范围命令（包括 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 集群任务已弃用。

4.1.12.3. 已知问题
复制链接

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

4.1.12.4. 修复的问题
复制链接

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

4.1.13.1. 新功能
复制链接

Red Hat OpenShift Pipelines 技术预览（TP）1.0 现在包括在 OpenShift Container Platform 4.4 中。Red Hat OpenShift Pipelines TP 1.0 更新为支持：

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

除了包括修复和稳定性改进的信息外，以下小节突出介绍了 Red Hat OpenShift Pipelines 1.0 中的新内容。

4.1.13.1.1. Pipelines
复制链接
  • 支持 v1beta1 API 版本。
  • 支持改进的限制范围。在以前的版本中，限制范围仅为任务运行和管道运行指定。现在不需要显式指定限制范围。使用命名空间中的最小限制范围。
  • 支持使用任务结果和任务参数在任务间共享数据。
  • 现在，管道可以被配置为不覆盖 HOME 环境变量和步骤的工作目录。
  • 与任务步骤类似，sidecar 现在支持脚本模式。
  • 现在，您可以在任务运行 podTemplate 资源中指定不同的调度程序名称。
  • 支持使用 Star Array Notation 替换变量。
  • Tekton 控制器现在可以配置为监控单个命名空间。
  • 现在，在管道、任务、集群任务、资源和条件规格中添加了一个新的 description 字段。
  • 在 Git pipeline 资源中添加代理参数。
4.1.13.1.2. Pipelines CLI
复制链接
  • 现在为以下 tkn 资源添加了 describe 子命令： EventListener、Condition、 triggerTemplate、ClusterTask 和 TriggerSBinding。
  • 在以下资源中添加 v1beta1 支持以及 v1alpha1 的向后兼容性： ClusterTask、Task、 Pipeline、PipelineRun 和 TaskRun。

  • 以下命令现在可以使用 --all-namespaces 标志选项列出所有命名空间的输出结果： tkn task list、tkn pipeline list、tkn taskrun list 和 tkn pipelinerun list

    这些命令的输出也可以通过 --no-headers 选项在没有标头的情况下显示信息。

  • 现在您可以使用默认参数值启动管道，方法是在 tkn pipelines start 命令中指定 --use-param-defaults 标记。
  • 现在，在 tkn pipeline start 和 tkn task start 命令中增加了对工作区的支持。
  • 现在增加了一个新命令 clustertriggerbinding，它带有以下子命令：describe、delete 和 list。
  • 现在，您可以使用本地或远程 yaml 文件直接启动管道运行。
  • describe 子命令现在显示一个改进的详细输出。现在，除了新的项，如 description、timeout、param description 和 sidecar status，命令输出还提供了关于一个特定 tkn 资源的更详细的信息。
  • 现在，如果命名空间中只有一个任务，tkn task log 命令会直接显示日志。
4.1.13.1.3. 触发器
复制链接
  • 现在触发器可以同时创建 v1alpha1 和 v1beta1 管道资源。
  • 支持新的通用表达式语言(CEL)拦截器功能 - compareSecret。此功能安全地将字符串与 CEL 表达式中的 secret 进行比较。
  • 支持在事件监听器触发器级别进行身份验证和授权。

4.1.13.2. 已弃用的功能
复制链接

本发行版本中已弃用了以下内容：

  • 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。这些已弃用的标记可能会在以后的版本中删除。

4.1.13.3. 已知问题
复制链接

  • 如果您要从 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.
    Copy to Clipboard Toggle word wrap

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

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

      $ oc login -u <login> -p <password> https://openshift.example.com:6443
      Copy to Clipboard Toggle word wrap

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

      $ oc edit clustertask buildah
      Copy to Clipboard Toggle word wrap

      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)']
      Copy to Clipboard Toggle word wrap

    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)']
      Copy to Clipboard Toggle word wrap
    5. 保存文件并退出。

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

4.1.13.4. 修复的问题
复制链接

  • 在以前的版本中，即使镜像构建已在进行中，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 控制台中的管道部分没有为非管理员用户显示。这个问题现已解决。
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat