rhdh-backstage-upgrade

RHDH Backstage のアップグレード

バージョン番号を管理します。チェックアウトがどの @backstage/* リリースを使用しているか、どのリリースに移行すべきか、その間に発生するすべての問題を扱います。

まずはこちら

1. 依存関係を変更する前に、package.json と backstage.json を確認してください。
2. 対象の RHDH バージョンを特定してください。ユーザーまたはリポジトリで明示された値を優先します。それ以外の場合は、チェックイン済みの互換性マトリックスを参照するため /rhdh-context を呼び出してください。利用できない場合は、推測せず、対象の RHDH と Backstage のバージョンをユーザーに確認してください。
3. バージョンを更新する前に、現在のバージョンと提案する対象バージョンを報告してください。

結果に応じたルート

結果	読み込んで従うもの
アップグレード全体を実行する	workflows/upgrade-backstage.md
現在のバージョンと不整合を確認する	references/discover-versions.md
対象リリースを選ぶ	references/determine-target.md
依存関係一式を更新する	references/bump-deps.md
名前変更または移動されたパッケージからインポートを移行する	references/migrate-packages.md
リリース間の破壊的変更に対応する	references/fix-breaking-changes.md
アップグレードを検証する	references/verify-upgrade.md

範囲

• このスキルが管理するのはバージョン番号です。プラグインのエクステンションの内容や、それらのアタッチ方法は変更しません。
• /rhdh-plugin-nfs-migration はエクステンションの形状を管理します。レガシーなフロントエンドプラグインのエクステンションを New Frontend System Blueprints に変換します。アップグレードが移行の前提条件となる場合や、移行によって古い依存関係一式が明らかになる場合に、2 つのスキルが連携します。ここではバージョンを更新し、エクステンションはそちらで変更してください。
• /backstage-api-changes は、初期アルファ版から現在の GA サーフェスまでの NFS API の差分を管理します。アップグレードによって NFS コードに問題が発生した場合は、削除された NavItemBlueprint、configSchema に変更する必要がある config.schema ブロック、名前が変更された blueprint パラメーターなどに対応するため、スキル名を指定して呼び出してください。
• /rhdh-context は RHDH と Backstage の互換性マトリックスを管理します。
• /rhdh-plugin-authoring は、アップグレードで明らかになる機械的でないソース変更を管理します。
• /rhdh-pr-create は、ステージング、コミット、プルリクエストを管理します。

スキル名を指定して呼び出し、会話の中で引き継ぎ内容を説明してください。別のスキルのファイルを開かないでください。

不変条件

• 対象の RHDH リリースに含まれる Backstage のバージョンを超えてアップグレードしないでください。解決された互換性の回答を、入手可能な最新リリースより優先します。
• チェックアウトに backstage-cli versions:bump を実行する versions:bump スクリプトがある場合はそれを使用し、ない場合は CLI を直接使用してください。続行する前に、更新後の package.json とロックファイルの差分を確認してください。
• 更新前に、すべての resolution と override を洗い出してください。パッケージマネージャーの依存関係パスを更新前後で比較し、維持、更新、削除の判断根拠と証拠を記録してください。
• 旧バージョンと新バージョンの間にあるすべてのリリースの変更履歴を読み、影響を受ける各 API をソース内で検索してください。対象範囲に破壊的変更がないと思い込まないでください。
• 現在のバージョンと対象バージョンが一致している場合は、「すでに対象バージョンです」と伝えて終了してください。
• アップグレードの完了を報告する前に、チェックアウトで定義されているビルド、テスト、lint、フォーマット、モノレポ整合性に関するすべての検証コマンドを実行してください。
• ここではステージング、コミット、プッシュ、プルリクエストの作成を行わないでください。

完了

確認したバージョン、選択した対象バージョンとその情報源、実行したコマンド、修正した破壊的変更とその対象ファイル、すべての resolution と override とその由来、更新前後の依存関係グラフの証拠と維持・更新・削除の理由、範囲形式の変更、生成されたファイル、検証結果、および不整合のまま残した依存関係とその理由を報告してください。