Red Hat Summit動的プラグイン参照
概要
はじめに
動的プラグインのサポートは、バックエンドプラグインマネージャーパッケージに基づいています。これは、設定されたルートディレクトリー (app config 内の dynamicPlugins.rootDirectory) をスキャンして動的プラグインパッケージを探し、動的にロードするサービスです。
Red Hat Developer Hub に事前にインストールされている動的プラグインを使用することも、パブリック NPM レジストリーから外部動的プラグインをインストールすることもできます。
第1章 事前にインストール済みの動的プラグイン
Red Hat Developer Hub には、厳選された動的プラグインが事前にインストールされています。
次のプリインストールされた動的プラグインはデフォルトで有効になっています。
-
@janus-idp/backstage-plugin-analytics-provider-segment -
@janus-idp/backstage-scaffolder-backend-module-quay -
@janus-idp/backstage-scaffolder-backend-module-regex -
@backstage/plugin-techdocs-backend -
@backstage/plugin-techdocs
カスタム設定を必要とする動的プラグインは、デフォルトでは無効になっています。
アプリケーションが起動すると、デフォルトで無効になっているプラグインごとに、Developer Hub Pod のログ内の install-dynamic-plugins init container に次のようなメッセージが表示されます。
======= Skipping disabled dynamic plugin ./dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-dynamic
このプラグインを有効にするには、同じ名前のパッケージを Helm チャートに追加し、disabled フィールドの値を ‘false’ に変更します。以下に例を示します。
global:
dynamic:
includes:
- dynamic-plugins.default.yaml
plugins:
- package: ./dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github-dynamic
disabled: false
プラグインのデフォルト設定は、dynamic-plugins.default.yaml ファイルから抽出されます。ただし、pluginConfig エントリーを使用すると、デフォルト設定をオーバーライドできます。
1.1. Red Hat がサポートするプラグイン
Red Hat は次の 17 個のプラグインをサポートしています。
| 名前 | プラグイン | バージョン | パスおよび必要な変数 |
|---|---|---|---|
| Analytics Provider Segment | 1.7.3 |
| |
| Argo CD | 2.6.5 |
| |
| Argo CD | 3.0.3 |
| |
| GitHub | 0.6.5 |
| |
| GitHub Org | 0.1.17 |
| |
| Keycloak | 1.13.4 |
| |
| Kubernetes | 0.18.3 |
| |
| OCM | 4.4.5 |
| |
| OCM | 4.4.4 |
| |
| Quay | 1.11.9 |
| |
| Quay | 1.7.2 |
| |
| RBAC | 1.29.7 |
| |
| Regex | 1.7.2 |
| |
| TechDocs | 1.10.7 |
| |
| TechDocs | 1.10.9 |
| |
| Tekton | 3.12.9 |
| |
| トポロジー | 1.27.7 |
|
- KeyCloak の設定の詳細は、動的プラグインの設定 を参照してください。
- TechDocs の設定の詳細は、Red Hat Developer Hub での TechDocs プラグインの設定 を参照してください。
1.2. テクノロジープレビューのプラグイン
Red Hat Developer Hub には、お客様が設定して有効化できるテクノロジープレビューのプラグインがいくつか含まれています。これらのプラグインは、テクニカルプレビュー条件に従ってサポート範囲が定められており、機能的に完全ではない可能性があるため、Red Hat では実稼働環境での使用は推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。
Red Hat のテクノロジープレビュー機能のサポートの詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。
1.2.1. Red Hat テクノロジープレビューのプラグイン
Red Hat は、次の 7 つのプラグインに対してテクノロジープレビューサポートを提供します。
| 名前 | プラグイン | バージョン | パスおよび必要な変数 |
|---|---|---|---|
| Ansible Automation Platform (AAP) | 1.9.4 |
| |
| ACR | 1.7.16 |
| |
| Bulk Import | 1.4.11 |
| |
| JFrog Artifactory | 1.7.10 |
| |
| Nexus Repository Manager | 1.9.10 |
| |
| ServiceNow | 1.7.3 |
| |
| SonarQube | 1.7.2 |
|
- この古いプラグインに代わる、Red Hat Ansible Automation Platform (RHAAP) の新しいテクノロジープレビューのプラグインが利用可能です。詳細は、動的 プラグインリファレンスガイド の その他のインストール可能な プラグイン を参照してください。Red Hat Developer Hub の Ansible プラグインのインストール を参照してください。
1.2.2. コミュニティープラグイン
Red Hat Developer Hub (RHDH) には、お客様が有効化して設定できるコミュニティーでサポートされているプラグインがいくつか含まれています。これらのコミュニティープラグインは、動的なプラグイン対応となるように Red Hat によって拡張され、テクニカルプレビュー条件に従ってサポート範囲が定められています。
バンドルされたコミュニティーの動的プラグインに対する Red Hat のサポートの詳細は、Red Hat Developer サポートポリシー のページを参照してください。
RHDH には、次の 43 個のコミュニティープラグインが含まれています。
| 名前 | プラグイン | バージョン | パスおよび必要な変数 |
|---|---|---|---|
| 3scale | 1.8.2 |
| |
| Argo CD | 1.1.27 |
| |
| Argo CD (Red Hat) | 1.8.10 |
| |
| Azure | 0.1.14 |
| |
| Azure Devops | 0.4.4 |
| |
| Azure Devops | 0.6.5 |
| |
| Azure Repositories |
| 0.3.0 |
|
| Bitbucket Cloud | 0.2.9 |
| |
| Bitbucket Cloud | 0.1.12 |
| |
| Bitbucket Server | 0.1.36 |
| |
| Bitbucket Server |
| 0.1.12 |
|
| Bulk Import | 1.5.5 |
| |
| Datadog | 2.3.0 |
| |
| Dynatrace | 10.0.4 |
| |
| Gerrit | 0.1.14 |
| |
| GitHub | 0.4.0 |
| |
| GitHub Actions | 0.6.16 |
| |
| GitHub Insights | 2.3.31 |
| |
| GitHub Issues | 0.4.2 |
| |
| GitHub Pull Requests | 2.5.29 |
| |
| GitLab | 6.6.0 |
| |
| GitLab | 0.3.21 |
| |
| GitLab | 6.6.0 |
| |
| GitLab | 0.4.4 |
| |
| GitLab Org | 0.0.5 |
| |
| Http Request | 4.3.2 |
| |
| Jenkins | 0.9.10 |
| |
| Jenkins | 0.4.5 |
| |
| Jira | 2.5.8 |
| |
| Kubernetes | 0.11.12 |
| |
| Ldap | 0.7.0 |
| |
| Lighthouse | 0.4.20 |
| |
| Logs | 0.0.1 |
| |
| MS Graph | 0.5.30 |
| |
| PagerDuty | 0.15.0 |
| |
| PagerDuty | 0.6.1 |
| |
| Pingidentity |
| 0.1.2 |
|
| Scaffolder Relation Processor |
| 1.2.6 |
|
| Security Insights | 2.3.19 |
| |
| SonarQube | 0.7.17 |
| |
| SonarQube | 0.2.20 |
| |
| Tech Radar | 0.7.4 |
| |
| Utils | 1.17.1 |
|
第2章 その他のインストール可能なプラグイン
次のテクノロジープレビューのプラグインはプリインストールされていないため、外部ソースからインストールする必要があります。
| 名前 | プラグイン | バージョン | インストールの詳細 |
|---|---|---|---|
| Ansible Automation Platform フロントエンド | 1.0.0 | ||
| Ansible Automation Platform | 1.0.0 | ||
| Ansible Automation Platform Scaffolder バックエンド | 1.0.0 | ||
| オーケストレーターフロントエンド | 1.22.6 | ||
| オーケストレーターバックエンド | 1.22.9 |
- 上記の Red Hat Ansible Automation Platform (RHAAP) プラグインは、Red Hat Developer Hub でのプラグインの設定ガイド の テクノロジープレビューのプラグイン セクションに記載されている古いプラグインの代わりに使用できます。
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}