Gestionar políticas de invitados (versión antigua)

Precaución: Esta página incluye instrucciones sobre las políticas de SO invitado antiguas. Una versión posterior de la gestión de la configuración del SO ya está disponible para todos los usuarios. Para usar la versión GA posterior, consulta Gestionar políticas de SO.

Para ver una comparación de las dos versiones, consulta Comparar las versiones de Gestión de configuración del SO.

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

• Actualizar políticas de invitados: modifica las configuraciones de tus políticas de invitados.
• Describe guest policies: obtén información sobre una política de invitado específica.
• List guest policies: view a list of guest policies in a project.
• Eliminar un invitado: elimina una política de invitado específica.
• Ver las configuraciones de una instancia de VM: consulta las configuraciones que se aplican a una instancia de VM.
• Depurar una política de invitado: soluciona los problemas de una política de invitado.

Como el agente de configuración del SO se ejecuta cada 10-15 minutos, cuando configures una actualización o una eliminación de una política, tardará aproximadamente 10-15 minutos en aplicarse.

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

Beta

Esta función está sujetas a los "Términos de las Ofertas de Acceso Previo a la Disponibilidad General" de la sección Términos Generales de los Servicios de los Términos Específicos de los Servicios. Las funciones previas a la disponibilidad general están disponibles tal cual y pueden tener una compatibilidad y asistencia limitadas. Para obtener más información, consulta las descripciones de las fases de lanzamiento.

Antes de empezar

• Consulta las cuotas de OS Config.
• Si aún no lo has hecho, configura la autenticación. La autenticación verifica tu identidad para acceder a Google Cloud servicios y APIs. Para ejecutar código o ejemplos 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. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:

     gcloud init

     Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

     Nota: Si ya has instalado la CLI de gcloud, asegúrate de que tienes la versión más reciente ejecutando gcloud components update.
  2. Set a default region and zone.

  REST

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

  Instala Google Cloud CLI. Después de la instalación, inicializa la CLI de Google Cloud ejecutando el siguiente comando:

  gcloud init

  Si utilizas un proveedor de identidades (IdP) externo, primero debes iniciar sesión en la CLI de gcloud con tu identidad federada.

  Nota: Si ya has instalado la CLI de gcloud, asegúrate de que tienes la versión más reciente ejecutando gcloud components update.

  Para obtener más información, consulta el artículo Autenticarse para usar REST de la documentación sobre autenticación de Google Cloud .

Actualizar políticas de invitados

Para actualizar una política de huéspedes, sigue estos pasos:

1. Actualiza el archivo YAML o JSON.
2. Ejecuta un comando de actualización o de parche. El proceso de actualización es similar al proceso de creación, pero con la adición de la compatibilidad con etags, que permiten controlar la simultaneidad y la coherencia.

gcloud

Usa el comando os-config guest-policies update para actualizar una política de invitado.

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

Haz los cambios siguientes:

• POLICY_ID: el nombre de la política de invitado que quieras actualizar.
• FILE: el archivo JSON o YAML que contiene las especificaciones de la política de invitado actualizada.

REST

En la API, crea una solicitud PATCH al método projects.guestPolicies.patch.

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

{
  For more information, see Guest policy JSON
}

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto.
• POLICY_ID: el nombre de tu política de invitado.

Describir una política de invitado

gcloud

Para ver los detalles de una política de invitado, usa el comando os-config guest-policies describe. Sustituye POLICY_ID por el nombre de la política de invitado que quieras describir.

gcloud beta compute os-config guest-policies describe POLICY_ID

REST

En la API, crea una solicitud GET al método projects.guestPolicies.get.

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

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto.
• POLICY_ID: el nombre de tu política de invitado.

Mostrar políticas de invitados

gcloud

Para ver una lista de las políticas de invitado de tu proyecto, usa el comando os-config guest-policies list.

gcloud beta compute os-config guest-policies list

REST

En la API, crea una solicitud GET al método projects.guestPolicies.list. Sustituye PROJECT_ID por el ID de tu proyecto.

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

Eliminar políticas de invitados

Cuando el agente de configuración del SO detecta que se ha activado la eliminación de una política de invitado, se mantiene el estado actual del sistema, pero no se realiza ningún otro mantenimiento de la configuración. Por ejemplo, supongamos que tienes una política de invitado package-update-zone2b configurada para instalar un paquete my-package en todas las VMs de la zona us-west2-b y mantener el paquete UPDATED.

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

• Todas las VMs de us-west2-b que tengan my-package instalado mantendrán my-package instalado. No se revierte el estado actual del sistema.

• En todas las ejecuciones futuras del agente de configuración del SO, después de eliminar la política, se producirá lo siguiente:

  • Si se añade una nueva VM a us-west2-b,my-package no se instala en esta nueva VM.
  • En las instancias en las que esté instalado my-package, el paquete no se actualizará.

gcloud

Para eliminar una política de invitado, usa el comando os-config guest-policies delete. Sustituye POLICY_ID por el nombre de la política de invitado que quieras eliminar.

gcloud beta compute os-config guest-policies delete POLICY_ID

REST

En la API, crea una solicitud DELETE al método projects.guestPolicies.delete.

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

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto.
• POLICY_ID: el nombre de tu política de invitado.

Ver las configuraciones de una instancia de VM

gcloud

Para ver las políticas que se aplican a una sola instancia de VM, usa el comando os-config guest-policies lookup.

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

Haz los cambios siguientes:

• VM_NAME: el nombre de la instancia de VM.
• ZONE: la zona de la instancia de VM.

REST

Para ver las políticas que se aplican a una sola instancia de VM, usa la siguiente solicitud POST.

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

Haz los cambios siguientes:

• PROJECT_ID: tu ID de proyecto.
• ZONE: la zona de la instancia de VM.
• VM_NAME: el nombre de tu instancia de VM.

Solución de problemas

Inspeccionar políticas de invitados

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

Consola

1. En la Google Cloud consola, ve a la página Políticas de SO invitado.

   Ir a la página Políticas de SO invitado

2. Selecciona la política de invitado que quieras inspeccionar y, a continuación, haz clic en VER DETALLES.

gcloud

1. Usa el comando os-config guest-policies list para ver todas tus políticas de invitado.

   gcloud beta compute os-config guest-policies list
   

2. En la lista de políticas de invitado, copia los IDs de las políticas de invitado que quieras inspeccionar y, a continuación, ejecuta el comando para inspeccionar cada una de ellas. Sustituye POLICY_ID por el ID de la política que quieras revisar.

   gcloud beta compute os-config guest-policies describe POLICY_ID
   

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

Puedes ejecutar el comando lookup en una VM para ver qué configuraciones se aplican a esa VM.

En los casos en los que una VM no parece aplicar 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 de la política de invitado coincide con esta VM concreta.

Usa el comando os-config guest-policies lookup para ver una lista de las políticas de invitado que pueden estar orientadas a una VM concreta. Sustituye VM_NAME por el nombre de la VM que quieras inspeccionar.

gcloud beta compute os-config guest-policies lookup VM_NAME

Para obtener más información, consulta Ver las configuraciones de una instancia de VM.

La salida del comando puede revelar que la VM no está orientada a 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 nombres de VM.

Recuperación tras un fallo

No se vuelve a intentar instalar una receta de software que ha fallado. Esto se debe a que el sistema no sabe en qué estado ha dejado las cosas la receta de software que ha fallado.

Cuando depures recetas de software que no funcionan, te recomendamos que sigas estos pasos:

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

Para obtener más pasos para solucionar problemas, consulta Solucionar problemas de VM Manager.

Siguientes pasos

• Consulta más información sobre las políticas de invitados del SO (versión antigua).
• Configura una política de invitados.