管理外掛程式

本頁面說明如何查看、編輯及刪除使用 Service Extensions 建立的外掛程式。

Media CDN 的外掛程式功能目前為預先發布版。

如需產品總覽，請參閱「Service Extensions 總覽」。

查看外掛程式

本節說明如何查看使用 Service Extensions 建立的外掛程式和外掛程式版本。

列出外掛程式

如要列出專案中的外掛程式，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Service Extensions」頁面。

    前往 Service Extensions

  2. 按一下「外掛程式」分頁標籤。

    外掛程式清單會顯示在可排序的表格中，並提供下列資訊：

    • 狀態：外掛程式的狀態。如果未附加服務，值會是 Not attached。如果服務已附加外掛程式，則值為 Attached。
    • Name：外掛程式名稱。
    • 主要版本：外掛程式的有效版本。
    • 產品：外掛程式附加的 Google Cloud 產品。
    • Type：擴充功能類型。
    • Scope：外掛程式的範圍。
    • 區域：外掛程式範圍為 Regional 時的區域。
    • 使用中：與外掛程式相關聯的一或多個擴充功能。
    • 上次修改時間：外掛程式上次修改的時間。
    • 標籤：新增至外掛程式的標籤。

  3. 選用：如要篩選清單，請按照下列步驟操作：

    1. 按一下「篩選表格」旁的箭頭，即可查看屬性清單。

    2. 從清單中選取資源。

      屬性名稱後方會加上冒號，並顯示在「Filter table」(篩選表格) 標籤旁。

    3. 在冒號旁插入空格，即可查看與屬性相符的值清單，然後從清單中選取值。

    4. 選用：在屬性/值組合之間輸入 OR 運算子，指定組合篩選器。

  4. 選用：如要對所選外掛程式執行其他操作，請按一下 「More actions」(更多動作)，然後選取下列任一選項：

    • 如要編輯外掛程式，請按一下「Edit」(編輯)。
    • 如要刪除外掛程式，請按一下「Delete」(刪除)。
    • 如要開啟記錄檔探索工具，以便擷取、查看及分析外掛程式的記錄檔資料，請按一下「View in Logs Explorer」(在記錄檔探索工具中查看)。
    • 如要開啟「Service Extensions Monitoring」(Service Extensions 監控) 頁面，請按一下「View Monitoring」(查看監控)。

gcloud

執行 gcloud service-extensions wasm-plugins list 指令：

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

將 LOCATION 替換為外掛程式的位置，可以是 global 或區域。

專案中的外掛程式會列在表格中，並提供下列資訊：

  • Name：外掛程式名稱
  • Description：外掛程式的說明
  • 主要版本：外掛程式的有效版本
  • 更新時間：外掛程式上次修改的時間

查看外掛程式詳細資料

如要查看外掛程式的詳細資料，請使用下列其中一種方法：

控制台

  1. 前往 Google Cloud 控制台的「Service Extensions」頁面。

    前往 Service Extensions

  2. 按一下「外掛程式」分頁標籤。

  3. 按一下要查看詳細資料的外掛程式名稱。

    外掛程式的「Details」(詳細資料) 頁面隨即開啟。這個頁面包含下列部分：

    • 基本資訊：這個部分會顯示外掛程式的基本詳細資料，包括外掛程式附加的 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」頁面。

    前往 Service Extensions

  2. 按一下「外掛程式」分頁標籤。

  3. 找到要編輯的外掛程式，按一下 「More actions」(更多動作)，然後選取「Edit」(編輯)。

    或者，按一下外掛程式名稱，然後在「Details」(詳細資料) 頁面中，按一下 「Edit」(編輯)。

    在「Edit plugin」(編輯外掛程式) 頁面中，外掛程式名稱無法編輯。您可以編輯其他詳細資料。

  4. 視需要進行變更。

    如要瞭解大部分欄位，請參閱「建立外掛程式」。

    如要瞭解「Versions」部分，請參閱「新增外掛程式版本」。

  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」頁面。

    前往 Service Extensions

  2. 按一下「外掛程式」分頁標籤。

  3. 點選「Edit」(編輯)。

  4. 在「版本」部分，按一下「新增版本」。

  5. 在「Add version」(新增版本) 窗格中，指定外掛程式版本的詳細資料。

  6. 選用：勾選「設為主要」核取方塊。

    您也可以稍後將這個版本設為主要版本。

  7. 按一下「新增」。

  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 中的映像檔。

變更外掛程式的主要版本

如要變更外掛程式的主要版本，請按照下列步驟操作：

控制台

  1. 前往 Google Cloud 控制台的「Service Extensions」頁面。

    前往 Service Extensions

  2. 按一下「外掛程式」分頁標籤。

  3. 按一下 [Edit] (編輯) 按鈕。

  4. 在「Versions」(版本) 區段中，選取未啟用的版本，然後按一下「Set as main」(設為主要版本)。

    或者，您也可以在建立新版外掛程式時，選擇將該版本設為主要版本。

  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. 找到要刪除的外掛程式，按一下 「More actions」(更多動作) 按鈕，然後選取「Delete」(刪除)。

    或者，按一下外掛程式名稱，然後點選「Details」(詳細資料) 頁面上的「Delete」(刪除) 按鈕。

    無法刪除擴充功能正在使用的外掛程式。如要刪除這類外掛程式，請先修改擴充功能來移除外掛程式，或刪除擴充功能。

  4. 在確認訊息方塊中，按一下「Delete」(刪除) 確認操作。

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」頁面。

    前往 Service Extensions

  2. 按一下「外掛程式」分頁標籤。

  3. 選取要編輯的外掛程式，然後切換至編輯模式。

  4. 在「Versions」(版本) 區段中，勾選要刪除的版本，然後按一下「Delete」(刪除)。

  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 或區域

如果版本設為主要版本 (即主要 (有效) 版本)，您必須先將其他版本設為主要版本，才能刪除該版本。

後續步驟