Installare l'Ops Agent durante la creazione della VM

Questo documento descrive in che modo la console Google Cloud può installare automaticamente Ops Agent quando crei un'istanza VM. Durante il processo di installazione, VM Manager di Compute Engine crea un criterio del sistema operativo Ops Agent che installa l'agente e lo reinstalla se 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, che è simile al seguente esempio:

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

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

  • Il nome del criterio: "goog-ops-agent"
  • Un 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, ad esempio "us-central1-a".

Una VM viene associata a un ID assegnazione utilizzando le etichette dell'istanza VM. Una VM 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 l'Ops Agent installato, VM Manager aggiunge un'altra etichetta alla VM, che ha il seguente aspetto: goog-ops-agent-policy:v2-x86-template-1-0-0. Questa etichetta identifica il criterio, il modello e la versione:

  • Chiave etichetta, l'identificatore del criterio: goog-ops-agent-policy
  • Valore dell'etichetta, modello e versione del criterio: 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 l'etichetta goog-ops-agent-policy:v2-x86-template-1-0-0 e installa Ops Agent. Se la VM è la prima VM nella zona, VM Manager crea anche un criterio OS Ops Agent e un'assegnazione del criterio OS Ops Agent per la zona.

Quando una zona ha un'assegnazione del criterio del sistema operativo di Ops Agent, il criterio del sistema operativo di Ops Agent monitora le VM con 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 le VM coperte sono state installate con 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 del criterio del sistema operativo di Ops Agent alla VM, svolgi i seguenti passaggi:

  1. Grant roles to your user account. Run the following command once for each of the following IAM roles: roles/osconfig.osPolicyAssignmentEditor

    gcloud projects add-iam-policy-binding PROJECT_ID --member="user:USER_IDENTIFIER" --role=ROLE
    • Replace PROJECT_ID with your project ID.
    • Replace USER_IDENTIFIER with the identifier for your user account. For example, user:myemail@example.com.

    • Replace ROLE with each individual role.
  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 hai attivato VM Manager per il tuo progetto Google Cloud, la procedura di creazione della VM esegue le seguenti operazioni:

    1. Consente a VM Manager di funzionare in modalità con restrizioni.
    2. Crea il criterio del sistema operativo di Ops Agent e un'assegnazione del criterio del sistema operativo di Ops Agent per la zona. Il criterio del sistema operativo di Ops Agent è un campo dell'assegnazione dei criteri.
    3. Consente la gestione delle patch, della configurazione e dell'inventario del sistema operativo impostando l'etichetta dei metadati della VM enable-osconfig su TRUE.
    4. Crea la VM e 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à un'assegnazione del criterio 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 di criteri OS Ops Agent. Credi due VM, instance-1 e instance-2 nella zona us-central1-a. Poi crei instance-3 e instance-4 nella zona us-east1-b. Per instance-1, instance-2 e 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 un'assegnazione del criterio 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 del sistema operativo di Ops Agent per la zona us-east1-b e un'assegnazione del criterio 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 dei criteri del 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 è coperta perché non hai selezionato Installa Ops Agent per il monitoraggio e il logging, pertanto non ha l'etichetta goog-ops-agent-policy:v2-x86-template-1-0-0. Se vuoi applicare il criterio del sistema operativo di Ops Agent anche all'instance-4, consulta Aggiungere la copertura del criterio 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. Finché nella VM è installata una versione di Ops Agent, il criterio non fa nulla. 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 lascia che il criterio del sistema operativo di Ops Agent installi la versione più recente.

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

Risoluzione dei problemi

Per informazioni sulla risoluzione dei problemi relativi all'installazione dell'agente e ai criteri per il sistema operativo di Ops Agent, consulta Gestire le VM coperte dal criterio per il sistema operativo di Ops Agent e Strumento di diagnostica dell'agente per i criteri di installazione automatica.

Prezzi

I criteri del sistema operativo sono strumenti generici per l'installazione di pacchetti. Per impostazione predefinita, quando VM Manager è abilitato perché hai creato una VM con Ops Agent installato automaticamente, VM Manager è abilitato in modalità limitata. Per informazioni sulle modalità e sui prezzi di VM Manager, consulta 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.