第5章 IDE 拡張機能の管理

手順

1. 選択した各拡張機能の発行元と名前を取得します。

   1. Open VSX レジストリー Web サイト で拡張機能を見つけて、拡張機能のリストページの URL と拡張機能のバージョンをコピーします。

   2. コピーした URL から <publisher> と <extension> の名前を抽出します。

      https://open-vsx.org/extension/<publisher>/<name>

      Copy to Clipboard Toggle word wrap
      ヒント

      拡張機能が Microsoft Visual Studio Marketplace からのみ入手可能で、Open VSX からは入手できない場合は、拡張機能の発行者に、これらの 手順 に従って open-vsx.org にも公開するように依頼できます。この GitHub アクション を使用する可能性があります。

      拡張機能の発行者がいない場合や、または拡張機能を open-vsx.org に公開してくれない場合、および拡張機能に相当する Open VSX がない場合は、Open VSX チームに 問題を報告する ことを検討してください。

2. カスタムプラグインレジストリーイメージをビルドし、CheCluster カスタムリソースを更新します。

   ヒント
   • ビルドプロセス中に、各拡張機能は OpenShift Dev Spaces で使用される Visual Studio Code のバージョンとの互換性が検証されます。

   1. OpenShift Dev Spaces インスタンスを使用する場合は、以下を行います。

      重要

      IBM Power (ppc64le) および IBM Z (s390x) の場合、カスタムプラグインレジストリーは、対応するアーキテクチャー上にローカルに構築する必要があります。

      1. 管理者として OpenShift Dev Spaces インスタンスにログインします。

3. 新しい Red Hat Registry Service Account を作成し、ユーザー名およびトークンをコピーします。

   1. plugin registry repository を使用してワークスペースを起動します。

   2. ターミナルを開き、OpenShift Dev Spaces のバージョンに対応する Git タグ (例: devspaces-3.15-rhel-8) をチェックアウトします。

      git checkout devspaces-$PRODUCT_VERSION-rhel-8

      Copy to Clipboard Toggle word wrap
   3. openvsx-sync.json ファイルを開き、拡張機能を追加または削除します。
   4. 1. Login to registry.redhat.io タスクを実行し (Terminal Run Task…​ devfile 1.Login to registry.redhat.io)、registry.redhat.io にログインします。
   5. 2. Build and Publish a Custom Plugin Registry タスク (Terminal Run Task…​ devfile 2.Build and Publish a Custom Plugin Registry) を実行します。

   6. 3. Configure Che to use the Custom Plugin Registry タスク (Terminal Run Task…​ devfile 3.Configure Che to use the Custom Plugin Registry) を実行します。

      1. Linux オペレーティングシステムを使用する場合:

         ヒント
         • Podman および NodeJS バージョン 18.20.3 以降がシステムにインストールされている必要があります。

   7. Dev Spaces repository をダウンロードまたはフォークし、クローンを作成します。

      git clone https://github.com/redhat-developer/devspaces.git

      Copy to Clipboard Toggle word wrap

   8. プラグインレジストリーサブモジュールに移動します。

      cd devspaces/dependencies/che-plugin-registry/

      Copy to Clipboard Toggle word wrap

   9. OpenShift Dev Spaces のバージョンに対応するタグ (例: devspaces-3.15-rhel-8) をチェックアウトします。

      git checkout devspaces-$PRODUCT_VERSION-rhel-8

      Copy to Clipboard Toggle word wrap
   10. 新しい Red Hat Registry Service Account を作成し、ユーザー名およびトークンをコピーします。

   11. registry.redhat.io にログインします。

       podman login registry.redhat.io

       Copy to Clipboard Toggle word wrap

   12. 追加または削除する必要がある拡張機能ごと に、openvsx-sync.json ファイル を編集します。

       • 拡張機能を追加するには、発行元、名前、拡張機能のバージョンを openvsx-sync.json ファイルに追加します。
       • 拡張機能を削除するには、openvsx-sync.json ファイルから発行元、名前、拡張機能のバージョンを削除します。

       • 次の JSON 構文を使用します。

             {
                 "id": "<publisher>.<name>",
                 "version": "<extension_version>"
             }

         Copy to Clipboard Toggle word wrap
         ヒント

         • クローズドソースの拡張機能または社内の内部使用のみを目的として開発された拡張機能がある場合は、カスタムプラグインレジストリーコンテナーにアクセスできる URL を使用して、.vsix ファイルから直接、拡張機能を追加できます。

               {
                   "id": "<publisher>.<name>",
                   "download": "<url_to_download_vsix_file>",
                   "version": "<extension_version>"
               }

           Copy to Clipboard Toggle word wrap
         • リソースを使用する前に、Microsoft Visual Studio Marketplace の 利用規約 をお読みください。

   13. プラグインレジストリーコンテナーイメージをビルドし、quay.io などのコンテナーレジストリーに公開します。

       1. $ ./build.sh -o <username> -r quay.io -t custom

          Copy to Clipboard Toggle word wrap

       2. $ podman push quay.io/<username/plugin_registry:custom>

          Copy to Clipboard Toggle word wrap

   14. イメージ (quay.io など) を指すように、社内のクラスター内の CheCluster カスタムリソースを編集し、変更を保存します。

       spec:
         components:
           pluginRegistry:
             deployment:
               containers:
                 - image: quay.io/<username/plugin_registry:custom>
             openVSXURL: ''

       Copy to Clipboard Toggle word wrap

検証

1. plugin-registry Pod が再始動して実行中であることを確認します。
2. ワークスペースを再起動し、ワークスペース IDE の 拡張機能 ビューで使用可能な拡張機能を確認します。