Configura VM Manager


In Compute Engine puoi gestire i sistemi operativi in esecuzione sulle tue macchine virtuali (VM) utilizzando VM Manager.

Per esaminare i passaggi necessari per configurare le VM per l'utilizzo di VM Manager, consulta Panoramica della configurazione.

Dopo aver configurato VM Manager, puoi visualizzare gli audit log per le operazioni API eseguite con l'API OS Config. Consulta Visualizzazione degli audit log di VM Manager.

Prima di iniziare

  • Esamina le quote di OS Config per il tuo progetto.
  • Configurare l'autenticazione.

    Seleziona la scheda relativa a come intendi utilizzare gli esempi di questa pagina:

    Console

    Quando utilizzi la console Google Cloud per accedere ai servizi e alle API Google Cloud, non è necessario configurare l'autenticazione.

    gcloud

    1. Installa Google Cloud CLI, quindi inizializzalo eseguendo il comando seguente:

      gcloud init
    2. Imposta una regione e una zona predefinite.

    REST

    Per utilizzare gli esempi di API REST su questa pagina in un ambiente di sviluppo locale, devi utilizzare le credenziali che fornisci allgcloud CLI.

      Installa Google Cloud CLI, quindi inizializzalo eseguendo il comando seguente:

      gcloud init

Panoramica della configurazione

Per abilitare VM Manager, hai due opzioni:

  • Abilitazione automatica: si applica all'intero progetto Google Cloud. Puoi completare l'abilitazione automatica dalla console Google Cloud. Potresti comunque dover completare manualmente alcuni passaggi.
  • Abilitazione manuale: può essere eseguita per VM o per l'intero progetto Google Cloud.

Manuale

Per configurare manualmente VM Manager, completa i seguenti passaggi:

  1. Nel tuo progetto Google Cloud, abilita l'API OS Config.
  2. Su ogni VM, controlla se l'agente OS Config è installato. Se l'agente non è già installato, installa l'agente OS Config.
  3. Nel progetto o su ogni VM, imposta i metadati delle istanze per l'agente OS Config. Questo passaggio è necessario per attivare l'agente OS Config nella VM o nel progetto.
  4. Verifica che tutte le VM abbiano un account di servizio associato. Non è necessario concedere alcun ruolo IAM a questo account di servizio. VM Manager utilizza questo account di servizio per firmare le richieste al servizio API.
  5. Se la tua VM è in esecuzione all'interno di una rete VPC privata e non ha accesso a internet pubblico, abilita l'accesso privato Google.
  6. Se utilizzi un proxy HTTP per le tue VM, configura un proxy HTTP.
  7. Facoltativo. Sul tuo progetto o su ogni VM, disabilita le funzionalità che non ti servono.

Automatica

La prima volta che accedi a una delle pagine di VM Manager nella console Google Cloud, puoi scegliere di abilitare automaticamente VM Manager.

Se segui la procedura guidata, puoi utilizzare l'abilitazione automatica per completare quanto segue:

  • Abilita l'API OS Config Service nel progetto Google Cloud
  • Attivare gli agenti OS Config su tutte le VM nel progetto Google Cloud in cui è installato l'agente

Abilitazione automatica.

Sistemi operativi supportati

Per l'elenco completo delle versioni del sistema operativo che supportano VM Manager, consulta Dettagli del sistema operativo.

Abilita l'API OS Config Service

Nel tuo progetto Google Cloud, abilita l'API OS Config.

Console

Nella console Google Cloud, abilita l'API OS Config.

Abilita l'API OS Config

gcloud

Per abilitare l'API, esegui questo comando:

gcloud services enable osconfig.googleapis.com

Controlla se l'agente OS Config è installato

L'agente OS Config è installato per impostazione predefinita su immagini CentOS, Container-Optimized OS (COS), Debian, Red Hat Enterprise Linux (RHEL), Rocky Linux, SLES, Ubuntu e Windows Server la cui data di build è v20200114 o successiva. Per informazioni sulle versioni dei sistemi operativi in cui è installato l'agente OS Config, vedi Dettagli del sistema operativo. Questi agenti vengono eseguiti in modo inattivo finché non abiliti i metadati dell'agente e l'API di servizio.

Linux

Per verificare se l'agente è installato sulla VM Linux, esegui questo comando:

sudo systemctl status google-osconfig-agent

Se l'agente è installato ed in esecuzione, l'output è simile al seguente:

google-osconfig-agent.service - Google OSConfig Agent
Loaded: loaded (/lib/systemd/system/google-osconfig-agent.service; enabled; vendor preset:
Active: active (running) since Wed 2020-01-15 00:14:22 UTC; 6min ago
Main PID: 369 (google_osconfig)
 Tasks: 8 (limit: 4374)
Memory: 102.7M
CGroup: /system.slice/google-osconfig-agent.service
        └─369 /usr/bin/google_osconfig_agent

Se l'agente non è installato, installa l'agente OS Config.

Windows

Per verificare se l'agente è installato sulla VM Windows, esegui questo comando:

PowerShell Get-Service google_osconfig_agent

Se l'agente è installato ed in esecuzione, l'output è simile al seguente:

Status   Name               DisplayName
------   ----               -----------
Running  google_osconfig... Google OSConfig Agent

Se l'agente non è installato, installa l'agente OS Config.

Installa l'agente OS Config

Prima di seguire questi passaggi per installare l'agente, verifica che sia già in esecuzione sulla tua VM.

Installa l'agente OS Config su ogni VM. Puoi installare l'agente OS Config utilizzando una delle seguenti opzioni:

Installa l'agente manualmente

Utilizza questa opzione per installare l'agente OS Config su una VM esistente.

Per installare l'agente, segui questi passaggi:

  1. Connettiti alla VM su cui vuoi installare l'agente OS Config.

  2. Installare l'agente OS Config.

    Windows Server

    Per installare l'agente OS Config su un server Windows, esegui questo comando:

    googet -noconfirm install google-osconfig-agent
    

    Ubuntu

    Per installare l'agente OS Config su una VM Ubuntu, esegui questi comandi:

    1. Configurare il repository Ubuntu.

      • Per Ubuntu 20.04 e versioni successive, esegui questi comandi:

        1. Aggiungi il repository Ubuntu.

          sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-focal-stable main' > \
          /etc/apt/sources.list.d/google-compute-engine.list"
          
        2. Importa la chiave pubblica di Google Cloud.

          curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
          sudo apt-key add -
          
      • Per Ubuntu 18.04 e versioni successive, esegui questi comandi:

        1. Aggiungi il repository Ubuntu.

          sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-bionic-stable main' > \
          /etc/apt/sources.list.d/google-compute-engine.list"
          
        2. Importa la chiave pubblica di Google Cloud.

          curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
          sudo apt-key add -
          
      • Per Ubuntu 16.04, esegui questi comandi:

        1. Aggiungi il repository Ubuntu.

          sudo su -c "echo 'deb http://packages.cloud.google.com/apt google-compute-engine-xenial-stable main'> \
          /etc/apt/sources.list.d/google-compute-engine.list"
          
        2. Importa la chiave pubblica di Google Cloud.

          curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
          sudo apt-key add -
          
    2. Installare l'agente OS Config.

      sudo apt update
      sudo apt -y install google-osconfig-agent
      

    Debian

    Per installare l'agente OS Config su una VM Debian, esegui questi comandi:

    sudo apt update
    sudo apt -y install google-osconfig-agent
    

    Aggiunta del repository Google Cloud e della chiave pubblica

    Se utilizzi un'istanza VM che non è stata creata da un'immagine fornita da Google o se hai ricevuto il messaggio di errore "Impossibile individuare il pacchetto", completa i passaggi seguenti per aggiungere il repository Google Cloud e importare la chiave pubblica.

    Dopo aver aggiunto il repository e importato la chiave, puoi eseguire i comandi per installare l'agente OS Config.

    • Per Debian 9 (Stretch), esegui i seguenti comandi:

      1. Aggiungere il repository Debian.

        sudo su -c "echo 'deb http://packages.cloud.google.com/apt \
        google-compute-engine-stretch-stable main'> /etc/apt/sources.list.d/google-compute-engine.list"
        
      2. Importa la chiave pubblica di Google Cloud.

        curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
        sudo apt-key add -
        
    • Per Debian 10 (Buster), esegui i seguenti comandi:

      1. Aggiungere il repository Debian.

        sudo su -c "echo 'deb http://packages.cloud.google.com/apt \
        google-compute-engine-buster-stable main'> /etc/apt/sources.list.d/google-compute-engine.list"
        
      2. Importa la chiave pubblica di Google Cloud.

        curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | \
        sudo apt-key add -
        

    RHEL/CentOS/Rocky

    Per installare l'agente OS Config su una VM RHEL 7/8, CentOS 7/8 o Rocky Linux 8/9, esegui questo comando:

    sudo yum -y install google-osconfig-agent
    

    SLES/openSUSE

    Per installare l'agente OS Config su una VM SLES o openSUSE, esegui questi comandi:

    1. Configurare il repository SLES.

      • Per SLES 12, esegui il comando seguente:

        sudo su -c "cat > /etc/zypp/repos.d/google-compute-engine.repo <<EOM
        [google-compute-engine]
        name=Google Compute Engine
        baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-sles12-stable
        enabled=1
        gpgcheck=1
        repo_gpgcheck=0
        gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
          https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
        EOM"
        
      • Per SLES 15 e OpenSUSE 15, esegui il comando seguente:

        sudo su -c "cat > /etc/zypp/repos.d/google-compute-engine.repo <<EOM
        [google-compute-engine]
        name=Google Compute Engine
        baseurl=https://packages.cloud.google.com/yum/repos/google-compute-engine-sles15-stable
        enabled=1
        gpgcheck=1
        repo_gpgcheck=0
        gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
          https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
        EOM"
        
        
    2. Importa le chiavi GPG per Google Cloud.

      sudo rpm --import https://packages.cloud.google.com/yum/doc/yum-key.gpg \
      --import https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
      
    3. Installare l'agente OS Config.

      sudo zypper -n --gpg-auto-import-keys install --from google-compute-engine google-osconfig-agent
      

Installa l'agente utilizzando uno script di avvio

Puoi anche utilizzare i comandi di installazione manuale per creare uno script di avvio che installi l'agente OS Config durante la creazione della VM.

  1. Copia i comandi manuali relativi al tuo sistema operativo.
  2. Fornisci lo script di avvio al metodo di creazione della VM.

    Ad esempio, se utilizzi il comando gcloud compute instances create per creare una VM Debian 10, il comando è simile al seguente:

    gcloud compute instances create VM_NAME \
       --image-family=debian-10 --image-project=debian-cloud \
       --metadata startup-script='#! /bin/bash
       apt update
       apt -y install google-osconfig-agent'

    Sostituisci VM_NAME con il nome della tua VM.

  3. Verifica il completamento dello script di avvio. Per verificare se lo script di avvio viene completato, esamina i log o controlla la serial console.

Impostare i valori dei metadati

Puoi impostare i metadati dell'istanza su ogni VM o i metadati del progetto applicabili a tutte le VM nel tuo progetto.

Nel progetto o nella VM Google Cloud, imposta il valore dei metadati enable-osconfig su TRUE. L'impostazione del valore dei metadati enable-osconfig su TRUE consente quanto segue:

  • Patch
  • Criteri di sistema operativo
  • OS Inventory Management.
    • Per la versione precedente di OS Inventory Management, devi anche impostare il valore dei metadati enable-guest-attributes su TRUE. Se entrambi i valori dei metadati non sono impostati, la dashboard mostra no data per la VM. Questa operazione non è necessaria per la versione successiva. Per informazioni sulle due versioni di OS Inventory Management, consulta Versioni di OS Inventory Management.

Console

Puoi applicare i valori dei metadati ai progetti o alle VM Google Cloud utilizzando una delle seguenti opzioni:

  • Opzione 1: imposta enable-osconfig nei metadati a livello di progetto, in modo che venga applicato a tutte le VM nel progetto.

    1. Nella console Google Cloud, vai alla pagina Metadati.

      Vai ai metadati

    2. Fai clic su Modifica.

    3. Aggiungi la seguente voce di metadati:

      Chiave: enable-osconfig
      Valore: TRUE

      Per la versione precedente di OS Inventory Management, imposta sia enable-osconfig che enable-guest-attributes:

      • Chiave: enable-osconfig
        Valore: TRUE
      • Chiave: enable-guest-attributes
        Valore: TRUE
    4. Fai clic su Salva per applicare le modifiche.

  • Opzione 2: imposta enable-osconfig nei metadati della VM quando crei un'istanza.

    1. Nella console Google Cloud, vai alla pagina Crea un'istanza.

      Vai a Crea un'istanza

    2. Specifica i dettagli della VM.

    3. Espandi la sezione Opzioni avanzate e segui questi passaggi:

      1. Espandi la sezione Gestione.
      2. Nella sezione Metadati, fai clic su Aggiungi elemento e aggiungi le seguenti voci di metadati:

        Chiave: enable-osconfig
        Valore: TRUE.

        Per la versione precedente di OS Inventory Management, imposta sia enable-osconfig che enable-guest-attributes:

        • Chiave: enable-osconfig
          Valore: TRUE
        • Chiave: enable-guest-attributes
          Valore: TRUE
    4. Per creare la VM, fai clic su Crea.

  • Opzione 3: imposta enable-osconfig nei metadati di una VM esistente.

    1. Nella console Google Cloud, vai alla pagina Istanze VM.

      Vai a Istanze VM

    2. Fai clic sul nome della VM per cui vuoi impostare il valore dei metadati.

    3. Nella pagina Dettagli istanza, fai clic su Modifica per modificare le impostazioni.

    4. In Metadati personalizzati, aggiungi le seguenti voci di metadati:

      Chiave: enable-osconfig
      Valore: TRUE.

      Per la versione precedente di OS Inventory Management, imposta sia enable-osconfig che enable-guest-attributes:

      • Chiave: enable-osconfig
        Valore: TRUE
      • Chiave: enable-guest-attributes
        Valore: TRUE
    5. Fai clic su Salva per applicare le modifiche alla VM.

gcloud

Utilizza il project-info add-metadata o il comando instances add-metadata con il flag --metadata=enable-osconfig=TRUE.

Puoi applicare i valori dei metadati ai progetti o alle VM utilizzando una delle seguenti opzioni:

  • Opzione 1: imposta enable-osconfig nei metadati a livello di progetto, in modo che venga applicato a tutte le istanze del progetto:

    gcloud compute project-info add-metadata \
      --project PROJECT_ID \
      --metadata=enable-osconfig=TRUE
    

    Per la versione precedente di OS Inventory Management, imposta sia enable-osconfig che enable-guest-attributes:

    gcloud compute project-info add-metadata \
      --project PROJECT_ID \
      --metadata=enable-guest-attributes=TRUE,enable-osconfig=TRUE
    

    Sostituisci PROJECT_ID con l'ID progetto.

  • Opzione 2: imposta enable-osconfig nei metadati di un'istanza esistente.

    gcloud compute instances add-metadata VM_NAME \
      --metadata=enable-osconfig=TRUE
    

    Per la versione precedente di OS Inventory Management, imposta sia enable-osconfig che enable-guest-attributes:

    gcloud compute instances add-metadata VM_NAME \
      --metadata=enable-guest-attributes=TRUE,enable-osconfig=TRUE
    

    Sostituisci VM_NAME con il nome della tua VM.

  • Opzione 3: imposta enable-osconfig nei metadati dell'istanza quando crei un'istanza.

    gcloud compute instances create VM_NAME \
      --metadata=enable-osconfig=TRUE
    

    Per la versione precedente di OS Inventory Management, imposta sia enable-osconfig che enable-guest-attributes:

    gcloud compute instances create VM_NAME \
      --metadata=enable-guest-attributes=TRUE,enable-osconfig=TRUE
    

    Sostituisci VM_NAME con il nome della tua VM.

REST

Puoi impostare il valore dei metadati a livello di progetto o istanza Google Cloud.

La seguente coppia chiave-valore è obbligatoria per la proprietà dei metadati:

  • Chiave: enable-osconfig
    Valore: TRUE

Per la versione precedente di OS Inventory Management, aggiungi anche la seguente coppia chiave-valore:

  • Chiave: enable-guest-attributes
    Valore: TRUE

Configura un proxy HTTP

Se utilizzi un proxy HTTP per le VM, esegui i comandi seguenti per impostare le variabili di ambiente http_proxy e https_proxy. Devi anche escludere il server di metadati (169.254.169.254) configurando la variabile di ambiente no_proxy in modo che l'agente OS Config possa accedere al server di metadati locale.

Linux

Aggiungi le seguenti variabili di ambiente in un file di configurazione a livello di sistema. Ad esempio, in CentOS 7 aggiungi le impostazioni del proxy nel file /etc/systemd/system.conf:

  http_proxy="http://PROXY_IP:PROXY_PORT"
  https_proxy="http://PROXY_IP:PROXY_PORT"
  no_proxy=169.254.169.254,metadata,metadata.google.internal  # Skip proxy for the local Metadata Server.
 

Sostituisci PROXY_IP e PROXY_PORT con l'indirizzo IP e il numero di porta del tuo server proxy, rispettivamente.

Windows

Esegui questi comandi dal prompt dei comandi dell'amministratore.

  setx http_proxy http://PROXY_IP:PROXY_PORT /m
  setx https_proxy http://PROXY_IP:PROXY_PORT /m
  setx no_proxy 169.254.169.254,metadata,metadata.google.internal /m

Sostituisci PROXY_IP e PROXY_PORT con l'indirizzo IP e il numero di porta del tuo server proxy, rispettivamente.

Google consiglia di escludere *.googleapis.com aggiungendo la variabile di ambiente no_proxy per evitare problemi di connessione da parte dell'agente OS Config. Se vuoi connettere solo VM specifiche all'agente OS Config, imposta il prefisso della zona in cui si trovano le VM e utilizza il formato [zone-name]-osconfig.googleapis.com. Ad esempio: us-central1-f-osconfig.googleapis.com.

Disattivare le funzionalità che non ti servono

Per le funzionalità che potrebbero non essere necessarie, puoi disattivarle impostando i seguenti valori dei metadati: osconfig-disabled-features=FEATURE1,FEATURE2.

Sostituisci FEATURE1,FEATURE2 con uno dei seguenti valori:

  • OS Inventory Management: osinventory
  • Criteri patch e sistema operativo: tasks
  • Criteri guest del sistema operativo (beta): guestpolicies

Utilizza uno dei seguenti metodi per disattivare i valori dei metadati.

Console

Puoi disabilitare i valori dei metadati nei progetti o nelle VM Google Cloud utilizzando una delle seguenti opzioni:

  • Opzione 1: disabilita la funzionalità nei metadati a livello di progetto in modo che venga applicata a tutte le istanze nel progetto.

    1. Nella console Google Cloud, vai alla pagina Metadati.

      Vai ai metadati

    2. Fai clic su Modifica.

    3. Aggiungi la seguente voce di metadati:

      Chiave: osconfig-disabled-features
      Valore: FEATURE1,FEATURE2

      Ad esempio:
      Chiave: osconfig-disabled-features
      Valore: osinventory,guestpolicies

    4. Fai clic su Salva per applicare le modifiche.

  • Opzione 2: disabilita la funzionalità nei metadati di una VM esistente.

    1. Nella console Google Cloud, vai alla pagina Istanze VM.

      Vai a Istanze VM

    2. Fai clic sul nome della VM per cui vuoi impostare il valore dei metadati.

    3. Nella pagina Dettagli istanza, fai clic su Modifica per modificare le impostazioni delle VM.

    4. In Metadati personalizzati, aggiungi le seguenti voci di metadati:

      Chiave: osconfig-disabled-features
      Valore: FEATURE1,FEATURE2

      Ad esempio:
      Chiave: osconfig-disabled-features
      Valore: osinventory

    5. Fai clic su Salva per applicare le modifiche alla VM.

gcloud

Utilizza il project-info add-metadata o il comando gcloud instances add-metadata con il flag --metadata=osconfig-disabled-features.

Se stai disattivando più funzionalità, il flag deve avere il formato --metadata=osconfig-disabled-features=FEATURE1,FEATURE2. Vedi l'esempio 2.

Esempi

Esempio 1 Per disabilitare Patch a livello di progetto Google Cloud utilizzando Google Cloud CLI, esegui questo comando:

gcloud compute project-info add-metadata \
    --project PROJECT_ID \
    --metadata=osconfig-disabled-features=tasks

Esempio 2 Per disabilitare i criteri del sistema operativo e la gestione dell'inventario del sistema operativo a livello di progetto utilizzando Google Cloud CLI, esegui questo comando:

gcloud compute project-info add-metadata \
    --project PROJECT_ID \
    --metadata=osconfig-disabled-features=osinventory,guestpolicies

Sostituisci PROJECT_ID con l'ID progetto.

REST

Puoi impostare il valore dei metadati a livello di progetto o istanza Google Cloud.

La seguente coppia chiave-valore è obbligatoria per la proprietà dei metadati:

  • Chiave: osconfig-disabled-features
  • Valore: può essere uno qualsiasi o una combinazione dei seguenti flag:
    • osinventory
    • tasks
    • guestpolicies

Requisiti per un agente OS Config attivo

Affinché l'agente OS Config sia considerato attivo e fatturabile, deve soddisfare tutti i seguenti requisiti:

  • VM Manager deve essere configurato.
  • La VM deve essere in stato RUNNING e l'agente OS Config deve comunicare con il servizio OS Config.

    Se una VM viene arrestata, sospesa o disconnessa dalla rete, l'agente su quella VM non viene conteggiato come agente attivo.

Verificare la configurazione

Dopo aver completato la procedura di configurazione, puoi verificare la configurazione.

Abilita le funzionalità complete di VM Manager

Se VM Manager non è abilitato nel tuo progetto e installi Ops Agent durante la creazione delle VM, VM Manager è abilitato in modalità limitata. In questa modalità, VM Manager offre un sottoinsieme di funzionalità per un numero illimitato di VM senza costi. Ad esempio, puoi visualizzare le assegnazioni dei criteri del sistema operativo per le tue VM nella pagina Criteri del sistema operativo, ma non puoi creare o modificare le assegnazioni dei criteri del sistema operativo.

Per abilitare tutte le funzionalità di VM Manager per queste VM con Ops Agent installato, segui questi passaggi:

  1. Nella console Google Cloud, vai alla pagina Criteri del sistema operativo.

    Vai ai criteri del sistema operativo

  2. Fai clic su Abilita le funzionalità complete di VM Manager per abilitare tutte le funzionalità di VM Manager.

    Abilita automaticamente VM Manager completo.

Disabilita l'agente OS Config

La disabilitazione dell'agente OS Config non influisce sul comportamento della VM. Puoi disattivare l'agente nello stesso modo in cui interrompi gli altri servizi del sistema operativo.

Linux

Per disabilitare l'agente utilizzando systemctl, esegui questi comandi:

sudo systemctl stop google-osconfig-agent
sudo systemctl disable google-osconfig-agent

Windows

Per disabilitare l'agente utilizzando powershell, esegui questo comando:

PowerShell Stop-Service google_osconfig_agent [-StartupType disabled]

Che cosa succede dopo?