4.3. 跟踪组件源和软件模板版本

流程

1. 找到您要添加证明信息的 Software Template 对象 YAML 文件，并添加使用 catalog:scaffolded-from 操作的步骤。此操作会将生成的目录实体链接回源模板。

2. 可选： 要跟踪模板版本（例如 v1.0 与 v1.5），请在 steps 部分包含 catalog:template:version 操作。以下代码块是在 steps 部分添加 versioning 操作的示例：

   steps:
     - id: create-provenance-annotation
       name: Append the entityRef of this template to the entityRef
       action: catalog:scaffolded-from
     - id: create-version-annotation
       name: Create Template Version Annotation
       action: catalog:template:version
       input:
         templateVersion: ${{ parameters.version }}
     - ... other steps ...

   Copy to Clipboard Toggle word wrap

   其中：

   steps:input:templateVersion

   读取 version 参数

   注意

   catalog:template:version 操作读取模板中定义的 version 参数，并将其作为注解应用到生成的目录实体。

3. 在 Red Hat Developer Hub app-config.yaml 文件中，将 catalog.locations 部分配置为指向要添加的软件模板。您可能需要将 Template 添加到全局 catalog.rules.allow 列表中，或者在允许软件模板 estion 的位置添加一个粒度规则，如下例所示：

   # ...
   catalog:
     locations:
       - type: url
         target: https://<repository_url>/example-template.yaml
         rules:
           - allow: [Template]
   # ...

   Copy to Clipboard Toggle word wrap

   其中：

   catalog.locations.type

   如果您要从存储库（如 GitHub 或 GitLab）导入模板，请输入 url 类型。

   catalog.locations.target

   输入模板的 URL。

   catalog.locations.rules.allow

   输入 Template 规则，以允许将新软件模板添加到目录中。

1. 在 Red Hat Developer Hub 导航菜单中，进入 Catalog 并找到新创建的目录组件。
2. 要查看将实体链接到模板的底层数据，请选择 INSPECT ENTITY 选项。

3. 要验证验证注解，请完成以下步骤：

   1. 选择 YAML Raw 或 JSON Raw 视图，并验证 scaffoldedFrom 链接的数据项是否存在。

   2. 可选：如果包含 versioning，请验证 backstage.io/template-version 注解是否存在。

      注意

      如果将目录组件发布到外部存储库（如 Git），则该存储库中的组件文件也必须包含 backstage.io/template-version 注解。

1. 在 Red Hat Developer Hub 导航菜单中，单击 Catalog，使用过滤器来查找并选择要检查的 Software Template。
2. 在 Software Template 详情页面中，点 Dependencies 选项卡。此视图列出了所有引用此模板的目录实体，如组件、资源和系统，包括配置时的任何版本信息。