第 4 章 关于软件模板

1. 修改您要更新的软件模板。

2. 完成以下一个或多个任务：

   • 在您的模板中包括 backstage.io/template-version 注解。当模板中存在此注解时，它会自动用于注解您的目录实体和默认版本值。
   • 将 backstage.io/template-version 注解作为输入传递给操作。此方法优先于模板本身中的注解。它允许运行模板的用户指定要生成的版本。

   # ...
   - id: version-templateRef
     name: Append the version of this template to the entityRef
     action: catalog:template:version
     input:
       annotations:
         backstage.io/template-version: ${{ parameters.version }}
   # ...

   Copy to Clipboard Toggle word wrap

验证

1. 使用更新的软件模板创建目录组件。此步骤在 Backstage 中创建一个新组件，并选择性地将文件推送到外部存储库（如 GitHub、GitLab）。

2. 在 Catalog UI 中检查组件。

   1. 在 Catalog 页面中，找到新创建的目录组件。
   2. 验证实体中是否存在 backstage.io/template-version 注解。您可以使用 INSPECT ENTITY 并选择 YAML Raw 或 JSON Raw 视图来查找组件定义中的注解。

3. 只有在您发布了目录组件：请检查存储库中的组件文件。

   1. 如果您的 UI 中存在 VIEW SOURCE ：单击 VIEW SOURCE 以在存储库中打开存储的组件文件。
   2. 手动查找文件，并验证是否存在 backstage.io/template-version 注解。