Use este documento para verificar se o VM Manager está configurado corretamente. Para informações sobre como configurar o VM Manager, consulte Configurar o VM Manager.
Para verificar a configuração, use o comando de solução de problemas ou realize verificações manuais na instância da máquina virtual (VM).
Antes de começar
- Para VMs do Windows, use o PowerShell 3.0 ou posterior.
-
Configure a autenticação, caso ainda não tenha feito isso.
A autenticação é
o processo de verificação da sua identidade para acesso a serviços e APIs do Trusted Cloud by S3NS .
Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no
Compute Engine selecionando uma das seguintes opções:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Trusted Cloud console to access Trusted Cloud by S3NS services and APIs, you don't need to set up authentication.
gcloud
-
Instale a Google Cloud CLI e faça login nela com sua identidade federada. Depois de fazer login, inicialize a Google Cloud CLI executando o seguinte comando:
gcloud init
- Set a default region and zone.
Usar o comando de solução de problemas
Use o comando
os-config troubleshoot
para verificar a configuração. Se alguma das verificações falhar, você vai receber feedback sobre como corrigir o problema.gcloud compute os-config troubleshoot VM_NAME \ --zone=ZONE
Substitua:
VM_NAME
: o nome da instância de VM que você quer resolver o problema.ZONE
: a zona em que a instância está localizada.
Exemplos
- Exemplo 1: mostra a saída do comando
os-config troubleshoot
quando a instância de VM tem problemas com a configuração Exemplo 2: mostra a saída do comando
os-config troubleshoot
quando a instância de VM está configurada corretamente
Exemplo 1
Para resolver problemas de uma instância de VM chamada
my-instance-1
na zonaasia-east2-b
, execute o seguinte:gcloud compute os-config troubleshoot my-instance-1 \ --zone=asia-east2-b
A saída será assim:
OS Config troubleshooter tool is checking if there are issues with the VM Manager setup for this VM instance. > Is the OS Config API enabled? Yes > Is the OS Config agent enabled? Yes > Is the OS Config agent up to date? No The version of OS Config agent running on this VM instance is not the latest version. See https://cloud.google.com/compute/docs/manage-os/upgrade-vm-manager#update-agent on how to update the agent.
Exemplo 2
Para resolver problemas de uma instância de VM chamada
my-instance-2
na zonaus-west1-b
, execute o seguinte:gcloud compute os-config troubleshoot my-instance-2 \ --zone=us-west1-b
A saída será assim:
OS Config troubleshooter tool is checking if there are issues with the VM Manager setup for this VM instance. > Is the OS Config API enabled? Yes > Is the OS Config agent enabled? Yes > Is the OS Config agent up to date? Yes > Is a service account present on the instance? Yes > Is the OS Config Service account present for this instance? Yes > Does this instance have a public IP or Private Google Access? Yes This instance has a public IP.
Verificação manual
Para verificar manualmente se o VM Manager está configurado corretamente, faça as seguintes verificações:
- API OS Config ativada
- Os metadados de Configuração do SO estão ativados
- Agente de configuração do SO instalado e em execução
- Conta de serviço ativada
- A VM pode se comunicar com a API OS Config
Se o VM Manager estiver configurado corretamente, mas você ainda tiver problemas, consulte Solução de problemas do VM Manager.
Verificar se a API OS Config está ativada
No seu projeto Trusted Cloud , verifique se a API está ativada.
Console
No console Trusted Cloud , acesse a página API OS Config.
gcloud
gcloud services list --enabled
Se a API estiver ativada, a saída será semelhante a esta:
osconfig.googleapis.com OS Config API
Se a API não estiver ativada, ative a API OS Config.
Verificar se os metadados estão ativados
Linux
Para metadados de projeto, na VM, conclua as seguintes etapas:
Consultar o endpoint de atributos do projeto:
curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/" \ -H "Metadata-Flavor: Google"
Se o valor de metadados do agente estiver definido, a saída será semelhante a esta:
enable-osconfig
Se o valor
enable-osconfig
for exibido, consulte o endpoint:curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig" \ -H "Metadata-Flavor: Google"
Se ativado, o endpoint retornará
TRUE
.
Se os metadados não estiverem ativados, ative os Metadados de configuração do SO.
Windows
Para metadados de projeto, em uma VM, abra um terminal do PowerShell como administrador e execute o seguinte comando:
Consultar o endpoint de atributos do projeto:
$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/") $value
Se o valor de metadados do agente estiver definido, a saída será semelhante a esta:
enable-osconfig
Se o valor
enable-osconfig
for exibido, consulte o endpoint:$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig") $value
Se ativado, o endpoint retornará
TRUE
.
Se os metadados não estiverem ativados, ative os Metadados de configuração do SO.
Verificar se o agente de configuração do SO está instalado e em execução
Linux
Para verificar se a VM do Linux tem o agente instalado, execute este comando:
sudo systemctl status google-osconfig-agent
Se o agente estiver instalado e em execução, a resposta será semelhante a esta:
google-osconfig-agent.service - Google OSConfig Agent Loaded: loaded (/lib/systemd/system/google-osconfig-agent.service; enabled; vendor preset: Active: active (running) since Wed 2020-01-15 00:14:22 UTC; 6min ago Main PID: 369 (google_osconfig) Tasks: 8 (limit: 4374) Memory: 102.7M CGroup: /system.slice/google-osconfig-agent.service └─369 /usr/bin/google_osconfig_agent
Instale o agente de configuração do SO, caso não esteja instalado.
Windows
Para verificar se a VM do Windows tem o agente instalado, execute este comando:
PowerShell Get-Service google_osconfig_agent
Se o agente estiver instalado e em execução, a resposta será semelhante a esta:
Status Name DisplayName ------ ---- ----------- Running google_osconfig... Google OSConfig Agent
Instale o agente de configuração do SO, caso não esteja instalado.
Verificar se a conta de serviço está ativada
Para informações sobre os requisitos da conta de serviço, consulte Visão geral da configuração.
Linux
Na VM, execute o seguinte:
curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" \ -H "Metadata-Flavor: Google"
A saída precisa incluir pelo menos a conta de serviço padrão.
default/
Windows
Na VM, abra um terminal do PowerShell como administrador e execute o seguinte comando:
$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/") $value
A saída precisa incluir pelo menos a conta de serviço padrão.
default/
Verificar se a VM pode se comunicar com a API OS Config
Para verificar se a VM pode se comunicar com a API OS Config, execute o seguinte comando na VM do Linux ou do Windows:
ping osconfig.googleapis.com
Para interromper o ping da API OS Config, pressione Control + C.
Se sua VM está sendo executada em uma rede VPC privada e não tem acesso público à Internet, verifique se você ativou o Acesso privado do Google.
Depois de ativar o Acesso privado do Google, verifique se o agente pode se comunicar com a API OS Config.
Linux
Na VM, execute o seguinte:
curl --ssl 'https://osconfig.googleapis.com/$discovery/rest' | head
Se a VM puder se comunicar com a API OS Config, a resposta ao comando será semelhante a esta:
% Total % Received % Xferd Average Speed Time Time Time Current Dload Upload Total Spent Left Speed 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0{ "discoveryVersion": "v1", "baseUrl": "https://osconfig.googleapis.com/", "ownerName": "Google", "version": "v1beta", "schemas": { "GooSettings": { "description": "Googet patching is performed by running `googet update`.", "properties": {}, "id": "GooSettings", 100 9569 0 9569 0 0 198k 0 --:--:-- --:--:-- --:--:-- 198k
Windows
Na VM, abra um terminal do PowerShell como administrador e execute o seguinte comando:
Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'} -Uri 'https://osconfig.googleapis.com/$discovery/rest'
A seguir
- Veja os detalhes do sistema operacional.
- Crie uma atribuição de política do SO.
- Crie jobs de patch.
- Como solucionar problemas do VM Manager.
Exceto em caso de indicação contrária, o conteúdo desta página é licenciado de acordo com a Licença de atribuição 4.0 do Creative Commons, e as amostras de código são licenciadas de acordo com a Licença Apache 2.0. Para mais detalhes, consulte as políticas do site do Google Developers. Java é uma marca registrada da Oracle e/ou afiliadas.
Última atualização 2025-08-08 UTC.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Não contém as informações de que eu preciso","missingTheInformationINeed","thumb-down"],["Muito complicado / etapas demais","tooComplicatedTooManySteps","thumb-down"],["Desatualizado","outOfDate","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Problema com as amostras / o código","samplesCodeIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 2025-08-08 UTC."],[[["This document provides methods to verify that VM Manager is properly set up, including using the `os-config troubleshoot` command or performing manual checks on the VM instance."],["Before using the verification methods, you may need to set up authentication, and for Windows VMs, PowerShell 3.0 or later is required."],["The `os-config troubleshoot` command is used with a specific VM name and zone to check for setup issues, and if any problems are detected, feedback is provided on how to resolve them."],["Manual verification involves checking if the OS Config API is enabled, OS Config metadata is enabled, the OS Config agent is installed and running, the service account is enabled, and the VM can communicate with the OS Config API."],["If VM Manager is correctly set up but issues still arise, further troubleshooting steps are available in the linked \"Troubleshooting VM Manager\" document."]]],[]] -