第4章 Software Template について

1. 更新する必要がある Software Template を変更します。

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. 更新した Software Template を使用してカタログコンポーネントを作成します。このステップでは、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 アノテーションが存在することを確認します。