Instalar el Agente de Ops durante la creación de VMs
Organiza tus páginas con colecciones
Guarda y categoriza el contenido según tus preferencias.
En este documento, se describe cómo la consola de Google Cloud puede instalar automáticamente el
Agente de operaciones cuando creas una instancia de VM. Durante el proceso de
instalación, la herramienta VM Manager de Compute Engine crea una
política del SO del Agente de operaciones
que instala el agente y lo reinstala cuando es necesario. VM Manager
ayuda a ejecutar el Agente de operaciones en las VMs y se asegura
de que permanezca instalado.
Descripción general
VM Manager usa políticas del SO para administrar la instalación del Agente de operaciones. Una política de configuración se aplica a una VM mediante una asignación llamada ID de asignación, que tiene el siguiente aspecto:
goog-ops-agent-v2-x86-template-1-0-0-ZONE
Un ID de asignación para una política del SO del Agente de operaciones consta de los siguientes
componentes:
El nombre de la política: "goog-ops-agent"
Una plantilla para crear la política: "v2-x86-template"
Es una cadena de versión para la plantilla. La versión, que puede cambiar con el tiempo, es un valor como "1-0-0".
La zona a la que se aplica el ID de la asignación, un valor como "us-central1-a".
Las VMs se asocian a los IDs de asignación mediante las etiquetas de las instancias de VM.
Las VMs de Compute Engine son recursos supervisados de tipo gce_instance
que incluyen una etiqueta zone. Cuando usas la consola de Google Cloud para
crear una VM con el Agente de operaciones instalado, VM Manager agrega otra
etiqueta a la VM, que es similar a goog-ops-agent-policy:v2-x86-template-1-0-0. Esta etiqueta identifica la
política, la plantilla y la versión:
Clave de la etiqueta, el identificador de la política: goog-ops-agent-policy
Valor de la etiqueta, la plantilla de política y la versión: v2-x86-template-1-0-0
Cuando creas una VM en la Google Cloud consola, puedes seleccionar la casilla de verificación
Instalar el Agente de operaciones para supervisión y registros. Cuando haces clic en
Crear, VM Manager le asigna a la VM una etiqueta de goog-ops-agent-policy:v2-x86-template-1-0-0 y,
luego, instala el Agente de operaciones. Cuando creas la primera VM de una zona,
VM Manager también crea una política del SO del Agente de operaciones y
una asignación de política del SO del Agente de operaciones para la zona.
Si bien una zona tiene una asignación de política del SO del agente de operaciones, la política del SO del agente de operaciones supervisa las VMs que tienen las siguientes características:
La VM tiene la etiqueta goog-ops-agent-policy:v2-x86-template-1-0-0.
La VM está en la misma zona que la asignación de política del SO del Agente de operaciones.
La política del SO del agente de operaciones verifica cada hora si las VMs cubiertas tienen instalado el agente de operaciones. Si el Agente de operaciones no está
instalado, la política del SO del Agente de operaciones instala la versión más reciente
del agente.
Crea una VM con la instalación automática del Agente de operaciones
Para instalar el Agente de operaciones automáticamente durante la creación de la VM y aplicarle la
asignación de política del SO del Agente de operaciones, sigue estos pasos:
Grant roles to your user account. Run the following command once for each of the following
IAM roles:
roles/osconfig.osPolicyAssignmentEditor
Cuando instalas el Agente de operaciones automáticamente por primera vez en una zona,
si no tienes VM Manager habilitado para tu proyecto de Google Cloud ,
el proceso de creación de VMs hace lo siguiente:
Crea la política del SO del Agente de operaciones y una asignación de política del SO del Agente de operaciones
para la zona. La política del SO del Agente de operaciones es un campo de la asignación de
política.
Habilita la administración de parches, políticas del SO y el inventario del SO configurando la etiqueta de metadatos de VM enable-osconfig en TRUE.
Crea la VM y asígnale la etiqueta de la política del SO del Agente de operaciones.
Si creas una VM y, luego, instalas automáticamente el Agente de operaciones en una zona
donde ya existe una asignación de política del SO del Agente de operaciones, el proceso de creación de VMs
crea la VM y le asigna la etiqueta de la política del SO del Agente de operaciones.
Ejemplo
Tu Google Cloud proyecto no tiene ninguna asignación de políticas del SO del Agente de operaciones. Debes crear dos VMs, instance-1 e instance-2 en la zona us-central1-a. Luego, crea instance-3 y, también, instance-4 en la zona us-east1-b. instance-1, instance-2 e instance-3 tenían la casilla de verificación Instala el Agente de operaciones para Monitoring y Logging seleccionada durante la creación.
Cuando creas instance-1, VM Manager crea una política del SO del Agente de operaciones
para la zona us-central1-a y una asignación de política del SO
con el ID goog-ops-agent-v2-x86-template-1-0-0-us-central1-a.
Luego, VM Manager establece la etiqueta de política en instance-1.
Cuando creas instance-2, VM Manager establece la
misma etiqueta de política en instance-2.
Cuando creas instance-3,
VM Manager crea una política del SO del Agente de operaciones para la zona us-east1-b
y una asignación de política del SO con el ID goog-ops-agent-v2-x86-template-1-0-0-us-east1-b. Luego, VM Manager
asigna la etiqueta de política a instance-3.
Luego, las políticas del SO del agente de operaciones abarcan las siguientes VMs según los IDs de asignación de política del SO del agente de operaciones:
De forma predeterminada, instancia-4 no se cubre porque no seleccionaste Instala el agente de operaciones para Monitoring y Logging, por lo que no tiene la etiqueta goog-ops-agent-policy:v2-x86-template-1-0-0. Si también quieres aplicar la política del SO del Agente de operaciones a
instance-4, consulta
Agrega cobertura de políticas del SO del Agente de operaciones a una VM existente.
Administra las versiones del Agente de operaciones en las VMs que cubre la política del SO del Agente de operaciones
La política del SO del Agente de operaciones no actualiza el Agente de operaciones cuando se lanzan versiones nuevas
del agente. Siempre que la VM tenga instalada alguna versión del Agente de operaciones,
la política no hará nada. Si desinstalas el Agente de operaciones, la
política detecta que no está instalado y, luego, instala la
versión más reciente.
Para actualizar la VM a la versión más reciente del Agente de operaciones, desinstala la
versión actual y permite que la política del SO del Agente de operaciones
instale la versión más reciente.
Las políticas del SO son herramientas genéricas para instalar paquetes. De forma predeterminada, cuando
VM Manager está habilitado porque creaste una VM con el Agente de operaciones
instalado automáticamente, VM Manager se habilita en modo limitado.
Para obtener información sobre los modos y los precios de VM Manager, consulta
Precios de VM Manager.
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2025-08-12 (UTC)"],[],[],null,["# Install the Ops Agent during VM creation\n\nThis document describes how the Google Cloud console can automatically install the\nOps Agent for you when you create a VM instance. During the installation\nprocess, the Compute Engine [VM Manager](/compute/docs/vm-manager) creates an\nOps Agent OS policy\nthat installs the agent and reinstalls it when necessary. The\nVM Manager helps you get the Ops Agent running on your VM and ensures\nthat the agent is always installed.\n\nOverview\n--------\n\nThe VM Manager uses OS policies to manage the Ops Agent\ninstallation. A configuration policy is applied to a VM by using a mapping\ncalled an *assignment ID*, which looks like the following example: \n\n```\ngoog-ops-agent-v2-x86-template-1-0-0-ZONE\n```\n\nAn assignment ID for an Ops Agent OS policy consists of the following\ncomponents:\n\n- The name of the policy: \"goog-ops-agent\"\n- A template for creating the policy: \"v2-x86-template\"\n- A version string for the template. The version, which might change over time, is a value like \"\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e\".\n- The zone to which the assignment ID applies, a value like \"us-central1-a\".\n\nA VM is associated with an assignment ID by using the labels on the VM instance.\nA Compute Engine VM is a monitored resource of type\n[`gce_instance`](/monitoring/api/resources#tag_gce_instance)\nand includes a `zone` label. When you use the Google Cloud console to\ncreate a VM with the Ops Agent installed, the VM Manager adds another\nlabel to the VM, which looks like `goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e. This label identifies the\npolicy, template, and version:\n\n- Label key, the identifier for the policy: `goog-ops-agent-policy`\n- Label value, the policy template and version: `v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e\n\nWhen you create a VM in the Google Cloud console, you can select the\n**Install Ops Agent for Monitoring and Logging** checkbox. When you click\n**Create** , VM Manager assigns the VM a label of `goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e and\ninstalls the Ops Agent. If the VM is the first VM in its zone, then\nVM Manager also creates an Ops Agent OS policy and an Ops Agent OS\npolicy assignment for that zone.\n\nWhile a zone has an Ops Agent OS policy assignment, the Ops Agent OS policy\nmonitors VMs that have the following characteristics:\n\n- The VM has the `goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e label.\n- The VM is in the same zone as the Ops Agent OS policy assignment.\n\nThe Ops Agent OS policy checks every hour whether its\ncovered VMs have the Ops Agent installed. If the Ops Agent isn't\ninstalled, then the Ops Agent OS policy installs the latest version\nof the agent.\n\nCreate a VM with automatic installation of the Ops Agent\n--------------------------------------------------------\n\nTo install the Ops Agent automatically during VM creation and apply the\nOps Agent OS policy assignment to the VM, do the following:\n\n1.\n Grant roles to your user account. Run the following command once for each of the following\n IAM roles:\n `roles/osconfig.osPolicyAssignmentEditor`\n\n ```bash\n gcloud projects add-iam-policy-binding PROJECT_ID --member=\"user:\u003cvar translate=\"no\"\u003eUSER_IDENTIFIER\u003c/var\u003e\" --role=ROLE\n ```\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003ePROJECT_ID\u003c/var\u003e: your project ID.\n - \u003cvar translate=\"no\"\u003eUSER_IDENTIFIER\u003c/var\u003e: the identifier for your user account---for example, `myemail@example.com`.\n - \u003cvar translate=\"no\"\u003eROLE\u003c/var\u003e: the IAM role that you grant to your user account.\n2. Follow the steps in [Create a VM instance from a public image](/compute/docs/instances/create-start-instance#publicimage). Before you click **Create** , select the **Install Ops Agent for Monitoring and Logging** checkbox:\n\n | **Note:** When you select the **Install Ops Agent for Monitoring and Logging** checkbox during VM creation, the examples on the tabs in the **Equivalent code** flyout are updated to include the steps for creating the Ops Agent OS policy. There is no REST equivalent for creating an Ops Agent OS policy.\n3. Click **Create** .\n\n When you install the Ops Agent automatically for the first time in a zone,\n if you don't have VM Manager enabled for your Google Cloud project,\n then the VM-creation process does the following:\n 1. Enables VM Manager to operate in [restricted mode](/compute/docs/vm-manager#pricing).\n 2. Creates the Ops Agent OS policy and an Ops Agent OS policy assignment for the zone. The Ops Agent OS policy is a field of the policy assignment.\n 3. Enables Patch, OS policies, and OS inventory management by setting the VM metadata label `enable-osconfig` to `TRUE`.\n 4. Creates the VM and assigns it the Ops Agent OS policy label.\n\n \u003cbr /\u003e\n\n If you create a VM and automatically install the Ops Agent in a zone\n where an Ops Agent OS policy assignment already exists, then the VM-creation\n process creates the VM and assigns it the Ops Agent OS policy label.\n\n \u003cbr /\u003e\n\n \u003cbr /\u003e\n\n\u003cbr /\u003e\n\nExample\n-------\n\nYour Google Cloud project doesn't have any Ops Agent OS\npolicy assignments. You create two VMs, *instance-1* and *instance-2* in the\n`us-central1-a` zone. You\nthen create *instance-3* and *instance-4* in the `us-east1-b` zone. *instance-1* , *instance-2* , and\n*instance-3* had the **Install Ops Agent for Monitoring and Logging** checkbox\nselected during creation.\n\n- When you create *instance-1* , VM Manager creates an Ops Agent OS policy for the `us-central1-a` zone and an OS policy assignment with the ID `goog-ops-agent-v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e`-us-central1-a`. VM Manager then sets the policy label on *instance-1*.\n- When you create *instance-2* , VM Manager sets the same policy label on *instance-2*.\n- When you create *instance-3* , VM Manager creates an Ops Agent OS policy for the `us-east1-b` zone and an OS policy assignment with the ID `goog-ops-agent-v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e`-us-east1-b`. VM Manager then assigns the policy label to *instance-3*.\n\nThe Ops Agent OS policies then cover the following VMs based on the\nOps Agent OS policy assignment IDs:\n\nBy default, *instance-4* isn't covered because you didn't select\n**Install Ops Agent for Monitoring and Logging** , so it doesn't have the\n`goog-ops-agent-policy:v2-x86-template-`\u003cvar translate=\"no\"\u003e1-0-0\u003c/var\u003e label. If you also want to apply the Ops Agent OS policy to\n*instance-4* , then see\n[Add Ops Agent OS policy coverage to an existing VM](/stackdriver/docs/solutions/agents/ops-agent/manage-policies-auto-install#add-coverage).\n\nManage Ops Agent versions on VMs covered by the Ops Agent OS policy\n-------------------------------------------------------------------\n\nThe Ops Agent OS policy doesn't update the Ops Agent when new versions of the\nagent are released. As long as the VM has some version of the Ops Agent\ninstalled, the policy does nothing. If you uninstall the Ops Agent, then the\npolicy detects that the Ops Agent isn't installed and then installs the latest\nversion.\n\nTo upgrade your VM to the latest version of the Ops Agent, uninstall the\nversion that you are currently running and let the Ops Agent OS policy\ninstall the latest version.\n\nIf you need to install a previous version of the Ops Agent, you can\n[uninstall the Ops Agent on VMs covered by the Ops Agent OS policy](/stackdriver/docs/solutions/agents/ops-agent/manage-policies-auto-install#uninstall)\nand then [install a specific version of the agent](/stackdriver/docs/solutions/agents/ops-agent/installation#install-specific-version).\n\nTroubleshooting\n---------------\n\nFor information about troubleshooting agent installation and Ops Agent OS\npolicies, see [Manage VMs covered by the Ops Agent OS policy](/stackdriver/docs/solutions/agents/ops-agent/manage-policies-auto-install)\nand\n[Agent diagnostics tool for automatic installation policies](/stackdriver/docs/solutions/agents/ops-agent/troubleshoot-find-info#agent_diagnostics_tool_for_automatic_installation_policies).\n\nPricing\n-------\n\nOS policies are generic tools for installing packages. By default, when\nVM Manager is enabled because you've created a VM with the Ops Agent\nautomatically installed, VM Manager is enabled in the limited mode.\nFor information about VM Manager modes and pricing, see\n[VM Manager Pricing](/compute/docs/vm-manager#pricing).\n\nWhat's next\n-----------\n\nFor information about managing VMs covered by the Ops Agent OS policy, see\n[Manage VMs covered by the Ops Agent OS policy](/stackdriver/docs/solutions/agents/ops-agent/manage-policies-auto-install)."]]
