Instalar o Agente de Operações durante a criação da VM
Mantenha tudo organizado com as coleções
Salve e categorize o conteúdo com base nas suas preferências.
Neste documento, descrevemos como o console do Google Cloud pode instalar automaticamente o
agente de operações quando você cria uma instância de VM. Durante o processo de instalação, o VM Manager do Compute Engine cria uma política do SO do agente de operações que instala o agente e o reinstala quando necessário. O
VM Manager ajuda a executar o agente de operações na VM e garante
que ele esteja sempre instalado.
Visão geral
O VM Manager usa políticas do SO para gerenciar a instalação do Agente de operações. Uma política de configuração é aplicada a uma VM usando um mapeamento chamado ID de atribuição, que tem a seguinte aparência:
goog-ops-agent-v2-x86-template-1-0-0-ZONE
Um ID de atribuição para uma política do SO de agente de operações consiste nos seguintes componentes:
O nome da política: "goog-ops-agent"
Um modelo para criar a política: "v2-x86-template"
Uma string de versão do modelo. A versão, que pode mudar com o tempo, é um valor como "1-0-0".
A zona em que o código de atribuição é aplicado, um valor como "us-central1-a".
Uma VM é associada a um ID de atribuição por meio dos rótulos na instância de VM.
Uma VM do Compute Engine é um recurso monitorado do tipo gce_instance e inclui um rótulo zone. Quando você usa o console Google Cloud para
criar uma VM com o agente de operações instalado, o VM Manager adiciona outro
rótulo à VM, semelhante a goog-ops-agent-policy:v2-x86-template-1-0-0. Esse rótulo identifica a política, o modelo e a versão:
Chave de rótulo, o identificador da política: goog-ops-agent-policy
Valor do rótulo, modelo da política e versão: v2-x86-template-1-0-0
Ao criar uma VM no console Google Cloud , é possível marcar a caixa de seleção Instalar o Agente de operações para Monitoring e Logging. Quando você clica em Criar, o VM Manager atribui à VM um rótulo de goog-ops-agent-policy:v2-x86-template-1-0-0 e instala o agente de operações. Se a VM for a primeira VM da zona, o VM Manager também criará uma política de SO de agente de operações e uma atribuição de política de SO de agente de operações para essa zona.
Enquanto uma zona tiver uma atribuição de política do SO de agente de operações, ela monitora VMs com as seguintes características:
A VM tem o rótulo goog-ops-agent-policy:v2-x86-template-1-0-0.
A VM está na mesma zona que a atribuição de política do SO do agente de operações.
A política do SO do agente de operações verifica a cada hora se as VMs cobertas têm o agente de operações instalado. Se o agente de operações não estiver instalado, a política do SO de agente de operações instalará a versão mais recente do agente.
Criar uma VM com a instalação automática do agente de operações
Para instalar o agente de operações automaticamente durante a criação da VM e aplicar a atribuição de política do SO de agente de operações à VM, faça o seguinte:
Grant roles to your user account. Run the following command once for each of the following
IAM roles:
roles/osconfig.osPolicyAssignmentEditor
Quando você instala o agente de operações automaticamente pela primeira vez em uma zona, se o VM Manager não estiver ativado para o projeto Google Cloud , o processo de criação de VM fará o seguinte:
Cria a política de SO de agente de operações e uma atribuição de política de SO de agente de operações para a zona. A política do SO do agente de operações é um campo da atribuição de política.
Ativa o patch, as políticas do SO e o gerenciamento de inventário do SO configurando o rótulo de metadados da VM enable-osconfig como TRUE.
Cria a VM e atribui a ela o rótulo de política do SO do agente de operações.
Se você criar uma VM e instalar automaticamente o agente de operações em uma zona em que uma atribuição de política de SO de agente de operações já existir, o processo de criação de VM criará a VM e atribuirá a ela o rótulo de política do SO de agente de operações.
Exemplo
Seu projeto Google Cloud não tem atribuições de política do SO do
agente de operações. Você cria duas VMs, instance-1 e instance-2, na zona us-central1-a. Em seguida, crie instance-3 e instance-4 na zonaus-east1-b. instance-1, instance-2 e instance-3 teve a caixa de seleção Instalar o agente de operações para monitoramento e geração de registros marcada durante a criação.
Quando você cria a instance-1, o VM Manager cria uma política de SO do agente de operações para a zona us-central1-a e uma atribuição de política do SO com o ID goog-ops-agent-v2-x86-template-1-0-0-us-central1-a.
Em seguida, o VM Manager define o rótulo da política na instance-1.
Quando você cria instance-2, o VM Manager define o mesmo rótulo de política em instance-2.
Quando você cria a instance-3, o VM Manager cria uma política de SO do agente de operações para a zona us-east1-b e uma atribuição de política do SO com o ID goog-ops-agent-v2-x86-template-1-0-0-us-east1-b. Em seguida, o VM Manager atribui o rótulo da política a instance-3.
Em seguida, as políticas do SO de agente de operações abrangem as seguintes VMs com base nos IDs de atribuição de política do SO de agente de operações:
Por padrão, a instance-4 não é coberta porque você não selecionou Instalar agente de operações para o Monitoring e Logging. Portanto, ela não tem o rótulo goog-ops-agent-policy:v2-x86-template-1-0-0. Se você também quiser aplicar a política do SO do agente de operações à
instance-4, consulte
Adicionar cobertura da política do SO do agente de operações a uma VM atual.
Gerenciar as versões do agente de operações nas VMs cobertas pela política de SO do agente de operações
A política do SO de agente de operações não atualiza o agente quando novas versões do agente são lançadas. Enquanto a VM tiver alguma versão do agente de operações instalada, a política não terá efeito. Se você desinstalar o agente de operações, a política detectará que ele não está instalado e instalará a versão mais recente.
Para fazer upgrade da VM para a versão mais recente do agente de operações, desinstale a versão em execução e permita que a política de SO do agente de operações instale a versão mais recente.
As políticas do SO são ferramentas genéricas para instalar pacotes. Por padrão, quando o VM Manager é ativado porque você criou uma VM com o Agente de operações instalado automaticamente, o VM Manager é ativado no modo limitado.
Para mais informações sobre os modos e preços do VM Manager, consulte Preços do VM Manager.
[[["Fácil de entender","easyToUnderstand","thumb-up"],["Meu problema foi resolvido","solvedMyProblem","thumb-up"],["Outro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Informações incorretas ou exemplo de código","incorrectInformationOrSampleCode","thumb-down"],["Não contém as informações/amostras de que eu preciso","missingTheInformationSamplesINeed","thumb-down"],["Problema na tradução","translationIssue","thumb-down"],["Outro","otherDown","thumb-down"]],["Última atualização 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)."]]