Administra las políticas de invitado (heredadas)

Después de crear una política de invitado, puedes usar los siguientes procedimientos para revisar y administrar las políticas:

• Actualiza las políticas de invitado: modifica la configuración de las políticas de invitado.
• Describe las políticas de invitado: obtén detalles sobre una política de invitado específica.
• Enumera las políticas de invitado: visualiza una lista de las políticas de invitado de un proyecto.
• Borra un invitado: borra una política de invitado específica.
• Visualiza una configuración para una instancia de VM: visualiza la configuración que se aplica a una instancia de VM.
• Depura una política de invitado: soluciona problemas relacionados con una política de invitado.

Dado que el agente de configuración del SO se ejecuta cada 10 o 15 minutos, cuando configuras la actualización o eliminación de una política, demora entre 10 y 15 minutos en aplicarse.

Puedes administrar tus políticas de invitado con Google Cloud CLI o REST.

Antes de comenzar

• Revisa las cuotas de configuración del SO.
• 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 APIs de Trusted Cloud by S3NS . 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:

  gcloud

  1. Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando:

     gcloud init

  2. Set a default region and zone.

  REST

  Para usar las muestras de la API de REST en esta página en un entorno de desarrollo local, debes usar las credenciales que proporcionas a gcloud CLI.

  Instala Google Cloud CLI y, luego, accede a gcloud CLI con tu identidad federada. Después de acceder, inicializa Google Cloud CLI ejecutando el siguiente comando:

  gcloud init

  Si deseas obtener más información, consulta Autentica para usar REST en la Trusted Cloud documentación de autenticación.

Actualiza las políticas de invitado

Para actualizar una política de invitado, sigue estos pasos:

1. Actualiza el archivo YAML o JSON.
2. Ejecuta un comando de actualización o aplicación de parches. El proceso de actualización es similar al proceso de creación, pero se agrega la compatibilidad con etags que permite el control de la simultaneidad y la coherencia.

gcloud beta compute os-config guest-policies update POLICY_ID \
     --file=FILE

PATCH https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

{
  For more information, see Guest policy JSON
}

Describe una política de invitado

gcloud beta compute os-config guest-policies describe POLICY_ID

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Enumerar las políticas de invitado

gcloud beta compute os-config guest-policies list

GET https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies

Borra las políticas de invitado

Cuando el agente de configuración del SO detecta que se activa la eliminación de una política de invitado, se mantiene el estado actual del sistema, pero no se realizan más tareas de mantenimiento de la configuración. Por ejemplo, supongamos que tienes configurada una política de invitado package-update-zone2b que instala un paquete my-package en todas las VM de la zona us-west2-b y que mantiene el paquete UPDATED.

Si eliminas la política package-update-zone2b, se producirán los siguientes cambios:

• Todas las VM en us-west2-b que tengan my-package instalado conservan my-package instalado. No se revierte el estado actual del sistema.

• Después de borrar la política, en todas las ejecuciones futuras del agente de configuración del SO, ocurre lo siguiente:

  • Si se agrega una VM nueva a us-west2-b, no se instalará my-package en esta VM.
  • En instancias con my-package instalado, el paquete no se actualiza.

gcloud beta compute os-config guest-policies delete POLICY_ID

DELETE https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/guestPolicies/POLICY_ID

Visualiza la configuración de una instancia de VM

gcloud beta compute os-config guest-policies lookup VM_NAME \
    --zone=ZONE

POST https://osconfig.googleapis.com/v1beta/projects/PROJECT_ID/zones/ZONE/instances/VM_NAME:lookupEffectiveGuestPolicy

Soluciona problemas

Inspecciona las políticas de invitado

Puedes usar la consola de Trusted Cloud o Google Cloud CLI para inspeccionar las políticas de invitado asociadas con tu proyecto.

Inspecciona las políticas de invitado de una VM específica

Puedes ejecutar el comando lookup para una VM determinada a fin de ver qué opciones de configuración se aplican a esa VM.

En los casos en que una instancia de VM no parece cumplir con los requisitos de la política de invitado esperada, resulta útil inspeccionar la lista de políticas de invitado cuyas asignaciones incluyen esa instancia de VM específica. Esto ayuda a determinar si el campo Assignment en la política de invitado coincide con esta VM en particular.

Usa el comando os-config guest-policies lookup para generar una lista de las políticas de invitado que podrían estar orientadas a una VM en particular. Reemplaza VM_NAME por el nombre de la VM que se inspeccionará.

gcloud beta compute os-config guest-policies lookup VM_NAME

Para obtener más información, consulta Visualiza la configuración de una instancia de VM.

La salida del comando podría revelar que en realidad la VM no está orientada en las propiedades de asignación de VM de la política de invitado. Por ejemplo, puede que no aparezca en la lista de Labels o en la lista de prefijos de nombre de VM.

Recupérate de una falla

La instalación de una receta de software con errores no se reintenta. Esto se debe a que el sistema no conoce el estado que generó la receta de software con errores.

Cuando depures recetas de software con errores, te recomendamos los siguientes pasos:

1. Cambia el nombre de la receta de software.
2. Borra y vuelve a crear la política de invitado con la receta de software con nombre cambiado.

Si quieres ver más pasos para solucionar problemas, consulta Soluciona problemas de VM Manager.

Próximos pasos

• Obtén más información sobre las políticas de invitado del SO (heredadas).
• Configura una política de invitado.