Consulta los detalles y el estado de las extensiones en una VM

Usa los métodos de solo lectura de estado de extensión list y get para ver el estado del entorno de ejecución de las extensiones instaladas en cada instancia de VM sin conectarte a cada máquina. Cuando usas políticas de extensiones, una VM puede tener varias extensiones instaladas por diferentes políticas. Los métodos de estado de la extensión te permiten ver la configuración final vigente y la política que rige para cada extensión instalada, y te ayudan a solucionar problemas cuando se instala una extensión inesperada o una extensión falla en una instancia.

Acerca de los detalles de las extensiones y la información de estado

Para instalar extensiones de VM en las VMs, crea políticas de extensión globales o zonales a nivel de la organización, la carpeta o el proyecto. Una sola política puede instalar varias extensiones en una sola VM, y se pueden aplicar varias políticas en tu jerarquía de recursos a la misma VM.

Los métodos de estado de extensión de solo lectura te permiten enumerar los estados de todas las extensiones en la VM para ver la configuración final efectiva y el estado del entorno de ejecución de cada extensión instalada. La información que se muestra incluye la versión activa, el estado de aplicación de políticas, el estado y el identificador de la política que rige cada extensión.

Ver las extensiones y versiones de VM

Puedes usar Google Cloud CLI o la API de Compute Engine para ver los detalles sobre las extensiones de VM instaladas. En este documento, se describe cómo usar gcloud. Para obtener información sobre cómo usar la API de Compute Engine para ver los estados de las extensiones, consulta Visualiza los estados de las extensiones de MV en una instancia.

Permisos de IAM necesarios para ver los detalles de la extensión

Para ver los roles necesarios para consultar información sobre las extensiones instaladas y sus versiones desde el nivel de proyecto, carpeta u organización, selecciona uno de los niveles:

Proyecto

Para obtener los permisos que necesitas para ver las políticas de extensión de VM zonales o globales a nivel del proyecto, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VMs de Compute (roles/compute.vmExtensionPolicyViewer) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión de VM zonales o globales a nivel del proyecto. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensión de VM zonales o globales a nivel de proyecto:

  • Describe una extensión de VM específica en una instancia: compute.vmExtensions.get
  • Enumera todas las extensiones de VM en una instancia: compute.vmExtensions.list

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Carpeta

Las políticas de extensión a nivel de la carpeta están disponibles en versión preliminar.

Para obtener los permisos que necesitas para ver las políticas de extensión de VM zonales o globales a nivel de la carpeta, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VMs de Compute a nivel de la carpeta (roles/compute.folderVmExtensionPolicyViewer) en tu carpeta. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión de VM globales o zonales a nivel de la carpeta. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensión de VM zonales o globales a nivel de la carpeta:

  • Describe una extensión de VM específica en una instancia: compute.folderVmExtensions.get
  • Enumera todas las extensiones de VM en una instancia: compute.folderVmExtensions.list

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Organización

Las políticas de extensión a nivel de la organización están disponibles en versión preliminar.

Para obtener los permisos que necesitas para ver las políticas de extensión de VM zonales o globales a nivel de la organización, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de políticas de extensión de VMs de Compute a nivel de la organización (roles/compute.orgVmExtensionPolicyViewer) en tu organización. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver las políticas de extensión de VM zonales o globales a nivel de la organización. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver las políticas de extensión de VM zonales o globales a nivel de la organización:

  • Describe una extensión de VM específica en una instancia: compute.orgVmExtensions.get
  • Enumera todas las extensiones de VM en una instancia: compute.orgVmExtensions.list

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Para obtener más información sobre los roles y permisos de IAM en Compute Engine, consulta Roles y permisos de Compute Engine.

Enumera las extensiones y versiones de VM

Para enumerar las extensiones y versiones de VM que administra el Gestor de extensiones de VM en todas las zonas o de forma global en tu proyecto, carpeta u organización, selecciona una de las siguientes opciones:

Zonal

Usa el comando gcloud preview compute zone-vm-extension-policies extensions list para enumerar las extensiones de VM en una zona dentro de tu proyecto, carpeta u organización:

Nivel del proyecto

gcloud preview compute zone-vm-extension-policies extensions list \
  --project=PROJECT_ID \
  --zone=ZONE

Reemplaza las siguientes variables en el comando:

  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.
Niveles de carpeta y organización

Para realizar la tarea anterior a nivel de carpeta o de organización, usa el mismo comando con uno de los siguientes cambios:

  • Para obtener información a nivel de la carpeta, reemplaza la opción --project=PROJECT_ID por --folder=folders/FOLDER_ID, en la que FOLDER_ID es el ID numérico de tu carpeta.
  • Para obtener información a nivel de la organización, reemplaza la opción --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, en la que ORGANIZATION_ID es el ID numérico de tu organización.

Global

Usa el comando gcloud preview compute global-vm-extension-policies extensions list para enumerar las extensiones de VM en todas las zonas de tu proyecto, carpeta u organización:

Nivel del proyecto

gcloud preview compute global-vm-extension-policies extensions list \
  --project=PROJECT_ID

Reemplaza la siguiente variable en el comando:

  • PROJECT_ID: Es el identificador del proyecto.
Niveles de carpeta y organización

Para realizar la tarea anterior a nivel de carpeta o de organización, usa el mismo comando con uno de los siguientes cambios:

  • Para obtener información a nivel de la carpeta, reemplaza la opción --project=PROJECT_ID por --folder=folders/FOLDER_ID, en la que FOLDER_ID es el ID numérico de tu carpeta.
  • Para obtener información a nivel de la organización, reemplaza la opción --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, en la que ORGANIZATION_ID es el ID numérico de tu organización.

Consulta información sobre una extensión de VM específica

Para ver los detalles de una extensión de VM específica en una sola zona o de forma global en tu proyecto, carpeta u organización, selecciona una de las siguientes opciones:

Zonal

Usa el comando gcloud preview compute zone-vm-extension-policies extensions describe para ver los detalles de una extensión de VM específica en una zona dentro de tu proyecto, carpeta u organización:

Nivel del proyecto

gcloud preview compute zone-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID \
  --zone=ZONE

Reemplaza las siguientes variables en el comando:

  • EXTENSION_NAME: Es una de las extensiones compatibles con el Gestor de extensiones de VM, por ejemplo, ops-agent.
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona de destino, por ejemplo, us-central1-f.
Niveles de carpeta y organización

Para realizar la tarea anterior a nivel de carpeta o de organización, usa el mismo comando con uno de los siguientes cambios:

  • Para obtener información a nivel de la carpeta, reemplaza la opción --project=PROJECT_ID por --folder=folders/FOLDER_ID, en la que FOLDER_ID es el ID numérico de tu carpeta.
  • Para obtener información a nivel de la organización, reemplaza la opción --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, en la que ORGANIZATION_ID es el ID numérico de tu organización.

Global

Usa el comando gcloud preview compute global-vm-extension-policies extensions describe para ver los detalles de una extensión de VM específica en todas las zonas de tu proyecto, carpeta u organización:

Nivel del proyecto

gcloud preview compute global-vm-extension-policies extensions describe EXTENSION_NAME \
  --project=PROJECT_ID

Reemplaza las siguientes variables en el comando:

  • EXTENSION_NAME: Es una de las extensiones compatibles con el Gestor de extensiones de VM, por ejemplo, ops-agent.
  • PROJECT_ID: Es el identificador del proyecto.
Niveles de carpeta y organización

Para realizar la tarea anterior a nivel de carpeta o de organización, usa el mismo comando con uno de los siguientes cambios:

  • Para obtener información a nivel de la carpeta, reemplaza la opción --project=PROJECT_ID por --folder=folders/FOLDER_ID, en la que FOLDER_ID es el ID numérico de tu carpeta.
  • Para obtener información a nivel de la organización, reemplaza la opción --project=PROJECT_ID por --organization=organizations/ORGANIZATION_ID, en la que ORGANIZATION_ID es el ID numérico de tu organización.

Visualiza los estados de las extensiones de VM en una instancia

Las políticas de extensión pueden instalar varias extensiones en una sola VM. Para determinar el estado de cada extensión, incluida su configuración vigente, el estado del entorno de ejecución y otra información, puedes examinar el estado de las extensiones en una VM específica.

Los métodos de estado de la extensión solo devuelven información sobre las instancias del Agente de operaciones que se instalan y administran con las políticas del Gestor de extensiones de VM. Si algunas VMs ejecutan agentes que se instalaron por otros medios, no hay información de extensión para informar sobre esos agentes.

Puedes usar Google Cloud CLI o la API de Compute Engine para ver el estado de las extensiones instaladas en las VMs. En este documento, se describe cómo usar gcloud. Para obtener información sobre cómo usar la API de Compute Engine para ver los estados de las extensiones, consulta Visualiza los estados de las extensiones de MV en una instancia.

Permisos de IAM necesarios para ver el estado de la extensión

Para obtener los permisos que necesitas para ver los estados de las extensiones de VM en una instancia, pídele a tu administrador que te otorgue el rol de IAM de Visualizador de Compute (roles/compute.viewer) en tu proyecto. Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

Este rol predefinido contiene los permisos necesarios para ver los estados de las extensiones de VM en una instancia. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:

Permisos necesarios

Se requieren los siguientes permisos para ver los estados de las extensiones de VM en una instancia:

  • Enumera los estados de todas las extensiones de VM en una instancia: compute.instances.listVmExtensionStates
  • Obtén el estado de una extensión de VM específica en una instancia: compute.instances.getVmExtensionState

También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.

Enumera las extensiones instaladas en una instancia de VM

Para enumerar todas las extensiones de VM instaladas en una instancia y ver sus estados actuales con gcloud, ejecuta el comando gcloud beta compute instances list-vm-extension-states:

gcloud beta compute instances list-vm-extension-states INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE

Reemplaza las siguientes variables en el comando:

  • INSTANCE_NAME: El nombre de la instancia de VM
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona en la que reside la instancia, por ejemplo, us-central1-f.

El comando devuelve el nombre, el estado de aplicación de políticas y el estado de cada extensión instalada. Para obtener información sobre los valores que se muestran cuando se ven los estados de las extensiones, consulta Interpreta los campos de estado de las extensiones de VM.

Para obtener más información sobre cómo ver los datos del estado de las extensiones en tus VMs, incluida la información sobre el uso de la API de Compute Engine, consulta Visualiza los estados de las extensiones de VM en una instancia.

Consulta el estado de una extensión de VM específica en una instancia

Para obtener información de estado sobre una extensión de VM específica instalada en una VM con gcloud, ejecuta el comando gcloud beta compute instances get-vm-extension-state:

gcloud beta compute instances get-vm-extension-state INSTANCE_NAME \
    --project=PROJECT_ID \
    --zone=ZONE \
    --extension-name=EXTENSION_NAME

Reemplaza las siguientes variables en el comando:

  • INSTANCE_NAME: El nombre de la instancia de VM
  • PROJECT_ID: Es el identificador del proyecto.
  • ZONE: Es la zona en la que reside la instancia, por ejemplo, us-central1-f.
  • EXTENSION_NAME: Es una de las extensiones compatibles con el Gestor de extensiones de VM, por ejemplo, ops-agent.

El comando devuelve el nombre de la extensión, la versión activa, la información de estado, la información de aplicación de políticas y el ID de la política que rige. Para obtener información sobre los valores que se muestran cuando se ven los estados de las extensiones, consulta Interpreta los campos de estado de las extensiones de VM.

Para obtener más información sobre cómo ver los datos del estado de las extensiones en tus VMs, incluida la información sobre el uso de la API de Compute Engine, consulta Visualiza los estados de las extensiones de VM en una instancia.

¿Qué sigue?