#历史 Pipeline Catalog 引用

#问题描述

较旧的 PipelineRun 定义可能会在 Pipelines 中使用 resolver: hub 和 catalog: catalog。artifacthub-shim 提供的内置 Pipeline repository 是 catalog-pipelines，而 catalog 是内置 Task repository。

#当前兼容性

artifacthub-shim 为 Pipeline 查找提供了一个内置的 catalog 别名：

• pipeline/catalog/<name>/<version> 会回退到 pipeline/catalog-pipelines/<name>/<version>。
• 不显式指定版本的 latest-version 详情查找也会返回解析后的 Pipeline manifest。
• UI 详情、UI 批量、Artifact Hub 详情以及旧版 raw YAML 路径共享相同的回退机制。

别名使用会以 warning 级别记录为 catalog alias lookup used，并由 artifacthub_shim_catalog_alias_lookup_total 计数。历史 Pipeline 别名还会递增兼容性指标 artifacthub_shim_pipeline_catalog_fallback_total。

#推荐修复

对于新的或已编辑的 Pipeline 引用，请使用规范的 Pipeline catalog：

pipelineRef:
  resolver: hub
  params:
    - name: type
      value: artifact
    - name: catalog
      value: catalog-pipelines
    - name: kind
      value: pipeline
    - name: name
      value: java-image-build-scan-deploy
    - name: version
      value: "0.1"

如果 TektonConfig 中已设置 resolver 默认值，也可以在 Pipeline 引用中省略 catalog 参数，并使用已配置的默认值。

#相关内容

• 配置 Tekton 集成
• Hub Resolver 无法解析资源