Ver detalhes e status das extensões em uma VM

Use os métodos de estado de extensão somente leitura list e get para conferir o status de ambiente de execução das extensões instaladas em cada instância de VM sem se conectar a cada máquina. Quando você usa políticas de extensão, uma VM pode ter várias extensões instaladas por políticas diferentes. Os métodos de estado de extensão permitem ver a configuração final efetiva e a política de controle de cada extensão instalada, além de ajudar a resolver problemas quando uma extensão inesperada é instalada ou uma extensão falha em uma instância.

Sobre os detalhes e as informações de status da extensão

Para instalar extensões de VM em VMs, crie políticas de extensão globais ou zonais no nível da organização, da pasta ou do projeto. Uma única política pode instalar várias extensões em uma única VM, e várias políticas na hierarquia de recursos podem ser aplicadas à mesma VM.

Os métodos de estado de extensão somente leitura permitem listar os estados de todas as extensões na VM para visualizar a configuração efetiva final e o status de ambiente de execução de cada extensão instalada. As informações retornadas mostram a versão ativa, o estado de aplicação, o status de integridade e o identificador da política de controle de cada extensão.

Ver extensões e versões de VM

Use a Google Cloud CLI ou a API Compute Engine para ver os detalhes sobre as extensões de VM instaladas. Neste documento, descrevemos como usar a gcloud. Para informações sobre como usar a API Compute Engine para visualizar estados de extensão, consulte Visualizar estados de extensão de MV em uma instância.

Permissões do IAM necessárias para ver os detalhes da extensão

Para ver os papéis necessários para acessar informações sobre as extensões instaladas e as versões delas no nível do projeto, da pasta ou da organização, selecione um dos níveis:

Projeto

Para receber as permissões necessárias para visualizar as políticas de extensão de VM zonais ou globais no nível do projeto, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute (roles/compute.vmExtensionPolicyViewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar políticas de extensão de VM zonais ou globais no nível do projeto. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar as políticas de extensão de VM zonais ou globais no nível do projeto:

  • Descreva uma extensão de VM específica em uma instância: compute.vmExtensions.get
  • Liste todas as extensões de VM em uma instância: compute.vmExtensions.list

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Pasta

As políticas de extensão no nível da pasta estão disponíveis em pré-lançamento.

Para receber as permissões necessárias para visualizar as políticas de extensão de VM zonais ou globais no nível da pasta, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da pasta (roles/compute.folderVmExtensionPolicyViewer) na pasta. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar políticas de extensão de VM zonais ou globais no nível da pasta. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar as políticas de extensão de VM zonais ou globais no nível da pasta:

  • Descreva uma extensão de VM específica em uma instância: compute.folderVmExtensions.get
  • Liste todas as extensões de VM em uma instância: compute.folderVmExtensions.list

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Organização

As políticas de extensão no nível da organização estão disponíveis em pré-lançamento.

Para receber as permissões necessárias para visualizar as políticas de extensão de VM zonais ou globais no nível da organização, peça ao administrador para conceder a você o papel do IAM de Leitor de políticas de extensão de VM do Compute no nível da organização (roles/compute.orgVmExtensionPolicyViewer) na sua organização. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar as políticas de extensão de VM globais ou zonais no nível da organização. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As seguintes permissões são necessárias para visualizar as políticas de extensão de VM globais ou zonais no nível da organização:

  • Descreva uma extensão de VM específica em uma instância: compute.orgVmExtensions.get
  • Liste todas as extensões de VM em uma instância: compute.orgVmExtensions.list

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Para mais informações sobre papéis e permissões do IAM no Compute Engine, consulte Papéis e permissões do Compute Engine.

Listar extensões e versões de VM

Para listar as extensões e versões de VM gerenciadas pelo Gerenciador de extensões de VM em zonas ou globalmente no projeto, na pasta ou na organização, selecione uma das seguintes opções:

Zonal

Use o comando gcloud preview compute zone-vm-extension-policies extensions list para listar as extensões de VM em uma zona no projeto, na pasta ou na organização:

Nível do projeto

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

Substitua as seguintes variáveis no comando:

  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino, por exemplo, us-central1-f.
Níveis de pasta e organização

Para executar a tarefa anterior no nível da pasta ou da organização, use o mesmo comando com uma das seguintes alterações:

  • Para informações no nível da pasta, substitua a opção --project=PROJECT_ID por --folder=folders/FOLDER_ID, em que FOLDER_ID é o ID numérico da pasta.
  • Para informações no nível da organização, substitua a opção --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, em que ORGANIZATION_ID é o ID numérico da organização.

Global

Use o comando gcloud preview compute global-vm-extension-policies extensions list para listar as extensões de VM em todas as zonas do projeto, da pasta ou da organização:

Nível do projeto

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

Substitua a seguinte variável no comando:

  • PROJECT_ID: o identificador do projeto.
Níveis de pasta e organização

Para executar a tarefa anterior no nível da pasta ou da organização, use o mesmo comando com uma das seguintes alterações:

  • Para informações no nível da pasta, substitua a opção --project=PROJECT_ID por --folder=folders/FOLDER_ID, em que FOLDER_ID é o ID numérico da pasta.
  • Para informações no nível da organização, substitua a opção --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, em que ORGANIZATION_ID é o ID numérico da organização.

Ver informações sobre uma extensão de VM específica

Para conferir os detalhes de uma extensão de VM específica em uma única zona ou globalmente no projeto, na pasta ou na organização, selecione uma das seguintes opções:

Zonal

Use o comando gcloud preview compute zone-vm-extension-policies extensions describe para ver os detalhes de uma extensão de VM específica em uma zona do seu projeto, pasta ou organização:

Nível do projeto

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

Substitua as seguintes variáveis no comando:

  • EXTENSION_NAME: uma das extensões compatíveis com o Gerenciador de extensões de VM, por exemplo, ops-agent.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona de destino, por exemplo, us-central1-f.
Níveis de pasta e organização

Para executar a tarefa anterior no nível da pasta ou da organização, use o mesmo comando com uma das seguintes alterações:

  • Para informações no nível da pasta, substitua a opção --project=PROJECT_ID por --folder=folders/FOLDER_ID, em que FOLDER_ID é o ID numérico da pasta.
  • Para informações no nível da organização, substitua a opção --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, em que ORGANIZATION_ID é o ID numérico da organização.

Global

Use o comando gcloud preview compute global-vm-extension-policies extensions describe para conferir os detalhes de uma extensão de VM específica em todas as zonas do projeto, da pasta ou da organização:

Nível do projeto

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

Substitua as seguintes variáveis no comando:

  • EXTENSION_NAME: uma das extensões compatíveis com o Gerenciador de extensões de VM, por exemplo, ops-agent.
  • PROJECT_ID: o identificador do projeto.
Níveis de pasta e organização

Para executar a tarefa anterior no nível da pasta ou da organização, use o mesmo comando com uma das seguintes alterações:

  • Para informações no nível da pasta, substitua a opção --project=PROJECT_ID por --folder=folders/FOLDER_ID, em que FOLDER_ID é o ID numérico da pasta.
  • Para informações no nível da organização, substitua a opção --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, em que ORGANIZATION_ID é o ID numérico da organização.

Ver os estados das extensões de VM em uma instância

As políticas de extensão podem instalar várias extensões em uma única VM. Para determinar o status de cada extensão, incluindo a configuração efetiva, o status do ambiente de execução e outras informações, examine o estado das extensões em uma VM específica.

Os métodos de estado de extensão retornam informações apenas sobre instâncias do Agente de Operações instaladas e gerenciadas por políticas do Gerenciador de Extensões de VM. Se algumas VMs estiverem executando agentes instalados por outros meios, não haverá informações de extensão para relatar sobre esses agentes.

Use a Google Cloud CLI ou a API Compute Engine para conferir o estado das extensões instaladas nas VMs. Neste documento, descrevemos como usar a gcloud. Para informações sobre como usar a API Compute Engine para visualizar estados de extensão, consulte Visualizar estados de extensão de MV em uma instância.

Permissões do IAM necessárias para visualizar o estado da extensão

Para receber as permissões necessárias para visualizar os estados de extensão de VM em uma instância, peça ao administrador para conceder a você o papel do IAM de Leitor do Compute (roles/compute.viewer) no projeto. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Esse papel predefinido contém as permissões necessárias para visualizar os estados de extensão de VM em uma instância. Para acessar as permissões exatas necessárias, expanda a seção Permissões necessárias:

Permissões necessárias

As permissões a seguir são necessárias para visualizar os estados de extensão de VM em uma instância:

  • Liste os estados de todas as extensões de VM em uma instância: compute.instances.listVmExtensionStates
  • Receba o estado de uma extensão de VM específica em uma instância: compute.instances.getVmExtensionState

Essas permissões também podem ser concedidas com funções personalizadas ou outros papéis predefinidos.

Listar extensões instaladas em uma instância de VM

Para listar todas as extensões de VM instaladas em uma instância e ver os estados atuais delas usando a gcloud, execute o comando gcloud beta compute instances list-vm-extension-states:

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

Substitua as seguintes variáveis no comando:

  • INSTANCE_NAME: o nome da instância de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona em que a instância reside, por exemplo, us-central1-f.

O comando retorna o nome, o estado de aplicação e o status de integridade de cada extensão instalada. Para informações sobre os valores retornados ao visualizar estados de extensão, consulte Interpretar campos de estado de extensão de VM.

Para mais informações sobre como visualizar informações sobre o estado das extensões nas VMs, incluindo informações sobre como usar a API Compute Engine, consulte Visualizar estados de extensão de MV em uma instância.

Ver o estado de uma extensão de VM específica em uma instância

Para receber informações de status sobre uma extensão de VM específica instalada em uma VM usando a gcloud, execute o comando 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

Substitua as seguintes variáveis no comando:

  • INSTANCE_NAME: o nome da instância de VM.
  • PROJECT_ID: o identificador do projeto.
  • ZONE: a zona em que a instância reside, por exemplo, us-central1-f.
  • EXTENSION_NAME: uma das extensões compatíveis com o Gerenciador de extensões de VM, por exemplo, ops-agent.

O comando retorna o nome da extensão, a versão ativa, as informações de integridade, as informações de restrição e o ID da política de controle. Para informações sobre os valores retornados ao visualizar estados de extensão, consulte Interpretar campos de estado de extensão de VM.

Para mais informações sobre como visualizar informações sobre o estado das extensões nas VMs, incluindo informações sobre como usar a API Compute Engine, consulte Visualizar estados de extensão de MV em uma instância.

A seguir