#发版日志

#兼容性和支持矩阵

下表显示了 Alauda Container Platform Pipelines operator 与 ACP 版本之间的兼容性和支持矩阵。

#Channel 映射

另请参阅 生命周期策略 和 安装，了解 Subscription 示例。

#v4.6.4

#新增和优化的功能

Tekton Hub

• 全新安装默认不再部署集群内的 Tekton Hub；Hub 功能通过 ArtifactHub shim 提供。从包含已部署 Tekton Hub 的早期 v4.6.x 版本升级时，现有的 Tekton Hub 组件及其 catalog artifacts 现在会保留并继续可用，因此现有的 Task 和 Pipeline 引用仍可继续解析。全新安装和升级路径均可在 air-gapped 环境中运行。升级期间，operator 会记录环境中已运行的 catalog image 并将其固定，同时保留现有的 catalog ConfigMap，使其不会被垃圾回收。
• 新增 operator 级环境变量 AUTOINSTALL_TEKTONHUB（在 operator Deployment 上设置），用于通过三个值控制 Tekton Hub 的管理：preserve（默认值 — 保留现有 Hub，并且在全新安装时不部署 Hub）、true（显式部署并保留 Hub，适用于 all profile）以及 false（显式移除任何现有 Hub — 具有破坏性，仅可选择性启用）。未设置或无法识别的值均按 preserve 处理。

#重大变更

全新安装默认不再部署集群内的 Tekton Hub（早期的 v4.6.0 – v4.6.3 版本会自动部署它）；Hub 功能现在通过 ArtifactHub shim 提供。现有环境不受影响：升级会保留现有的 Tekton Hub 和 catalog，而不是将其移除，因此现有的 Task 和 Pipeline 引用仍可继续解析。

#已修复的问题

• 在此更新之前，当 Tekton Hub catalog 同步所用的本地 git 克隆目录中残留了 .git/index.lock 锁文件时，catalog 同步会在每个刷新周期执行 git reset --hard 时因锁文件已存在而持续失败，导致 Hub 无法刷新资源索引；此后引用 catalog 资源的流水线（如 clone-image-build-test-scan）会反复报 “fail to fetch Tekton Hub resource ... not found on hub” 而无法获取到对应资源。通过此次更新，Tekton Hub 在复用 catalog 克隆前会自动检测并清理残留的 .git 锁文件，同步可在后续每个周期自愈恢复，相关 catalog 资源重新可被正常拉取，流水线不再因该错误失败。

#已知问题

此次发版无相关问题。

#v4.6.3

#新增和优化的功能

• Subscription channel 布局与 LTS channel 策略保持一致。现在 bundle 会发布到 stable、latest 和 pipelines-4.6，其中 stable 为新的默认值。现有的、位于 latest 上的 Subscription 不受影响；如果希望固定使用之前的默认值，请显式保留 channel: latest。

#重大变更

此版本没有重大变更。

#已修复的问题

此次发版无相关问题。

#已知问题

此次发版无相关问题。

#v4.6.2

#新增和优化的功能

此更新修复了一些漏洞和安全问题，确保系统的稳定性和安全性。

#重大变更

此版本没有重大变更。

#已修复的问题

此次发版无相关问题。

#已知问题

此次发版无相关问题。

#v4.6.1

#新增和优化的功能

此更新修复了一些漏洞和安全问题，确保系统的稳定性和安全性。

#重大变更

此版本没有重大变更。

#已修复的问题

• 在此次更新之前，在启用严格 SELinux 限制的 MicroOS 环境中，依赖 Java 工具（如 Maven、SonarQube）的 Tekton 任务会因报错 “Error occurred during initialization of VM - Failed to mark memory page as executable” 而无法启动。通过本次更新，该问题已修复，MicroOS 环境中基于 Java 的 Tekton 任务现在可以正常运行。

#已知问题

此次发版无相关问题。

#v4.6.0

#新增和优化的功能

Pipeline

• 此更新使 Pipeline 执行支持手动审批功能，允许用户在 Pipeline 执行期间设置审批检查点。
• 此更新使 Pipelines 支持自定义执行输出，允许用户将 Task 执行输出自定义为 PipelineRun/TaskRun 详细信息。此外，现在还可在执行详情中查看 SonarQube/Pytest/Buildah Tasks 的内置执行信息输出。
• 此更新支持动态表单配置，允许用户以声明方式为 Pipeline 和 Task 资源配置交互式表单，无需编写前端代码即可提供用户友好的参数配置体验。
• 此更新使 Task image 地址支持动态选择，用户可以根据需要灵活选择或配置任务使用的工具 image。
• 此更新使 Cosign、Syft 和 Trivy tasks 支持同时处理多个 image。
• 此更新使 Maven Task 支持向 JDK 默认信任库追加自定义 CA 证书，而不是覆盖信任库，并提供证书路径和密钥库密码等灵活的配置参数，确保私有仓库与公共资源访问之间的兼容性。

Trigger

• 此更新支持 ScheduledTriggers，允许用户配置 Pipeline，以基于 Cron 表达式按固定时间间隔自动执行。
• 此更新支持 image trigger 功能，例如在 container image 推送到 registry 时自动触发 Pipeline 执行。
• 此更新使 EventListener 支持自动生成 WebHook listener domain，简化 Webhook 配置流程。

Pipelines as Code

• 此更新使 Pipelines-as-Code 支持与 GitLab 集成，允许用户使用 GitLab 仓库实现 pipeline-as-code。

Pipeline Integration with Connector

• 此更新使 Pipeline 和 Task 支持与 Connector 集成，以浏览和选择资源。现在，您可以集成 connector，在 Pipeline 配置期间浏览和选择外部系统中的资源，从而无需手动输入 URL 并减少配置错误。
  • 支持通过 git connector 浏览和选择 Git 仓库的 Git Revision。
  • 支持通过 gitlab connector 浏览和选择 Git Repository 和 Git Revision。
  • 支持通过 OCI connector 浏览和选择 OCI Artifact Tag。
  • 支持通过 Harbor connector 浏览和选择 OCI Repository 和 Artifact Tag。
  • 有关详细信息，请参阅 Pipeline Integration with Connector
  • 此功能依赖于 Alauda Container Platform Tenant Management Plugin
    • 对于 v4.1.x（ACP >= v4.1.3），需要 >= v4.1.15

#重大变更

此版本没有重大变更。

#已修复的问题

此次发版无相关问题。

#已知问题

• 当前版本的 tektoncd-operator 部署到 ACP 4.0.6 及更低版本，或部署到 ACP 4.1.3 及更低版本时，具有开发人员角色（命名空间下的开发者角色）的用户，预期有权限创建triggers.tekton.dev 组下的 EventListener 和 Interceptor 资源，实际上将无权限创建。可以通过临时对这两种资源单独赋权的方式绕过这个问题，或更新 ACP 平台版本解决这一问题。