管理插件

本页面介绍了如何查看、修改和删除使用 Service Extensions 创建的插件。

插件功能目前为 Media CDN 的预览版。

如需查看产品概览，请参阅 Service Extensions 概览。

查看插件

本部分介绍了如何查看使用 Service Extensions 创建的插件和插件版本。

列出插件

如需列出项目中的插件，请按以下步骤操作：

控制台

1. 在 Google Cloud 控制台中，前往服务扩展程序页面。

   前往 Service Extensions

2. 点击插件标签页。

   系统会在可排序的表格中显示插件列表，其中包含以下信息：

   • 状态：插件的状态。如果未附加服务，则值为 Not attached。如果服务附加了插件，则值为 Attached。
   • 名称：插件的名称。
   • 主版本：插件的有效版本。
   • 产品：插件所附加到的 Google Cloud 产品。
   • 类型：扩展程序的类型。
   • 范围：插件的范围。
   • 地区：插件范围为 Regional 时的地区。
   • 使用方：与插件关联的一个或多个扩展程序。
   • 上次修改时间：插件上次修改的时间。
   • 标签：添加到插件的标签。

3. 可选：如需过滤列表，请执行以下操作：

   1. 点击过滤表旁边的文本框，查看属性列表。

   2. 从列表中选择一个房源。

      属性名称（后跟英文冒号）会显示在过滤条件表标签旁边。

   3. 在英文冒号旁边插入一个空格，即可看到与该属性匹配的值列表，然后从列表中选择一个值。

   4. 可选：在属性-值对之间输入 OR 运算符，以指定组合过滤条件。

4. 可选：如需对所选插件执行其他操作，请点击 更多操作，然后选择一个选项：

   • 如需修改插件，请点击修改。
   • 如需删除插件，请点击删除。
   • 如需打开 Logs Explorer，以便检索、查看和分析有关插件的日志数据，请点击在 Logs Explorer 中查看。
   • 如需打开 Service Extensions 监控页面，请点击查看监控。

gcloud

运行 gcloud service-extensions wasm-plugins list 命令：

gcloud service-extensions wasm-plugins list \
    --location=LOCATION

将 LOCATION 替换为插件的位置，可以是 global 或某个区域。

项目中的插件会列在一个表格中，其中包含以下信息：

• 名称：插件的名称
• 说明：插件的说明
• 主要版本：插件的有效版本
• 更新时间：插件上次修改的时间

查看插件的详细信息

如需查看插件的详细信息，请使用以下方法之一：

控制台

1. 在 Google Cloud 控制台中，前往服务扩展程序页面。

   前往 Service Extensions

2. 点击插件标签页。

3. 点击要查看其详细信息的插件的名称。

   系统会打开相应插件的详细信息页面。该页面包含以下部分：

   • 基本信息：此部分显示有关插件的基本详情，包括插件所附加到的 Google Cloud 产品、负载均衡器类型、扩展程序类型、使用该插件的扩展程序、插件范围、插件的创建和修改时间戳、插件的大小、标签，以及（如果已启用日志记录）日志抽样率和最低日志记录级别。

   • 版本：此部分显示有关插件版本的详细信息，包括插件版本、创建时间戳、指定的任何说明、映像的 URI 和摘要，以及插件配置文件或映像和相关摘要。

     您可以点击图片网址以查看其详细信息。

gcloud

如需查看插件的详细信息，请运行 gcloud service-extensions wasm-plugins describe 命令：

 gcloud service-extensions wasm-plugins describe WASM_PLUGIN \
     --location=LOCATION

替换以下内容：

• WASM_PLUGIN：插件的名称
• LOCATION：插件的位置，可以是 global 或区域

系统会显示有关该插件的以下详细信息：

• 插件名称
• 插件的创建和修改时间戳
• 标签
• 日志采样率（如果已启用日志记录）

如需列出插件的版本，请使用 gcloud service-extensions wasm-plugin-versions list 命令：

 gcloud service-extensions wasm-plugin-versions list WASM_PLUGIN \
     --location=LOCATION

替换以下内容：

• WASM_PLUGIN：插件的名称
• LOCATION：插件的位置，可以是 global 或区域

指定插件的版本会列在一个以插件名称命名的表格中。

如需查看插件版本的详细信息，请使用 gcloud service-extensions wasm-plugin-versions describe 命令：

 gcloud service-extensions wasm-plugin-versions describe WASM_PLUGIN_VERSION \
     --location=LOCATION

替换以下内容：

• WASM_PLUGIN_VERSION：插件的主要版本
• LOCATION：插件的位置，可以是 global 或区域

系统会显示有关插件版本的以下详细信息：

• 版本名称
• 创建时间戳
• 说明（如果已输入）
• 映像的 URI 和摘要
• 插件配置文件或映像以及相关摘要

修改插件

本部分介绍了如何修改使用 Service Extensions 创建的插件。

修改插件

如需修改插件，请按以下步骤操作：

控制台

1. 在 Google Cloud 控制台中，前往服务扩展程序页面。

   前往 Service Extensions

2. 点击插件标签页。

3. 对于要修改的插件，请点击更多操作，然后选择修改。

   或者，点击插件名称，然后在详情页面上点击 修改。

   在修改插件页面上，插件的名称无法修改。您可以修改其他详细信息。

4. 根据需要进行更改。

   如需了解大多数字段，请参阅创建插件。

   如需了解版本部分，请参阅添加插件的新版本。

5. 点击更新插件。

gcloud

运行 gcloud service-extensions wasm-plugins update 命令：

gcloud service-extensions wasm-plugins update WASM_PLUGIN \
   --location=LOCATION \
   --description=PLUGIN_DESCRIPTION \
   --labels=[LABELS,...]

替换以下内容：

• WASM_PLUGIN：插件的名称
• LOCATION：插件的位置，可以是 global 或区域
• PLUGIN_DESCRIPTION：插件的说明
• LABELS：以逗号分隔的键值对形式的标签

添加新版插件

您可以创建新版本的插件代码，然后将其添加为新版本的插件。

如需添加插件的新版本，请按以下步骤操作：

控制台

1. 在 Google Cloud 控制台中，前往服务扩展程序页面。

   前往 Service Extensions

2. 点击插件标签页。

3. 点击修改。

4. 在版本部分中，点击添加版本。

5. 在添加版本窗格中，指定插件版本的详细信息。

6. 可选：选中设为主要复选框。

   您也可以稍后将此版本设置为主要版本。

7. 点击 Add（添加）。

8. 点击更新插件。

gcloud

运行 gcloud service-extensions wasm-plugins update 命令：

 gcloud service-extensions wasm-plugins update WASM_PLUGIN \
     --location=LOCATION \
     --image=IMAGE \
     --main-version=MAIN_VERSION \
     --plugin-config=PLUGIN_CONFIG | --plugin-config-file=PLUGIN_CONFIG_FILE | --plugin-config-uri=PLUGIN_CONFIG_URI

替换以下内容：

• WASM_PLUGIN：插件的 ID 或完全限定名称
• LOCATION：插件的位置，可以是 global 或区域
• IMAGE：存储在 Artifact Registry 制品库中的新 Wasm 模块的 URI
• MAIN_VERSION：要创建并设置为主要（或服务）版本的插件版本的 ID。
• PLUGIN_CONFIG、PLUGIN_CONFIG_FILE 或 PLUGIN_CONFIG_URI：可选的配置文件，可以分别以内嵌文本、本地文件或 Artifact Registry 中的映像形式指定。

注意： 如需创建新的插件版本，但不将其设置为主要版本，请使用 gcloud service-extensions wasm-plugins create 命令。

更改插件的主要版本

如需更改插件的主要版本，请按以下步骤操作：

控制台

1. 在 Google Cloud 控制台中，前往服务扩展程序页面。

   前往 Service Extensions

2. 点击插件标签页。

3. 点击修改按钮。

4. 在版本部分中，选择一个处于非活动状态的版本，然后点击设为主要版本。

   或者，您也可以在创建插件的新版本时，选择将该版本设为主要版本。

5. 点击更新插件。

gcloud

运行 gcloud service-extensions wasm-plugins update 命令：

 gcloud service-extensions wasm-plugins update \
     --location=LOCATION \
     --main-version=WASM_PLUGIN_VERSION

替换以下内容：

• LOCATION：插件的位置，可以是 global 或区域
• WASM_PLUGIN_VERSION：插件主要版本的名称

新插件版本可能需要几分钟才能分发到所有位置。由于插件并非同时交付到所有地区，因此分钟数可能会因地区而异。

注意： 如需回滚插件，请将之前的版本设置为主版本。

删除插件

本部分介绍如何删除使用 Service Extensions 创建的插件和插件版本。

删除插件

如需删除插件，请按照以下步骤操作：

控制台

1. 前往 Service Extensions 页面。

   前往 Service Extensions

2. 点击插件标签页。

3. 对于要删除的插件，请点击更多操作按钮，然后选择删除。

   或者，点击插件名称，然后点击详情页面上的删除按钮。

   无法删除扩展程序正在使用的插件。如需删除此类插件，请先修改扩展程序以移除该插件，或删除该扩展程序。

4. 在确认消息框中，点击删除以确认操作。

gcloud

1. 从服务配置中移除对该插件的引用，然后重新导入配置 YAML 文件。

   如需了解详情，请参阅如何配置 Cloud Load Balancing 路由和流量插件以及 Media CDN 插件。

2. 运行 gcloud service-extensions wasm-plugins delete 命令：

   gcloud service-extensions wasm-plugins delete WASM_PLUGIN \
       --location=LOCATION
   

   替换以下内容：

   • WASM_PLUGIN：插件的名称
   • LOCATION：插件的位置，可以是 global 或区域

删除插件也会删除相关的插件资源。

删除插件的某个版本

如需删除插件的某个版本，请按照以下步骤操作：

控制台

1. 在 Google Cloud 控制台中，前往服务扩展程序页面。

   前往 Service Extensions

2. 点击插件标签页。

3. 选择要修改的插件，然后切换到修改模式。

4. 在版本部分，选中要删除的版本对应的复选框，然后点击删除。

5. 点击更新插件。

gcloud

运行 gcloud service-extensions wasm-plugin-versions delete 命令：

 gcloud service-extensions wasm-plugin-versions delete WASM_PLUGIN_VERSION \
     --location=LOCATION

替换以下内容：

• WASM_PLUGIN_VERSION：未用作主要版本的插件版本的名称
• LOCATION：插件的位置，可以是 global 或区域

如果某个版本被设置为主版本（即主要 [有效] 版本），您只能在将另一个版本设置为主版本后才能将其删除。

后续步骤

• 了解如何创建插件。
• 请参阅 Service Extensions 概览。