2.2. サードパーティーのプラグインを動的プラグインとしてパッケージ化して公開する

手順

1. プラグインのルートディレクトリー (dist-dynamic ディレクトリーではありません) に移動します。

2. プラグインを OCI イメージにパッケージ化するには、次のコマンドを実行します。

   エクスポートされたサードパーティープラグインをパッケージ化するコマンドの例

   npx @janus-idp/cli@latest package package-dynamic-plugins --tag quay.io/example/image:v0.0.1

   前のコマンドでは、--tag 引数でイメージ名とタグを指定します。

3. 次のいずれかのコマンドを実行して、イメージをレジストリーにプッシュします。

   podman を使用してイメージをレジストリーにプッシュするコマンドの例

   podman push quay.io/example/image:v0.0.1

   docker を使用してイメージをレジストリーにプッシュするコマンドの例

   docker push quay.io/example/image:v0.0.1

   package-dynamic-plugins コマンドの出力には、dynamic-plugin-config.yaml ファイルで使用するプラグインのパスが提供されます。

手順

1. dist-dynamic ディレクトリーに移動します。

2. tgz アーカイブを作成するには、次のコマンドを実行します。

   tgz アーカイブを作成するコマンドの例

   npm pack

   次のように --json フラグを使用して、npm pack コマンドの出力から整合性ハッシュを取得できます。

   tgz アーカイブの整合性ハッシュを取得するコマンドの例

   npm pack --json | head -n 10

3. RHDH インスタンスにアクセスできる Web サーバー上でアーカイブをホストし、次のように dynamic-plugin-config.yaml ファイルでその URL を参照します。

   dynamic-plugin-config.yaml ファイルの例

   plugins:
     - package: https://example.com/backstage-plugin-myplugin-1.0.0.tgz
       integrity: sha512-<hash>

4. プラグインをパッケージ化するには、次のコマンドを実行します。

   動的プラグインをパッケージ化するコマンドの例

   npm pack --pack-destination ~/test/dynamic-plugins-root/

   ヒント

   OpenShift Container Platform で HTTP サーバーを使用してプラグインレジストリーを作成するには、次のコマンドを実行します。

   OpenShift Container Platform で HTTP サーバーを構築およびデプロイするためのコマンド例

   oc project my-rhdh-project
   oc new-build httpd --name=plugin-registry --binary
   oc start-build plugin-registry --from-dir=dynamic-plugins-root --wait
   oc new-app --image-stream=plugin-registry

5. dynamic-plugin-config.yaml ファイルを編集して、HTTP サーバーからのプラグインを使用するように RHDH を設定します。

   RHDH でパッケージ化されたプラグインを使用するための設定例

   plugins:
     - package: http://plugin-registry:8080/backstage-plugin-myplugin-1.9.6.tgz

手順

1. dist-dynamic ディレクトリーに移動します。

2. 次のコマンドを実行して、パッケージをプライベート NPM レジストリーに公開します。

   プラグインパッケージを NPM レジストリーに公開するコマンドの例

   npm publish --registry <npm_registry_url>

   ヒント

   export コマンドを実行する前に、package.json ファイルに次の内容を追加できます。

   package.json ファイルの例

   {
     "publishConfig": {
       "registry": "<npm_registry_url>"
     }
   }

   動的プラグインをエクスポートした後に publishConfig を変更する場合は、export-dynamic-plugin コマンドを再実行して、正しい設定が含まれていることを確認します。