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.
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_IDpor--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_IDpor--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.
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_IDpor--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_IDpor--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.
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_IDpor--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_IDpor--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.
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_IDpor--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_IDpor--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?
- Obtén más información para recuperar e interpretar la información del estado de la extensión en Consulta los detalles y el estado de la extensión.
- Soluciona problemas de las políticas de extensiones: