配置 Tekton 集成

功能概览

artifacthub-shim 通过与 Artifact Hub 兼容的 API 提供 Tekton catalog 资源。Tekton hub resolver 和 Pipelines as Code 应使用 集群内的 shim Service,而不是公共的 artifacthub.io 或 api.hub.tekton.dev。

Artifact Hub Shim v1.0.0 当前可与已发布的 Alauda Container Platform Pipelines v4.14.0 开箱即用。4.10、 4.6 和 4.0 系列的最低版本分别为 v4.10.2、v4.6.4 和 v4.0.17,需在相关补丁发布后使用。使用 Alauda Container Platform Pipelines 4.14 的标准安装采用以下默认值:

设置值
Shim 命名空间artifacthub-shim-system
Shim Serviceartifacthub-shim-api
Resolver Artifact Hub APIhttp://artifacthub-shim-api.artifacthub-shim-system.svc.cluster.local/
PAC Hub URLhttp://artifacthub-shim-api.artifacthub-shim-system.svc.cluster.local
Task catalogcatalog
Pipeline catalogcatalog-pipelines

Tekton Hub Resolver

当插件使用标准命名空间和发布名称时,Alauda Container Platform Pipelines 4.14 会在组件安装期间设置 resolver 默认值。在 4.10、4.6 和 4.0 系列的最低 tektoncd-operator 补丁版本发布后,相同的 Service URL 仍适用。对于自定义安装,请将此配置合并到 TektonConfig.spec.pipeline:

enable-hub-resolver: true
hub-resolver-config:
  artifact-hub-api: http://artifacthub-shim-api.artifacthub-shim-system.svc.cluster.local/
  default-artifact-hub-task-catalog: catalog
  default-artifact-hub-pipeline-catalog: catalog-pipelines
  default-kind: task
  default-tekton-hub-catalog: catalog
  default-type: artifact

即使 default-type 为 artifact,也必须保留 default-tekton-hub-catalog;当前的 resolver 版本在准备默认值时仍会读取它。

如果将 artifacthub-shim 安装到其他命名空间,请将 artifact-hub-api 中的 artifacthub-shim-system 替换为安装命名空间。 如果 Helm release 名称发生变化且 Service 名称被覆盖,也请更新 Service 主机。

Pipelines as Code

PAC remote annotations 使用 PAC 设置,而不是 TektonConfig resolver 设置。 对于自定义安装,请在 OpenShiftPipelinesAsCode 资源或协调后的 PAC 配置源上设置以下 PAC 设置:

hub-url: http://artifacthub-shim-api.artifacthub-shim-system.svc.cluster.local
hub-catalog-type: artifacthub
hub-catalog-name: catalog

请勿将 /api/v1 追加到 hub-url;PAC 会为 Artifact Hub provider 添加该内容。 保留 hub-catalog-type: artifacthub,以便 PAC 不会探测 /api/v1/stats 并回退到 Tekton Hub 行为。

PAC 只有一个默认的 hub-catalog-name。因此,它会请求 shim 从 catalog 获取远程 Pipeline 注解;对于 Pipeline 详细信息查询,shim 会回退到 catalog-pipelines。新的显式 hub resolver 引用仍应将 catalog-pipelines 用于 Pipelines。

DevOps Hub UI

DevOps UI 保留稳定的 /hub 网关路径。该 chart 会呈现专用的 hubIngress,将 /hub(/|$)(.*) 重写为规范的 shim API。 shim API 本身不会注册 /hub/** handler。

商标和归属声明

Tekton™ 是 The Linux Foundation 的商标。

Red Hat® 和 OpenShift® 是 Red Hat, Inc. 在美国和其他国家/地区的注册商标。

Alauda 是独立供应商。本产品与 The Linux Foundation 或 Red Hat, Inc. 没有任何关联,也未获得其认可或赞助。所有商标均归其各自所有者所有,此处使用商标仅为识别目的。