第 5 章 管理 IDE 扩展

流程

1. 获取每个所选扩展的发布程序和扩展名称：

   1. 在 Open VSX 注册表网站 中找到扩展，并复制扩展列表页面和扩展名版本的 URL。

   2. 从复制的 URL 中提取 & lt;publisher > 和 <extension> name：

      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. 构建自定义插件 registry 镜像并更新 CheCluster 自定义资源：

   提示
   • 在构建过程中，将验证每个扩展是否与 OpenShift Dev Spaces 中使用的 Visual Studio Code 版本兼容。

   1. 使用 OpenShift Dev Spaces 实例：

      重要

      对于 IBM Power (ppc64le)和 IBM Z (s390x)，自定义插件 registry 应该在对应的架构本地构建。

      1. 以管理员身份登录到 OpenShift Dev Spaces 实例。

1. 使用插件 registry 存储库 启动工作区。

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。登录到工作区中的 registry.redhat.io 任务（Terminal Run Task…​ devfile 1。登录 registry.redhat.io，并登录到 registry.redhat.io。
5. 执行 2。build 和 Publish a Custom Plugin Registry 任务在工作区（Terminal Run Task…​ devfile 2 中。构建和发布自定义插件 registry。

6. 执行 3。将 Che 配置为使用 Custom Plugin Registry 任务（Terminal Run Task…​ devfile 3。配置 Che 以使用自定义插件 Registry。

   1. 使用 Linux 操作系统：

      提示
      • Podman 和 NodeJS 版本 18.20.3 或更高版本应该安装到系统中。
7. 下载或分叉并克隆 Dev Spaces 存储库。

1. 进入插件 registry 子模块：

1. 签出与 OpenShift Dev Spaces 版本对应的标签（如 devspaces-3.15-rhel-8）：

   git checkout devspaces-$PRODUCT_VERSION-rhel-8

   Copy to Clipboard Toggle word wrap
2. 创建新的 Red Hat Registry Service Account 并复制用户名和令牌。

3. 登录到 registry.redhat.io ：

   podman login registry.redhat.io

   Copy to Clipboard Toggle word wrap

4. 对于需要添加或删除的每个扩展，编辑 openvsx-sync.json 文件 ：

   • 要添加扩展，请将发布程序、名称和扩展版本添加到 openvsx-sync.json 文件中。
   • 要删除扩展，请从 openvsx-sync.json 文件中删除发布者、名称和扩展版本。

   • 使用以下 JSON 语法：

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

     Copy to Clipboard Toggle word wrap
     提示

     • 如果您有一个闭源扩展，或者只为机构内部使用创建的扩展，您可以使用自定义插件 registry 容器可访问的 URL 从 .vsix 文件添加扩展：

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

       Copy to Clipboard Toggle word wrap
     • 在使用资源之前，请阅读 Microsoft Visual Studio Marketplace 使用条款。

5. 构建插件 registry 容器镜像，并将其发布到容器 registry 中，如 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

6. 编辑您机构的集群中的 CheCluster 自定义资源以指向镜像（例如在 quay.io上）并保存更改：

   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 的 Extensions 视图中的可用扩展。