查看 VM 擴充功能的詳細資料和狀態

使用唯讀擴充功能狀態 list 和 get 方法,即可查看每個 VM 執行個體上已安裝擴充功能的執行階段狀態,不必連線至每部機器。使用擴充功能政策時,一個 VM 可能會由不同政策安裝多個擴充功能。擴充功能狀態方法可讓您查看每個已安裝擴充功能的最終有效設定和管理政策,並在安裝非預期的擴充功能或擴充功能在執行個體上失敗時,協助您排解問題。

關於擴充功能詳細資料和狀態資訊

如要在 VM 上安裝 VM 擴充功能,請在組織、資料夾或專案層級建立全域或可用區擴充功能政策。單一政策可在單一 VM 上安裝多個擴充功能,而資源階層中的多項政策可套用至同一個 VM。

唯讀擴充功能狀態方法可讓您列出 VM 上所有擴充功能的狀態,查看每個已安裝擴充功能的最終有效設定和執行階段狀態。傳回的資訊會顯示各個擴充功能的有效版本、強制執行狀態、健康狀態,以及管理政策的 ID。

查看 VM 擴充功能和版本

您可以使用 Google Cloud CLI 或 Compute Engine API,查看已安裝 VM 擴充功能的詳細資料。本文說明如何使用 gcloud。如要瞭解如何使用 Compute Engine API 查看擴充功能狀態,請參閱「查看執行個體的 MV 擴充功能狀態」。

查看擴充功能詳細資料所需的 IAM 權限

如要查看在專案、資料夾或組織層級,查看已安裝擴充功能及其版本資訊所需的角色,請選取下列其中一個層級:

專案

如要取得所需權限,在專案層級查看可用區或全域 VM 擴充功能政策,請要求管理員授予您專案的 Compute VM 擴充功能政策檢視者 (roles/compute.vmExtensionPolicyViewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備必要權限,可在專案層級查看可用區或全域 VM 擴充功能政策。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能在專案層級查看可用區或全域 VM 擴充功能政策:

  • 描述執行個體上的特定 VM 擴充功能:compute.vmExtensions.get
  • 列出執行個體上的所有 VM 擴充功能: compute.vmExtensions.list

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

資料夾

資料夾層級擴充政策目前為預先發布版。

如要取得在資料夾層級查看可用區或全域 VM 擴充功能政策所需的權限,請要求管理員授予您資料夾的資料夾層級 Compute VM 擴充功能政策檢視者 (roles/compute.folderVmExtensionPolicyViewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備所需權限,可在資料夾層級查看可用區或全域 VM 擴充功能政策。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能在資料夾層級查看可用區或全域 VM 擴充功能政策:

  • 描述執行個體上的特定 VM 擴充功能:compute.folderVmExtensions.get
  • 列出執行個體上的所有 VM 擴充功能: compute.folderVmExtensions.list

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

機構

組織層級擴充功能政策目前為預先發布版。

如要取得在組織層級查看可用區或全域 VM 擴充功能政策所需的權限,請要求管理員授予您組織的組織層級 Compute VM 擴充功能政策檢視者 (roles/compute.orgVmExtensionPolicyViewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備所需權限,可在組織層級查看可用區或全域 VM 擴充功能政策。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能在組織層級查看可用區或全域 VM 擴充功能政策:

  • 描述執行個體上的特定 VM 擴充功能:compute.orgVmExtensions.get
  • 列出執行個體上的所有 VM 擴充功能: compute.orgVmExtensions.list

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

如要進一步瞭解 Compute Engine 中的 IAM 角色和權限,請參閱「Compute Engine 角色和權限」。

列出 VM 擴充功能和版本

如要列出專案、資料夾或組織中,由 VM 擴充功能管理工具在各可用區或全域管理的 VM 擴充功能和版本,請選取下列其中一個選項:

可用區

使用 gcloud preview compute zone-vm-extension-policies extensions list 指令,列出專案、資料夾或組織中某個可用區的 VM 擴充功能:

專案層級

gcloud preview compute zone-vm-extension-policies extensions list \
  --project=PROJECT_ID \
  --zone=ZONE

替換指令中的下列變數:

  • PROJECT_ID:專案 ID。
  • ZONE:目標可用區,例如 us-central1-f。
資料夾和組織層級

如要在資料夾或組織層級執行上述工作,請使用相同指令,並進行下列其中一項變更:

  • 如要取得資料夾層級資訊,請將 --project=PROJECT_ID 選項替換為 --folder=folders/FOLDER_ID,其中 FOLDER_ID 是資料夾的數字 ID。
  • 如要查看組織層級資訊,請將 --project=PROJECT_ID 選項替換為 --organization=organizations/ORGANIZATION_ID,其中 ORGANIZATION_ID 是組織的數字 ID。

全球

使用 gcloud preview compute global-vm-extension-policies extensions list 指令,列出專案、資料夾或組織中所有可用區的 VM 擴充功能:

專案層級

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

替換指令中的下列變數:

  • PROJECT_ID:專案 ID。
資料夾和組織層級

如要在資料夾或組織層級執行上述工作,請使用相同指令,並進行下列其中一項變更:

  • 如要取得資料夾層級資訊,請將 --project=PROJECT_ID 選項替換為 --folder=folders/FOLDER_ID,其中 FOLDER_ID 是資料夾的數字 ID。
  • 如要查看組織層級資訊,請將 --project=PROJECT_ID 選項替換為 --organization=organizations/ORGANIZATION_ID,其中 ORGANIZATION_ID 是組織的數字 ID。

查看特定 VM 擴充功能的資訊

如要查看專案、資料夾或組織中,特定 VM 擴充功能在單一可用區或全球的詳細資料,請選取下列其中一個選項:

可用區

使用 gcloud preview compute zone-vm-extension-policies extensions describe 指令,查看專案、資料夾或組織內某個可用區中特定 VM 擴充功能的詳細資料:

專案層級

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

替換指令中的下列變數:

  • EXTENSION_NAME:VM 擴充功能管理工具支援的擴充功能之一,例如 ops-agent。
  • PROJECT_ID:專案 ID。
  • ZONE:目標可用區,例如 us-central1-f。
資料夾和組織層級

如要在資料夾或組織層級執行上述工作,請使用相同指令,並進行下列其中一項變更:

  • 如要取得資料夾層級資訊,請將 --project=PROJECT_ID 選項替換為 --folder=folders/FOLDER_ID,其中 FOLDER_ID 是資料夾的數字 ID。
  • 如要查看組織層級資訊,請將 --project=PROJECT_ID 選項替換為 --organization=organizations/ORGANIZATION_ID,其中 ORGANIZATION_ID 是組織的數字 ID。

全球

使用 gcloud preview compute global-vm-extension-policies extensions describe 指令,查看專案、資料夾或組織中所有可用區內特定 VM 擴充功能的詳細資料:

專案層級

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

替換指令中的下列變數:

  • EXTENSION_NAME:VM 擴充功能管理工具支援的擴充功能之一,例如 ops-agent。
  • PROJECT_ID:專案 ID。
資料夾和組織層級

如要在資料夾或組織層級執行上述工作,請使用相同指令,並進行下列其中一項變更:

  • 如要取得資料夾層級資訊,請將 --project=PROJECT_ID 選項替換為 --folder=folders/FOLDER_ID,其中 FOLDER_ID 是資料夾的數字 ID。
  • 如要查看組織層級資訊,請將 --project=PROJECT_ID 選項替換為 --organization=organizations/ORGANIZATION_ID,其中 ORGANIZATION_ID 是組織的數字 ID。

查看執行個體上的 VM 擴充功能狀態

擴充功能政策可能會在單一 VM 上安裝多個擴充功能。如要判斷各個擴充功能的狀態,包括有效設定、執行階段狀態和其他資訊,您可以檢查特定 VM 上的擴充功能狀態。

擴充功能狀態方法只會傳回由 VM 擴充功能管理工具政策安裝及管理的 Ops Agent 執行個體資訊。如果某些 VM 執行的代理程式是透過其他方式安裝,則不會回報這些代理程式的擴充功能資訊。

您可以使用 Google Cloud CLI 或 Compute Engine API,查看 VM 上安裝的擴充功能狀態。本文說明如何使用 gcloud。如要瞭解如何使用 Compute Engine API 查看擴充功能狀態,請參閱「查看執行個體的 MV 擴充功能狀態」。

查看擴充功能狀態所需的 IAM 權限

如要取得查看執行個體 VM 擴充功能狀態所需的權限,請要求管理員授予您專案的 Compute 檢視者 (roles/compute.viewer) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備查看執行個體 VM 擴充功能狀態所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

必須具備下列權限,才能查看執行個體的 VM 擴充功能狀態:

  • 列出執行個體上所有 VM 擴充功能的狀態: compute.instances.listVmExtensionStates
  • 取得執行個體上特定 VM 擴充功能的狀態:compute.instances.getVmExtensionState

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

列出 VM 執行個體上安裝的擴充功能

如要使用 gcloud 列出執行個體上安裝的所有 VM 擴充功能,並查看其目前狀態,請執行 gcloud beta compute instances list-vm-extension-states 指令:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

替換指令中的下列變數:

  • INSTANCE_NAME:VM 執行個體的名稱。
  • PROJECT_ID:專案 ID。
  • ZONE:執行個體所在的可用區,例如 us-central1-f。

指令會傳回每個已安裝擴充功能的名稱、強制執行狀態和健康狀態。如要瞭解查看擴充功能狀態時傳回的值,請參閱「解讀 VM 擴充功能狀態欄位」。

如要進一步瞭解如何查看 VM 擴充功能狀態的資訊,包括如何使用 Compute Engine API,請參閱「查看執行個體的 MV 擴充功能狀態」。

查看執行個體上特定 VM 擴充功能的狀態

如要使用 gcloud 取得 VM 上安裝的特定 VM 擴充功能狀態資訊,請執行 gcloud beta compute instances get-vm-extension-state 指令:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE \
    --extension-name=EXTENSION_NAME

替換指令中的下列變數:

  • INSTANCE_NAME:VM 執行個體的名稱。
  • PROJECT_ID:專案 ID。
  • ZONE:執行個體所在的可用區,例如 us-central1-f。
  • EXTENSION_NAME:VM 擴充功能管理工具支援的擴充功能之一,例如 ops-agent。

指令會傳回擴充功能的名稱、有效版本、健康狀態資訊、強制執行資訊,以及管理政策的 ID。如要瞭解查看擴充功能狀態時傳回的值,請參閱「解讀 VM 擴充功能狀態欄位」。

如要進一步瞭解如何查看 VM 擴充功能狀態的資訊,包括如何使用 Compute Engine API,請參閱「查看執行個體的 MV 擴充功能狀態」。

後續步驟