Gestión de políticas para huéspedes (heredadas)

Organízate con las colecciones Guarda y clasifica el contenido según tus preferencias.

Después de crear una política para huéspedes , puede utilizar los siguientes procedimientos para revisar y administrar sus políticas:

• Actualizar políticas de invitados : modifica las configuraciones de tu política de invitados.
• Describir las políticas de los huéspedes : obtenga detalles sobre una política de huéspedes específica.
• Listar políticas de invitados : vea una lista de políticas de invitados en un proyecto.
• Eliminar un invitado : eliminar una política de invitado específica.
• Ver configuraciones para una instancia de VM : vea las configuraciones que se aplican a una instancia de VM.
• Depurar una política de invitados : solucionar problemas de una política de invitados.

Dado que el agente de configuración del sistema operativo se ejecuta cada 10 a 15 minutos, cuando configura una actualización o eliminación de una política, tardará aproximadamente entre 10 y 15 minutos en surtir efecto.

Puede administrar sus políticas de invitados mediante la CLI de Google Cloud o REST .

Antes de comenzar

• Revise las cuotas de configuración del sistema operativo .
• 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:

  gcloud

  1. 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.

  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 la CLI de 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.

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

Actualización de políticas para huéspedes

Para actualizar una política de invitados, complete los siguientes pasos:

1. Actualice el archivo YAML o JSON.
2. Ejecute un comando de actualización o parche. El proceso de actualización es similar al proceso de creación con la adición de soporte para etiquetas electrónicas que permiten el control de la concurrencia 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
}

Describir una política para huéspedes

gcloud beta compute os-config guest-policies describe POLICY_ID

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

Listar políticas de invitados

gcloud beta compute os-config guest-policies list

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

Eliminar políticas de invitados

Cuando el agente de configuración del sistema operativo detecta que se activa la eliminación de una política de invitado, se mantiene el estado actual del sistema, pero no se realiza ningún mantenimiento adicional de la configuración. Por ejemplo, supongamos que tiene configurada una política de invitado package-update-zone2b que instala un paquete my-package en todas las máquinas virtuales en la zona us-west2-b y mantiene el paquete UPDATED .

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

• Todas las máquinas virtuales en us-west2-b que tienen my-package instalado mantienen my-package instalado. No hay reversión del estado actual del sistema.

• En todas las ejecuciones futuras del agente de configuración del sistema operativo, después de la eliminación de la política, ocurre lo siguiente:

  • Si se agrega una nueva VM a us-west2-b , my-package no está instalado en esta nueva VM.
  • En los casos en los que my-package está 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

Ver configuraciones para 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

Solución de problemas

Inspeccionar las políticas de huéspedes

Puede utilizar la consola de Google Cloud o la CLI de Google Cloud para inspeccionar las políticas de invitados asociadas con su proyecto.

Inspeccionar las políticas de invitados para una VM específica

Puede ejecutar el comando lookup para una máquina virtual determinada para ver qué configuraciones se aplican a esa máquina virtual.

En los casos en los que una VM no parece estar aplicando los requisitos de la política de invitado esperada, es ú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.

Utilice el comando os-config guest-policies lookup para enumerar las políticas de invitado que podrían estar dirigidas a una máquina virtual en particular. Reemplace VM_NAME con el nombre de la VM a inspeccionar.

gcloud beta compute os-config guest-policies lookup VM_NAME

Para obtener más información, consulte Visualización de configuraciones para una instancia de VM .

El resultado del comando podría revelar que la VM en realidad no está incluida en las propiedades de asignación de VM de la política de invitado. Por ejemplo, es posible que no aparezca en la lista de Labels o en la lista de prefijos de nombres de VM.

Recuperarse del fracaso

No se vuelve a intentar una instalación de receta de software fallida. Esto se debe a que el sistema no conoce el estado en el que la receta de software fallida dejó las cosas.

Al depurar recetas de software fallidas, recomendamos los siguientes pasos:

1. Cambie el nombre de la receta del software.
2. Elimine y vuelva a crear la política de invitados utilizando la receta de software renombrada.

Para conocer más pasos de solución de problemas, consulte Solución de problemas de VM Manager .

¿Qué sigue?

• Obtenga más información sobre las políticas de invitados del sistema operativo (heredado) .
• Establecer una política de invitados .