Configura VM Manager

Su 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 la 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 configurazione del sistema operativo per il tuo progetto.
• Se non l'hai ancora fatto, configura l'autenticazione. L'autenticazione è il processo mediante il quale viene verificata l'identità per l'accesso ai servizi e alle API Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti in Compute Engine nel seguente modo.
  

  Select the tab for how you plan to use the samples on this page:

  Console

  When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

  gcloud

  1. Install the Google Cloud CLI, then initialize it by running the following command:

     gcloud init

  2. Set a default region and zone.

  REST

  Per utilizzare gli esempi dell'API REST in questa pagina in un ambiente di sviluppo locale, utilizza le credenziali fornite a gcloud CLI.

  Install the Google Cloud CLI, then initialize it by running the following command:

  gcloud init

  Per ulteriori informazioni, consulta Eseguire l'autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.

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 dover completare manualmente alcuni passaggi.

• Abilitazione manuale: può essere eseguita per VM o per l'intero progetto Google Cloud.

Sistemi operativi supportati

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

Abilita l'API del servizio OS Config

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

gcloud services enable osconfig.googleapis.com

Controlla se l'agente OS Config è installato

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

sudo systemctl status google-osconfig-agent

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

PowerShell Get-Service google_osconfig_agent

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

Installa l'agente OS Config

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

Su ogni VM, installa l'agente OS Config. Puoi installare l'agente OS Config utilizzando una delle seguenti opzioni:

• Installa l'agente manualmente utilizzando il terminale.
• Utilizza uno script di avvio sulle tue VM.
• Automatizza l'installazione di OS Config su più VM utilizzando un criterio dell'agente Google Cloud Observability.

Installa l'agente manualmente

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

Per installare l'agente, completa i seguenti passaggi:

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

2. Installa 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. Installa 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 che hai ricevuto il messaggio di errore "Impossibile individuare il pacchetto", completa i seguenti passaggi 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 questi comandi:

     1. Aggiungi 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 questi comandi:

     1. Aggiungi 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 questo comando:

        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 questo comando:

        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. Installa l'agente OS Config.

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

Installare 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 per il 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 che lo script di avvio sia stato completato. Per verificare se lo script di avvio è stato 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 che si applicano 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 di:

• 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 OS Inventory Management, consulta Versioni di OS Inventory Management.

Configura un proxy HTTP

Se utilizzi un proxy HTTP per le VM, esegui questi comandi per impostare le variabili di ambiente http_proxy e https_proxy. Devi anche escludere il server dei 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.

  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.
 

  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

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, prefissa la 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à non necessarie

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 relativi a patch e sistema operativo: tasks
• Criteri guest del sistema operativo (beta): guestpolicies

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

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

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

Requisiti per un agente OS Config attivo

Affinché l'agente OS Config venga 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.

Verifica la configurazione

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

Visualizza le impostazioni delle funzionalità di VM Manager per il tuo progetto

Per verificare se tutte le funzionalità di VM Manager sono abilitate nel tuo progetto, segui questi passaggi:

gcloud compute os-config project-feature-settings describe \
    --project PROJECT_ID

Il valore OSCONFIG_C rappresenta un set completo di funzionalità di VM Manager, mentre OSCONFIG_B rappresenta un set di funzionalità limitato.

   GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/global/projectFeatureSettings
   

Il valore OSCONFIG_C rappresenta un set completo di funzionalità di VM Manager, mentre OSCONFIG_B rappresenta un set di funzionalità limitato.

Abilita le funzionalità complete di VM Manager

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

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

gcloud compute os-config project-feature-settings update \
    --project PROJECT_ID \
    --patch-and-config-feature-set=full

   PATCH https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/global/projectFeatureSettings
   {
     "name": "projects/PROJECT_ID/locations/global/projectFeatureSettings",
     "patchAndConfigFeatureSet": "OSCONFIG_C"
   }
   

Disabilita l'agente OS Config

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

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

PowerShell Stop-Service google_osconfig_agent [-StartupType disabled]

Che cosa succede dopo?

• Crea un'assegnazione dei criteri del sistema operativo.
• Visualizza i dettagli del sistema operativo.
• Crea job di applicazione patch.
• Scopri di più su VM Manager.