Red Hat Developer Hub リリースノート

この更新により、Keycloak バックエンドプラグインは、fetch 操作を監視し、潜在的な問題を診断する OpenTelemetry メトリクスをサポートするようになりました。

使用可能なカウンターには次のものが含まれます。

これらのカウンターには taskInstanceId ラベルが含まれており、スケジュールされた各 fetch タスクを一意に識別し、失敗を個々のタスク実行までさかのぼって追跡できます。

設定例:

backend_keycloak_fetch_data_batch_failure_count_total{taskInstanceId="df040f82-2e80-44bd-83b0-06a984ca05ba"} 1

backend_keycloak_fetch_data_batch_failure_count_total{taskInstanceId="df040f82-2e80-44bd-83b0-06a984ca05ba"} 1

Prometheus などの OpenTelemetry 互換のバックエンドを使用してメトリクスをエクスポートできます。

この更新により、サポートされている認証プロバイダーに、新しい設定可能なフィールド sessionDuration が導入されました。これにより、管理者はカスタムのユーザーセッション期間を指定できるようになり、セッションタイムアウトと強制ログアウトをより適切に制御できるようになります。さらに、最新の Web ブラウザーポリシーに合わせて、リフレッシュトークン Cookie のデフォルトの最大有効期間が 400 日に短縮されました。

詳細は、Red Hat Developer Hub での認証 を参照してください。

Red Hat Developer Hub では、Settings ページでバージョン情報の拡張または置換がサポートされるようになりました。この機能により、お客様とパートナーは Settings ページのバージョン情報を独自のバージョンに置き換えることができます。

Red Hat Developer Hub 1.6 では、RBAC および Bulk Import プラグインの機能拡張が導入され、ユーザーは Backstage の新しい Auditor Service を利用できるようになりました。主な機能は次のとおりです。

監査ログの形式は、新しい Auditor Service 規則に合わせて更新されました。Audit フィールドとイベント識別子が更新されました。古い形式に基づいてクエリーをフィルタリングすると、期待どおりに機能しなくなる可能性があります。

監査ログは、@backstage/backend-plugin-api パッケージによってサポートされるようになりました。

Bulk Import バックエンドプラグインと RBAC バックエンドプラグインは、さまざまな操作の監査イベントを出力し、イベントは eventId によって論理的にグループ化されます。

Backstage scaffolder を通じて提供されるセルフサービス機能との整合性を向上させ、ユーザーにとってわかりやすくするために、主要な UI 領域全体で Create という用語の名前が Self-service に変更されました。

この変更は、以下のエリアに適用されます。

この更新により、Extensions カタログには、含まれるプラグインのデフォルト設定が Red Hat Developer Hub に直接表示されるようになりました。この機能により、管理者は利用可能なプラグインとその設定オプションを有効化する前に、それらをよりよく理解できるようになります。プラグインの設定は表示されるようになりましたが、管理者はプラグインをインストールまたは設定するために、これらの設定を Helm チャートまたは Operator カスタムリソースに手動でコピーする必要があります。

以前は、Operator を使用して Developer Hub をデプロイするには、カスタム app-config ConfigMap で baseUrl 設定を手動で設定する必要がありました。

この更新により、Operator は OpenShift クラスター Ingress ドメインと Backstage カスタムリソースのカスタムルート設定に基づいて、デフォルトのアプリケーション URL を自動的に計算できるようになりました。次に、Developer Hub インスタンス用に生成される app-config ConfigMap に、これをデフォルトの baseUrl として入力します。この機能は OpenShift に固有のものです。Operator は、デフォルトの app-config ConfigMap の app.baseUrl、backend.baseUrl、および backend.cors.origin フィールドに入力します。その結果、OpenShift 上のほとんどの Operator ベースのデプロイメントでこのような値を手動で設定する必要がなくなりますが、カスタム app-config ConfigMap でこれらの設定をオーバーライドすることは引き続き可能です。

Red Hat Developer Hub では、サイドバーメニュー設定で新しい有効キーを使用して、サイドバー項目を非表示にする明確かつ柔軟な方法をサポートするようになりました。false に設定すると、指定されたサイドバー項目は UI に表示されなくなりますが、既存の設定との完全な下位互換性は維持されます。

設定例:

dynamicPlugins:
  frontend:
    default.main-menu-items:
      menuItems:
        default.home:
          title: Home
          icon: home
          enabled: false
        default.list:
          title: References
          icon: bookmarks
        default.my-group:
          parent: default.list
        default.learning-path:
          parent: default.list
          title: ''
        default.homepage:
          title: HomePage 123
          icon: home
          enabled: false
        default.create:
          title: Create
          icon: add
          parent: default.homepage

dynamicPlugins:
  frontend:
    default.main-menu-items:
      menuItems:
        default.home:
          title: Home
          icon: home
          enabled: false
        default.list:
          title: References
          icon: bookmarks
        default.my-group:
          parent: default.list
        default.learning-path:
          parent: default.list
          title: ''
        default.homepage:
          title: HomePage 123
          icon: home
          enabled: false
        default.create:
          title: Create
          icon: add
          parent: default.homepage

次のように、ロゴ、検索、設定、管理などのコアサイドバー要素の表示を切り替えることも可能になりました。

app:
  sidebar:
    search: false           # hides sidebar search
    logo: false             # hides sidebar logo
    settings: false         # hides settings item
    administration: false   # hides administration item

app:
  sidebar:
    search: false           # hides sidebar search
    logo: false             # hides sidebar logo
    settings: false         # hides settings item
    administration: false   # hides administration item

Developer Hub コミュニティープラグインが Backstage バージョン 1.36 に更新されました。

Red Hat Developer Hub では、管理者がロールに所有権を割り当て、RBAC プラグインへのアクセスを制御できる新しい RBAC 条件ルール IS_OWNER が導入されました。この機能拡張により、ロール、パーミッションポリシー、条件付きポリシーを所有者ベースでフィルタリングできるようになり、より細かなアクセス制御が可能になります。

この機能拡張により、policy.entity.create パーミッションからリソースタイプが削除され、条件付きルールがパーミッションに適用されなくなります。将来的なパフォーマンスの低下を防ぐために、リソースタイプ policy-entity とアクション create を使用しているすべてのパーミッションを更新できます (例: role:default/some_role, policy-entity, create, allow を role:default/some_role, policy.entity.create, create, allow に更新)。

Red Hat Developer Hub は、Microsoft Azure Kubernetes Service (AKS) の高可用性セットアップをサポートするようになりました。この機能拡張により、デプロイメントでレプリカを 1 つ以上にスケーリングできるようになりました。これにより、障害や中断が発生した場合でも、アプリケーションの稼働を維持し、アクセス可能な状態を確保できます。

詳細は、Red Hat Developer Hub での高可用性の設定 を参照してください。

Red Hat Developer Hub は @backstage/plugin-scaffolder-backend-module-github プラグインをサポートするようになりました。これにより、ソフトウェアテンプレート内で GitHub Actions を使用できるようになりました。この統合により、リポジトリーのセキュアな作成と管理、プルリクエストの作成、GitHub Actions ワークフローのトリガーなどを、すべてソフトウェアテンプレートから直接実行できます。このプラグインを使用すると、ユーザーは GitHub のやり取りとワークフローを簡単に自動化できるようになります。

この更新により、セキュリティーを強化するために、OIDC サインインのデフォルトのリゾルバーが oidcSubClaimMatchingKeycloakUserId に設定されました。このリゾルバーは、サインインリゾルバー設定で、設定可能なオプションとしても利用できるようになりました。

この更新により、Developer Hub に @backstage-community/plugin-scaffolder-backend-module-kubernetes プラグインが動的プラグインとして導入され、Kubernetes の Backstage テンプレートアクションが有効になります。現在、create-namespace アクションが含まれています。この動的プラグインはデフォルトでは無効になっています。

詳細は、Red Hat Developer Hub の Kubernetes カスタムアクション を参照してください。

以前は、Topology プラグインはアクセスを制御するために topology.view.read パーミッションを使用していました。ユーザーは、RBAC UI を使用してトポロジーパーミッションを設定できませんでした。この更新により、ユーザーは RBAC UI を使用して Kubernetes プラグインのパーミッションを設定できるようになりました。この RBAC UI は、Topology プラグインへのアクセスも管理します。Topology 固有のパーミッション topology.view.read が削除されたため、Topology プラグインに Kubernetes プラグインパーミッション kubernetes.clusters.read、kubernetes.resources.read、および kubernetes.proxy を使用できるようになりました。

CSV パーミッションファイルを使用している場合は、以下の行を更新します。

p, role:default/topology-viewer, topology.view.read, read, allow
p, role:default/topology-viewer, kubernetes.proxy, use, allow

p, role:default/topology-viewer, topology.view.read, read, allow
p, role:default/topology-viewer, kubernetes.proxy, use, allow

p, role:default/topology-viewer, kubernetes.clusters.read, read, allow
p, role:default/topology-viewer, kubernetes.resources.read, read, allow
p, role:default/topology-viewer, kubernetes.proxy, use, allow

p, role:default/topology-viewer, kubernetes.clusters.read, read, allow
p, role:default/topology-viewer, kubernetes.resources.read, read, allow
p, role:default/topology-viewer, kubernetes.proxy, use, allow

監査フィールド、イベント名、ID などの Auditor 形式は、アップストリームの Backstage Auditor Service によって定義された新しい Auditor Service 規則に合わせて更新されました。古い形式に基づいてクエリーをフィルタリングすると、期待どおりに機能しない可能性があります。

Red Hat Developer Hub 1.6 では、カスタム監査ロギングシステムに代わる Backstage Audit Log Service が導入されています。これは、監査イベントの生成および使用方法に対する重要な構造的および動作的変更です。

この移行によって導入された主な変更点は次のとおりです。

以前は、Tekton プラグインはアクセスを制御するために tekton.view.read パーミッションを使用していました。ユーザーは RBAC UI を使用して Tekton パーミッションを設定できませんでした。この更新により、ユーザーは RBAC UI を使用して Kubernetes プラグインのパーミッションを設定できるようになり、Tekton プラグインへのアクセスを制御できるようになりました。Tekton 固有のパーミッション tekton.view.read が削除されたため、Kubernetes プラグインパーミッション kubernetes.clusters.read、kubernetes.resources.read、および kubernetes.proxy を Tekton プラグインに使用できるようになりました。

CSV パーミッションファイルを使用している場合は、以下の行を更新します。

p, role:default/tekton-viewer, tekton.view.read, read, allow
p, role:default/tekton-viewer, kubernetes.proxy, use, allow

p, role:default/tekton-viewer, tekton.view.read, read, allow
p, role:default/tekton-viewer, kubernetes.proxy, use, allow

p, role:default/tekton-viewer, kubernetes.clusters.read, read, allow
p, role:default/tekton-viewer, kubernetes.resources.read, read, allow
p, role:default/tekton-viewer, kubernetes.proxy, use, allow

p, role:default/tekton-viewer, kubernetes.clusters.read, read, allow
p, role:default/tekton-viewer, kubernetes.resources.read, read, allow
p, role:default/tekton-viewer, kubernetes.proxy, use, allow

import(…​) による動的インポートの使用は非推奨となり、サポートされなくなりました。Backstage CLI は、Node.js コードでネイティブ ESM をサポートし、ESM 専用パッケージのインポートにアクセスできるようにします。したがって、ESM または CommonJS パッケージを使用する場合は、require(…​) を import(…​) のタイプとして使用する必要があります。

Red Hat Developer Hub Local (RHDH Local) が開発者プレビュー機能として利用可能になりました。RHDH の軽量で自己完結型バージョンが提供され、開発者やプラットフォームエンジニアは、Kubernetes クラスターに Developer Hub をインストールしなくても、テンプレートでの作業、プラグインの試用、ソフトウェアカタログの検証、その他のタスクを実行できます。

RHDH Local のインストールの詳細は、Github の Red Hat Developer Hub Local を参照してください。