第 6 章 管理 IDE 扩展

流程

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

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

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

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

      提示

      如果扩展只能从 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 实例。

3. 创建新的 Red Hat Registry Service Account 并复制用户名和令牌。

   1. 使用插件 registry 存储库 启动工作区。
   2. 打开 openvsx-sync.json 文件并添加或删除扩展。
   3. 运行 1。登录到工作区中的 registry.redhat.io 任务（Terminal Run Task…​ devfile 1。登录 registry.redhat.io，并登录到 registry.redhat.io。

   4. 运行 2。build 和 Publish a Custom Plugin Registry 任务在工作区（Terminal Run Task…​ devfile 2 中。构建和发布自定义插件 registry。

      注意

      检查 build-config.json 文件中的 CHE_CODE_VERSION，并在需要时更新它。此变量必须与当前用于 OpenShift Dev Spaces 的编辑器版本匹配。

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

      1. 使用 Linux 操作系统：

         提示
         • Podman 和 NodeJS 版本 18.20.3 或更高版本应该安装到系统中。

   6. 下载或分叉并克隆 Plugin 注册表存储库。

      git clone https://github.com/redhat-developer/che-plugin-registry.git

   7. 进入插件 registry 项目目录：

      cd che-plugin-registry/

   8. 创建新的 Red Hat Registry Service Account 并复制用户名和令牌。

   9. 登录到 registry.redhat.io ：

      podman login registry.redhat.io

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

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

       • 使用以下 JSON 语法：

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

         提示

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

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

         • 在使用资源之前，请阅读 Microsoft Visual Studio Marketplace 使用条款。

   11. 构建插件 registry 容器镜像，并将其发布到容器 registry 中，如 quay.io ：

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

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

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

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

验证

1. 检查 plugin-registry pod 是否已重启并在运行。
2. 重启工作区，并检查工作区 IDE 的 Extensions 视图中的可用扩展。