3.2. レジストリーイメージにプラグインバイナリーの追加

手順

1. codeready-workspaces リポジトリーのクローンを作成します。

   $ git clone https://github.com/redhat-developer/codeready-workspaces
   $ cd codeready-workspaces/dependencies/che-plugin-registry

   Copy to Clipboard Toggle word wrap

2. プラグインレジストリーで変更するバイナリーを特定します。

   meta.yaml ファイルには、プラグインに必要な拡張の URL を定義する extension セクションが含まれます。たとえば、redhat/java11/0.63.0 プラグインは以下の 2 つの拡張機能を一覧表示します。

   meta.yaml

   extensions:
     - https://download.jboss.org/jbosstools/vscode/3rdparty/vscode-java-debug/vscode-java-debug-0.26.0.vsix
     - https://download.jboss.org/jbosstools/static/jdt.ls/stable/java-0.63.0-2222.vsix

   Copy to Clipboard Toggle word wrap

   最初の拡張機能を変更して、GitHub でホストされるバージョンを参照し、プラグインレジストリーを再構築します。redhat/java11/0.63.0 プラグインを使用する場合、バイナリーはカスタムプラグインレジストリーサーバーから取得されます。これ以降のコマンドで使用できるように、以下の環境変数を設定します。

   ORG=redhat
   NAME=java11
   CHE_PLUGIN_VERSION=0.63.0
   VSCODE_JAVA_DEBUG_VERSION=0.26.0
   VSCODE_JAVA_DEBUG_URL="https://github.com/microsoft/vscode-java-debug/releases/download/0.26.0/vscjava.vscode-java-debug-0.26.0.vsix"
   OLD_JAVA_DEBUG_META_YAML_URL="https://download.jboss.org/jbosstools/vscode/3rdparty/vscode-java-debug/vscode-java-debug-0.26.0.vsix"

   Copy to Clipboard Toggle word wrap

3. プラグインレジストリー URL を取得します。

   $ oc get route plugin-registry -o jsonpath='{.spec.host}' -n ${CHE_NAMESPACE}

   Copy to Clipboard Toggle word wrap

   この値を PLUGIN_REGISTRY_URL という変数に保存します。

4. meta.yaml ファイルの URL を更新し、レジストリーコンテナーに保存される VS Code 拡張機能バイナリーを参照します。

   $ sed -i -e "s#${OLD_JAVA_DEBUG_META_YAML_URL}#${VSCODE_JAVA_DEBUG_URL}#g" \
     ./v3/plugins/${ORG}/${NAME}/${CHE_PLUGIN_VERSION}/meta.yaml
     ./v3/plugins/${ORG}/${NAME}/${CHE_PLUGIN_VERSION}/meta.yaml

   Copy to Clipboard Toggle word wrap
   重要

   デフォルトでは、CodeReady Workspaces は TLS が有効な状態でデプロイされます。TLS を使用しないインストールでは、NEW_JAVA_DEBUG_URL および NEW_JAVA_LS_URL 変数で http:// を使用します。

5. meta.yaml が正しく置き換えられた URL が設定されていることを確認します。

   $ cat ./v3/plugins/${ORG}/${NAME}/${CHE_PLUGIN_VERSION}/meta.yaml

   Copy to Clipboard Toggle word wrap

   meta.yaml

   extensions:
     - https://plugin-registry-che.apps-crc.testing/v3/plugins/redhat/java11/0.63.0/vscode-java-debug-0.26.0.vsix
     - https://plugin-registry-che.apps-crc.testing/v3/plugins/redhat/java11/0.63.0/java-0.63.0-2222.vsix

   Copy to Clipboard Toggle word wrap

6. 「カスタムレジストリーイメージのビルドおよび実行」 の手順に従ってプラグインレジストリーをビルドし、デプロイします。