Verifica la configuración de VM Manager


Usa este documento para verificar que VM Manager esté configurado de forma correcta. Para obtener información sobre la configuración de VM Manager, consulta Configura VM Manager.

Para verificar la configuración, puedes usar el comando de solución de problemas o realizar verificaciones manuales en la instancia de máquina virtual (VM).

Antes de comenzar

  • Para VM de Windows, usa PowerShell 3.0 o versiones posteriores.
  • Si aún no lo hiciste, configura la autenticación. La autenticación es el proceso mediante el cual se verifica tu identidad para acceder a los servicios y las API de Google Cloud. Para ejecutar código o muestras desde un entorno de desarrollo local, puedes autenticarte en Compute Engine de la siguiente manera.

    Selecciona la pestaña para saber cómo planeas usar las muestras en esta página:

    Consola

    Cuando usas la consola de Google Cloud para acceder a los servicios y las APIs de Google Cloud, no necesitas configurar la autenticación.

    gcloud

    1. Instala Google Cloud CLI y, luego, inicializa la ejecución del siguiente comando:

      gcloud init
    2. Configura una región y una zona predeterminadas.

Usa el comando de solución de problemas

Usa el comando os-config troubleshoot para verificar la configuración. Si alguna de las verificaciones falla, recibirás comentarios sobre cómo solucionar el problema.

gcloud compute os-config troubleshoot VM_NAME \
   --zone=ZONE

Reemplaza lo siguiente:

  • VM_NAME: el nombre de la instancia de VM en la que deseas solucionar problemas
  • ZONE: Es la zona en la que se encuentra la instancia.

Examples

  • 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 de forma correcta

Ejemplo 1

Para solucionar problemas en una instancia de VM llamada my-instance-1 en la zona asia-east2-b, ejecuta lo siguiente:

gcloud compute os-config troubleshoot my-instance-1 \
    --zone=asia-east2-b

El resultado se ve de la manera 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 en una instancia de VM llamada my-instance-2 en la zona us-west1-b, ejecuta lo siguiente:

gcloud compute os-config troubleshoot my-instance-2 \
    --zone=us-west1-b

El resultado se ve de la manera 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, completa las siguientes verificaciones:

Si VM Manager está configurado de forma correcta, pero aún tienes problemas, consulta Soluciona problemas de VM Manager.

Comprueba si la API de configuración del SO está habilitada

En el proyecto de Google Cloud, verifica si la API está habilitada.

Consola

En la consola de Google Cloud, ve a la página API de configuración del SO.

Ir a API de configuración del SO

gcloud

gcloud services list --enabled

Si la API está habilitada, el resultado será similar al siguiente:

osconfig.googleapis.com              OS Config API

Si la API no está habilitada, habilita la API de configuración del SO.

Comprueba si los metadatos están habilitados

Linux

Para los metadatos del proyecto, en la VM, completa los siguientes pasos:

  1. Consulta el extremo de los 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 será similar al que figura a continuación:

    enable-osconfig
    
  2. Si se muestra el valor enable-osconfig, consulta el extremo:

    curl "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig" \
    -H "Metadata-Flavor: Google"

    Si está habilitado, el extremo muestra TRUE.

Si los metadatos no están habilitados, habilita los metadatos de configuración del SO.

Windows

Para los metadatos del proyecto, en una VM, abre una terminal de PowerShell como administrador y ejecuta el siguiente comando:

  1. Consulta el extremo de los 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 será similar al que figura a continuación:

    enable-osconfig
    
  2. Si se muestra el valor enable-osconfig, consulta el extremo:

    $value = (Invoke-RestMethod `
             -Headers @{'Metadata-Flavor' = 'Google'} `
             -Uri "http://metadata.google.internal/computeMetadata/v1/project/attributes/enable-osconfig")
    $value
    

    Si está habilitado, el extremo muestra TRUE.

Si los metadatos no están habilitados, habilita los metadatos de configuración del SO.

Verifica si el agente de configuración del SO está instalado y en ejecución

Linux

Para comprobar si tu VM de Linux tiene el agente instalado, ejecuta el siguiente comando:

sudo systemctl status google-osconfig-agent

Si el agente está instalado y en ejecución, 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, instala el agente de configuración del SO.

Windows

Para comprobar si tu VM de Windows tiene el agente instalado, ejecuta el siguiente comando:

PowerShell Get-Service google_osconfig_agent

Si el agente está instalado y en ejecución, el resultado es similar al siguiente:

Status   Name               DisplayName
------   ----               -----------
Running  google_osconfig... Google OSConfig Agent

Si el agente no está instalado, instala el agente de configuración del SO.

Revisa si la cuenta de servicio está habilitada

Para obtener información sobre los requisitos de la cuenta de servicio, consulta Descripción general de la configuración.

Linux

En la VM, ejecuta 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/

Windows

En la VM, abre una terminal de PowerShell como administrador y ejecuta 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/

Verifica si la VM puede comunicarse con la API de configuración del SO

Para verificar si la VM puede comunicarse con la API de configuración del SO, ejecuta el siguiente comando en tu VM de Linux o Windows:

ping osconfig.googleapis.com

Para dejar de hacer ping a la API de configuración del SO, presiona Control + C.

Si tu VM se ejecuta en una red de VPC privada y no tiene acceso público a Internet, verifica que hayas habilitado el Acceso privado a Google.

Después de habilitar el Acceso privado a Google, verifica que la VM se pueda comunicar con la API de configuración del SO.

Linux

En la VM, ejecuta lo siguiente:

 curl --ssl 'https://osconfig.googleapis.com/$discovery/rest' | head

Si la VM se puede comunicar con la API de configuración del SO, 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

Windows

En la VM, abre una terminal de PowerShell como administrador y ejecuta lo siguiente:

 Invoke-RestMethod  -Headers @{'Metadata-Flavor' = 'Google'}
 -Uri 'https://osconfig.googleapis.com/$discovery/rest'

Próximos pasos