Installa Ops Agent durante la creazione della VM

Questo documento descrive come la console Google Cloud può installare automaticamente l'Ops Agent per te quando crei un'istanza VM. Durante il processo di installazione, il VM Manager di Compute Engine crea un criterio del sistema operativo Ops Agent che installa l'agente e lo reinstalla quando necessario. VM Manager ti aiuta a eseguire Ops Agent sulla tua VM e garantisce che l'agente sia sempre installato.

Panoramica

VM Manager utilizza i criteri di configurazione del sistema operativo per gestire l'installazione di Ops Agent. Un criterio di configurazione viene applicato a una VM utilizzando una mappatura chiamata ID assegnazione, simile all'esempio seguente:

goog-ops-agent-v2-x86-template-1-0-0-ZONE

Un ID assegnazione per un criterio del sistema operativo Ops Agent è costituito dai seguenti componenti:

  • Il nome del criterio: "goog-ops-agent"
  • Modello per la creazione del criterio: "v2-x86-template"
  • Una stringa di versione per il modello. La versione, che potrebbe cambiare nel tempo, è un valore come "1-0-0".
  • La zona a cui si applica l'ID assegnazione, un valore come "us-central1-a".

Una VM viene associata a un ID assegnazione utilizzando le etichette sull'istanza VM. Una VM di Compute Engine è una risorsa monitorata di tipo gce_instance e include un'etichetta zone. Quando utilizzi la console Google Cloud per creare una VM con Ops Agent installato, VM Manager aggiunge alla VM un'altra etichetta, simile a goog-ops-agent-policy:v2-x86-template-1-0-0. Questa etichetta identifica il criterio, il modello e la versione:

  • Chiave di etichetta, identificatore del criterio: goog-ops-agent-policy
  • Valore dell'etichetta, modello di criterio e versione: v2-x86-template-1-0-0

Quando crei una VM nella console Google Cloud, puoi selezionare la casella di controllo Installa Ops Agent per il monitoraggio e il logging. Quando fai clic su Crea, VM Manager assegna alla VM un'etichetta goog-ops-agent-policy:v2-x86-template-1-0-0 e installa Ops Agent. Se la VM è la prima VM nella sua zona, VM Manager crea anche un criterio del sistema operativo Ops Agent e un'assegnazione del criterio del sistema operativo di Ops Agent per quella zona.

Mentre una zona ha un'assegnazione dei criteri del sistema operativo di Ops Agent, il criterio del sistema operativo di Ops Agent monitora le VM che hanno le seguenti caratteristiche:

  • La VM ha l'etichetta goog-ops-agent-policy:v2-x86-template-1-0-0.
  • La VM si trova nella stessa zona dell'assegnazione dei criteri del sistema operativo di Ops Agent.

Il criterio del sistema operativo di Ops Agent controlla ogni ora se nelle VM coperte è installato Ops Agent. Se Ops Agent non è installato, il criterio del sistema operativo di Ops Agent installa la versione più recente dell'agente.

Crea una VM con l'installazione automatica di Ops Agent

Per installare automaticamente Ops Agent durante la creazione della VM e applicare l'assegnazione dei criteri del sistema operativo di Ops Agent alla VM:

  1. Concedi i ruoli al tuo Account Google. Esegui questo comando una volta per ciascuno dei seguenti ruoli IAM: roles/osconfig.osPolicyAssignmentEditor

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:EMAIL_ADDRESS" --role=ROLE
    • Sostituisci PROJECT_ID con l'ID progetto.
    • Sostituisci EMAIL_ADDRESS con il tuo indirizzo email.
    • Sostituisci ROLE con ogni singolo ruolo.
  2. Segui i passaggi descritti in Creare un'istanza VM da un'immagine pubblica. Prima di fare clic su Crea, seleziona la casella di controllo Installa Ops Agent per il monitoraggio e il logging:

    La casella di controllo Installa Ops Agent per il monitoraggio e il logging.

  3. Fai clic su Crea.

    Quando installi Ops Agent automaticamente per la prima volta in una zona, se non è abilitato VM Manager per il tuo progetto Google Cloud, il processo di creazione delle VM esegue le seguenti operazioni:

    1. Consente a VM Manager di operare in modalità con restrizioni.
    2. Crea il criterio del sistema operativo Ops Agent e un'assegnazione dei criteri del sistema operativo di Ops Agent per la zona. Il criterio del sistema operativo di Ops Agent è un campo dell'assegnazione dei criteri.
    3. Abilita OS Patch, configurazione del sistema operativo e gestione dell'inventario del sistema operativo impostando l'etichetta metadati VM enable-osconfig su TRUE.
    4. Crea la VM e le assegna l'etichetta del criterio del sistema operativo di Ops Agent.

    Se crei una VM e installi automaticamente Ops Agent in una zona in cui esiste già l'assegnazione dei criteri del sistema operativo di Ops Agent, il processo di creazione della VM crea la VM e le assegna l'etichetta del criterio del sistema operativo di Ops Agent.

Esempio

Il tuo progetto Google Cloud non ha assegnazioni dei criteri del sistema operativo di Ops Agent. Crei due VM, instance-1 e instance-2 nella zona us-central1-a. Quindi, creerai instance-3 e instance-4 nella zona us-east1-b. Per instance-1, instance-2 ed instance-3 è stata selezionata la casella di controllo Installa Ops Agent per il monitoraggio e il logging durante la creazione.

  • Quando crei instance-1, VM Manager crea un criterio del sistema operativo Ops Agent per la zona us-central1-a e l'assegnazione dei criteri del sistema operativo con l'ID goog-ops-agent-v2-x86-template-1-0-0-us-central1-a. VM Manager imposta quindi l'etichetta del criterio su instance-1.
  • Quando crei instance-2, VM Manager imposta la stessa etichetta del criterio su instance-2.
  • Quando crei instance-3, VM Manager crea un criterio di sistema operativo Ops Agent per la zona us-east1-b e un'assegnazione dei criteri del sistema operativo con l'ID goog-ops-agent-v2-x86-template-1-0-0-us-east1-b. VM Manager assegna quindi l'etichetta del criterio a instance-3.

I criteri del sistema operativo di Ops Agent coprono quindi le seguenti VM in base agli ID di assegnazione dei criteri del sistema operativo di Ops Agent:

ID assegnazione criteri di sistema operativo Copre le VM in: VM coperte
goog-ops-agent-v2-x86-template-1-0-0-us-central1-a us-central1-a instance-1, instance-2
goog-ops-agent-v2-x86-template-1-0-0-us-east1-b us-east1-b instance-3

Per impostazione predefinita, instance-4 non è coperto perché non hai selezionato Installa Ops Agent per il monitoraggio e il logging, quindi non ha l'etichetta goog-ops-agent-policy:v2-x86-template-1-0-0. Se vuoi applicare anche il criterio del sistema operativo di Ops Agent a instance-4, consulta Aggiungere la copertura dei criteri del sistema operativo di Ops Agent a una VM esistente.

Gestisci le versioni di Ops Agent sulle VM coperte dal criterio del sistema operativo di Ops Agent

Il criterio del sistema operativo di Ops Agent non aggiorna Ops Agent quando vengono rilasciate nuove versioni dell'agente. Se nella VM è installata una versione di Ops Agent, il criterio non produce alcun effetto. Se disinstalli Ops Agent, il criterio rileva che Ops Agent non è installato e installa la versione più recente.

Per eseguire l'upgrade della VM alla versione più recente di Ops Agent, disinstalla la versione attualmente in esecuzione e consenti al criterio del sistema operativo di Ops Agent di installare la versione più recente.

Se devi installare una versione precedente di Ops Agent, puoi disinstallare Ops Agent sulle VM coperte dal criterio del sistema operativo di Ops Agent e poi installare una versione specifica dell'agente.

Risoluzione dei problemi

Per informazioni sulla risoluzione dei problemi di installazione dell'agente e sui criteri del sistema operativo di Ops Agent, consulta Gestione delle VM coperte dal criterio del sistema operativo di Ops Agent e Strumento di diagnostica degli agenti per i criteri di installazione automatica.

Prezzi

I criteri del sistema operativo sono strumenti generici per l'installazione dei pacchetti. Per impostazione predefinita, quando VM Manager è abilitato perché hai creato una VM con Ops Agent installato automaticamente, VM Manager viene abilitato in modalità limitata. Per informazioni sulle modalità e sui prezzi di VM Manager, consulta la pagina relativa ai prezzi di VM Manager.

Passaggi successivi

Per informazioni sulla gestione delle VM coperte dal criterio del sistema operativo di Ops Agent, consulta Gestire le VM coperte dal criterio del sistema operativo di Ops Agent.