Utilice este documento para verificar que VM Manager esté configurado correctamente. Para obtener información sobre cómo configurar VM Manager, consulte Configurar VM Manager .
Para verificar la configuración, puede utilizar el comando de resolución de problemas o realizar comprobaciones manuales en la instancia de la máquina virtual (VM).
Antes de comenzar
- Para máquinas virtuales Windows, utilice PowerShell 3.0 o posterior .
- Si aún no lo has hecho, configura la autenticación. La autenticación es el proceso mediante el cual se verifica su identidad para acceder a Google Cloud servicios y API. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine seleccionando una de las siguientes opciones:
Select the tab for how you plan to use the samples on this page:
Console
When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.
gcloud
-
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
- Set a default region and zone.
-
VM_NAME
: el nombre de la instancia de VM que desea solucionar -
ZONE
: la zona donde se encuentra la instancia - Ejemplo 1: muestra el resultado del comando
os-config troubleshoot
cuando la instancia de VM tiene problemas con la configuración Ejemplo 2: muestra el resultado del comando
os-config troubleshoot
cuando la instancia de VM está configurada correctamente- API de configuración del sistema operativo habilitada
- Los metadatos de configuración del sistema operativo están habilitados
- Agente de configuración del sistema operativo instalado y en ejecución
- Cuenta de servicio habilitada
- La VM puede comunicarse con la API de configuración del sistema operativo
Consulta el punto final de atributos del proyecto:
curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/" \ -H "Metadata-Flavor: Google"
Si se establece el valor de metadatos del agente, el resultado es similar al siguiente:
enable-osconfig
Si se muestra el valor
enable-osconfig
, consulte el punto final:curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig" \ -H "Metadata-Flavor: Google"
Si está habilitado, el punto final devuelve
TRUE
.Consulta el punto final de atributos del proyecto:
$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/") $value
Si se establece el valor de metadatos del agente, el resultado es similar al siguiente:
enable-osconfig
Si se muestra el valor
enable-osconfig
, consulte el punto final:$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig") $value
Si está habilitado, el punto final devuelve
TRUE
.- Ver detalles del sistema operativo .
- Cree una asignación de política de sistema operativo .
- Crear trabajos de parche .
- Solución de problemas del administrador de VM .
Utilice el comando de solución de problemas
Utilice el comando
os-config troubleshoot
para verificar la configuración. Si alguna de las comprobaciones falla, se le proporcionarán comentarios sobre cómo solucionar el problema.gcloud compute os-config troubleshoot VM_NAME \ --zone=ZONE
Reemplace lo siguiente:
Ejemplos
Ejemplo 1
Para solucionar problemas de una instancia de VM llamada
my-instance-1
en la zonaasia-east2-b
, ejecute lo siguiente:gcloud compute os-config troubleshoot my-instance-1 \ --zone=asia-east2-b
El resultado es similar al siguiente:
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.
Ejemplo 2
Para solucionar problemas de una instancia de VM llamada
my-instance-2
en la zonaus-west1-b
, ejecute lo siguiente:gcloud compute os-config troubleshoot my-instance-2 \ --zone=us-west1-b
El resultado es similar al siguiente:
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.
Verificación manual
Para verificar manualmente que VM Manager esté configurado correctamente, complete las siguientes comprobaciones:
Si VM Manager está configurado correctamente pero aún tiene problemas, consulte Solución de problemas de VM Manager .
Compruebe si la API de configuración del sistema operativo está habilitada
En su proyecto de Google Cloud, verifique si la API está habilitada.
Consola
En la consola de Google Cloud, vaya a la página API de configuración del sistema operativo .
nube de gcloud
gcloud services list --enabled
Si la API está habilitada, el resultado es similar al siguiente:
osconfig.googleapis.com OS Config API
Si la API no está habilitada, habilite la API de configuración del sistema operativo .
Compruebe si los metadatos están habilitados
linux
Para los metadatos del proyecto, en la máquina virtual, complete los siguientes pasos:
Si los metadatos no están habilitados, habilite los metadatos de configuración del sistema operativo .
ventanas
Para los metadatos del proyecto, en una VM, abra una terminal de PowerShell como administrador y ejecute el siguiente comando:
Si los metadatos no están habilitados, habilite los metadatos de configuración del sistema operativo .
Compruebe si el agente de configuración del sistema operativo está instalado y ejecutándose
linux
Para verificar si su máquina virtual Linux tiene el agente instalado, ejecute el siguiente comando:
sudo systemctl status google-osconfig-agent
Si el agente está instalado y ejecutándose, el resultado es similar al siguiente:
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
Si el agente no está instalado, instale el agente de configuración del sistema operativo .
ventanas
Para comprobar si su máquina virtual Windows tiene el agente instalado, ejecute el siguiente comando:
PowerShell Get-Service google_osconfig_agent
Si el agente está instalado y ejecutándose, el resultado es similar al siguiente:
Status Name DisplayName ------ ---- ----------- Running google_osconfig... Google OSConfig Agent
Si el agente no está instalado, instale el agente de configuración del sistema operativo .
Compruebe si la cuenta de servicio está habilitada
Para obtener información sobre los requisitos de la cuenta de servicio, consulte Descripción general de la configuración .
linux
En la VM, ejecute lo siguiente:
curl "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/" \ -H "Metadata-Flavor: Google"
El resultado debe incluir al menos la cuenta de servicio predeterminada.
default/
ventanas
En la VM, abra una terminal de PowerShell como administrador y ejecute el siguiente comando:
$value = (Invoke-RestMethod ` -Headers @{'Metadata-Flavor' = 'Google'} ` -Uri "http://metadata.google.internal/computeMetadata/v1/instance/service-accounts/") $value
El resultado debe incluir al menos la cuenta de servicio predeterminada.
default/
Compruebe si la VM puede comunicarse con la API de configuración del sistema operativo
Para comprobar si la máquina virtual puede comunicarse con la API de configuración del sistema operativo, ejecute el siguiente comando en su máquina virtual Linux o Windows:
ping osconfig.googleapis.com
Para dejar de hacer ping a la API de configuración del sistema operativo, presione Control + C.
Si su VM se ejecuta dentro de una red VPC privada y no tiene acceso público a Internet, verifique que haya habilitado el acceso privado a Google .
Después de habilitar el acceso privado a Google, verifique que la máquina virtual pueda comunicarse con la API de configuración del sistema operativo.
linux
En la VM, ejecute lo siguiente:
curl --ssl 'https://osconfig.googleapis.com/$discovery/rest' | head
Si la VM puede comunicarse con la API de configuración del sistema operativo, el resultado del comando es similar al siguiente:
% 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
ventanas
En la VM, abra una terminal PowerShell como administrador y ejecute lo siguiente:
Invoke-RestMethod -Headers @{'Metadata-Flavor' = 'Google'} -Uri 'https://osconfig.googleapis.com/$discovery/rest'
¿Qué sigue?
A menos que se indique lo contrario, el contenido de esta página está sujeto a la licencia Reconocimiento 4.0 de Creative Commons y las muestras de código están sujetas a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio web de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2025-04-17 (UTC).
-