管理外掛程式

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

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

如需產品總覽，請參閱「服務擴充功能總覽」。

查看外掛程式

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

列出外掛程式

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

控制台

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

   前往 Service Extensions

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

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

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

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

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

   2. 從清單中選取資源。

      屬性名稱會顯示在「篩選器表格」標籤旁，後方加上半形冒號。

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

   4. 選用：在屬性值配對之間輸入 OR 運算子，指定合併的篩選條件。

4. 選用：如要對所選外掛程式執行其他作業，請按一下「更多動作」，然後選取所需選項：

   • 如要編輯外掛程式，請按一下「編輯」。
   • 如要刪除外掛程式，請按一下「刪除」。
   • 如要開啟記錄檔探索工具，以便擷取、查看及分析外掛程式的記錄檔資料，請按一下「在記錄檔探索工具中查看」。
   • 如要開啟「服務擴充功能監控」頁面，請按一下「查看監控」。

gcloud

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

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

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

專案中的外掛程式會列在表格中，表格包含下列資訊：

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

查看外掛程式詳細資料

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

控制台

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

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

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

   前往 Service Extensions

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

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

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

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

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：新 Wasm 模組的 URI，儲存在 Artifact Registry 存放區
• MAIN_VERSION：要建立並設為主要 (或服務) 版本的外掛程式版本 ID。
• PLUGIN_CONFIG、PLUGIN_CONFIG_FILE 或 PLUGIN_CONFIG_URI：選用的設定檔，可分別以文字、本機檔案或 Artifact Registry 中的映像檔形式內嵌指定。

注意： 如要建立新的外掛程式版本，但不要將其設為主要版本，請使用 gcloud service-extensions wasm-plugins create 指令。

變更外掛程式的主要版本

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

控制台

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

   前往 Service Extensions

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

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

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

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

3. 找出要刪除的外掛程式，然後依序點選「更多動作」按鈕和「刪除」。

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

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

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

gcloud

1. 從服務設定中移除外掛程式的參照，然後重新匯入設定 YAML 檔案。

   詳情請參閱如何設定 Cloud Load Balancing route 和 traffic 外掛程式，以及 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. 在「版本」部分，選取要刪除的版本核取方塊，然後按一下「刪除」。

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 總覽。