Questa pagina è stata tradotta dall'API Cloud Translation.

Configura VM Manager

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

Puoi attivare VM Manager per singole VM, per un progetto o per tutti i progetti in una cartella o un'organizzazione. 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 OS Config per il tuo progetto.
Se non l'hai ancora fatto, configura l'autenticazione. Autenticazione è Il processo di verifica dell'identità per l'accesso ai servizi e alle API di Google Cloud. Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi autenticarti su Compute Engine come segue.

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
  Note: If you installed the gcloud CLI previously, make sure you have the latest version by running gcloud components update.
2. Set a default region and zone.

Sistemi operativi supportati

Per l'elenco completo delle versioni del sistema operativo che supportano VM Manager, consulta Dettagli del sistema operativo. Se l'agente di configurazione del sistema operativo non è disponibile per un determinato sistema operativo, non puoi attivare VM Manager per una VM che esegue questo sistema operativo.

Attivare VM Manager utilizzando un criterio dell'organizzazione

Puoi abilitare automaticamente VM Manager per tutte le nuove VM nel tuo un'organizzazione, una cartella o un progetto utilizzando il criterio dell'organizzazione Richiedi OS Config.

Quando viene configurato il vincolo booleano Richiedi OS Config, quanto segue: vengono applicate le seguenti condizioni:

enable-osconfig=TRUE è incluso nei metadati del progetto per tutti i nuovi progetti.
Le richieste che impostano enable-osconfig su FALSE nei metadati di istanza o progetto vengono rifiutate per VM e progetti nuovi ed esistenti.
Questo criterio dell'organizzazione non modifica il valore del metadato enable-osconfig in TRUE per le VM o per i progetti creati prima dell'attivazione del criterio. Se vuoi attivare VM Manager su queste VM o su questi progetti, ti consigliamo di aggiornare i metadati. Per ulteriori informazioni, consulta la sezione Impostare i valori dei metadati.

Attiva il criterio dell'organizzazione OS Config

Autorizzazioni richieste per questa attività

Per eseguire questa attività, devi disporre di quanto segue autorizzazioni:

resourcemanager.organizationAdmin role. Per ulteriori informazioni consulta Controllo dell'accesso per che utilizzano IAM.
Per scoprire di più sulla gestione dei criteri a livello di organizzazione, consulta Aggiungi un amministratore dei criteri dell'organizzazione.

Per abilitare il criterio OS Config, puoi impostare il vincolo Richiedi OS Config su l'intera organizzazione, le cartelle o i progetti specifici utilizzando console Google Cloud o Google Cloud CLI.

Console

Per impostare il criterio dell'organizzazione di OS Config dalla console, completa i seguenti passaggi:

Nella console Google Cloud, vai alla pagina Norme dell'organizzazione.

Vai a Criteri dell'organizzazione
Dal selettore di progetti, seleziona il progetto, la cartella o l'organizzazione per per le quali vuoi modificare i criteri dell'organizzazione.
La pagina Criteri dell'organizzazione mostra un elenco filtrabile dei vincoli dei criteri dell'organizzazione disponibili.
Seleziona il vincolo Richiedi configurazione OS dall'elenco dei vincoli. Nella pagina Dettagli criteri visualizzata viene descritto il vincolo e fornite informazioni su come viene applicato.
Per aggiornare il criterio dell'organizzazione per questa risorsa, fai clic su Gestisci criterio.
Nella pagina Modifica criterio, seleziona Sostituisci criterio della risorsa padre.
Seleziona Aggiungi una regola.
In Applicazione, seleziona se attivare o meno l'applicazione di questo criterio dell'organizzazione.
Per applicare il criterio, fai clic su Imposta criterio.

gcloud

Per impostare il criterio dell'organizzazione di OS Config, utilizza il comando gcloud beta resource-manager org-policies enable-enforce.

Trova l'ID organizzazione.
```
gcloud organizations list
```

Imposta la limitazione nella tua organizzazione. Sostituisci organization-id con il tuo ID organizzazione.

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --organization=organization-id

Puoi anche applicare il criterio dell'organizzazione di OS Config a una cartella o a un progetto con i flag --folder o --project e l'ID cartella e l'ID progetto, rispettivamente.

Per le cartelle, esegui il seguente comando:

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --folder=folder-id

Per i progetti, esegui il seguente comando:

gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \
    --project=project-id

Sostituisci quanto segue:

folder-id: il tuo ID cartella.
project-id: il tuo ID progetto.

Abilita VM Manager in un progetto

Attenzione: per creare job di patch o assegnazioni dei criteri del sistema operativo utilizzando VM Manager, devi concedere agli utenti le autorizzazioni IAM richieste. Queste autorizzazioni consentono di accedere all'esecuzione del codice sulle VM, il che può comportare di un potenziale rischio per la sicurezza.

Per ridurre questo rischio, ti consigliamo di seguire il principio del privilegio minimo e di fornire a ogni utente solo l'accesso necessario. Se non prevedi di utilizzare VM Manager nel tuo progetto Google Cloud, di disabilitare VM Manager nel seguente modo:

Disabilita le funzionalità delle patch e dei criteri del sistema operativo entro il giorno l'impostazione dei metadati a livello di progetto.

Disabilita VM Manager impostando il valore enable-osconfig in FALSE.

Disabilita l'agente OS Config.

Per abilitare VM Manager nel tuo progetto, hai due opzioni:

Attivazione automatica: si applica all'intero progetto Google Cloud. Hai completato l'attivazione automatica dalla console Google Cloud. Potresti avere ancora bisogno per completare manualmente alcuni passaggi.
Abilitazione manuale: può essere eseguita per ogni VM o per l'intero progetto Google Cloud.

Manuale

Per configurare manualmente VM Manager, completa i seguenti passaggi:

Nel progetto Google Cloud, abilita l'API OS Config.
In ogni VM, controlla se è installato l'agente OS Config. Se l'agente non è già installato, installa l'agente OS Config.
Nel progetto o in ogni VM, imposta i metadati dell'istanza per l'agente OS Config. Questo passaggio è necessario per attivare l'agente OS Config nella VM o nel progetto.
Verifica che a tutte le VM sia collegato un account di servizio. Non è necessario concedere ruoli IAM a questo account di servizio. VM Manager utilizza questo account di servizio per firmare le richieste al servizio API.
Se la tua VM è in esecuzione all'interno di una rete VPC privata e non dispone dell'accesso a internet pubblico, abilita l'accesso privato Google.
Se utilizzi un proxy HTTP per le VM, configura un proxy HTTP.
Facoltativo. Sul progetto o su ogni VM, disabilita le funzionalità che non ti servono.

Automatico

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

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

Abilita VM Manager (API OS Config) nel progetto Google Cloud
Attiva gli agenti OS Config su tutte le VM del progetto Google Cloud su cui è installato l'agente

Abilitazione automatica.

Abilita l'API di servizio OS Config

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

Console

Nella console Google Cloud, abilita VM Manager (API OS Config).

Abilita l'API OS Config

gcloud

Per attivare il esegui questo comando:

gcloud services enable osconfig.googleapis.com

Verifica se l'agente OS Config è installato

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

Linux

Per verificare se l'agente è installato nella tua VM Linux, esegui seguente 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 nella 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 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 Criteri dell'agente di osservabilità di Google Cloud.

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:

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

Installa l'agente OS Config.

Windows Server

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

googet -noconfirm install google-osconfig-agent

Ubuntu

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

Configura il repository Ubuntu.

Per Ubuntu 20.04 e versioni successive, esegui i seguenti comandi:

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"

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 i seguenti comandi:

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"

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 i seguenti comandi:

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"

Importa la chiave pubblica di Google Cloud.

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

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 quanto segue :

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 ricezione di un messaggio "Impossibile individuare il pacco" errore completa i seguenti passaggi per aggiungere l'API Google Cloud repository 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:

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"

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:

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"

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 il seguente comando:

sudo yum -y install google-osconfig-agent

SLES/openSUSE

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

Configurare il repository SLES.

Per SLES 12, esegui il seguente 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 il seguente 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"

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

Installa 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 un script di avvio che installa l'agente OS Config durante la creazione della VM.

Copia i comandi manuali del tuo sistema operativo.
Fornire lo script di avvio al metodo di creazione della VM.

Ad esempio, se utilizzi Comando gcloud compute instances create per creare una VM Debian 10, il tuo 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 VM.
Verifica che lo script di avvio venga completato. Per verificare se l'avvio viene completato, esamina lo script log o controlla console seriale.

Impostare i valori dei metadati

Puoi impostare i metadati dell'istanza su ogni VM o i metadati di progetto che si applicano a tutte le VM del progetto.

Imposta il valore dei metadati enable-osconfig nel progetto o nella VM Google Cloud a TRUE. L'impostazione del valore dei metadati enable-osconfig su TRUE abilita il seguenti:

Patch
Criteri di sistema operativo
Gestione dell'inventario del sistema operativo
- Per la versione precedente di OS Inventory Management, devi inoltre imposta 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 le versioni successive. Per informazioni sulle due versioni di gestione dell'inventario del sistema operativo, consulta Versioni di gestione dell'inventario del sistema operativo.

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 si applichi a tutte le VM del progetto.
1. Nella console Google Cloud, vai alla pagina Metadati.
  
  Vai a 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 entrambi enable-osconfig e 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 per eseguire 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 ed esegui le seguenti:
  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 della gestione dell'inventario del sistema operativo, imposta sia enable-osconfig sia 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 entrambi enable-osconfig e 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 la project-info add-metadata o il Comando instances add-metadata con il flag --metadata=enable-osconfig=TRUE.

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

Opzione 1: imposta enable-osconfig nei metadati a livello di progetto in modo che si applichi 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 entrambi enable-osconfig e 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 entrambi enable-osconfig e 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 VM.
Opzione 3: imposta enable-osconfig nei metadati dell'istanza quando per creare un'istanza.
```
gcloud compute instances create VM_NAME \
  --metadata=enable-osconfig=TRUE
```
Per la versione precedente di OS Inventory Management, imposta entrambi enable-osconfig e 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 nel progetto Google Cloud a livello di istanza.

Per istruzioni sull'impostazione di metadati a livello di progetto, consulta impostare metadati personalizzati a livello di progetto.
Per istruzioni sull'impostazione dei metadati dell'istanza, consulta l'impostazione dei metadati dell'istanza.

La seguente coppia chiave/valore è obbligatoria all'interno della proprietà metadata:

Chiave: enable-osconfig
Valore: TRUE

Per la versione precedente della gestione dell'inventario del sistema operativo, 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 questi comandi per impostare il valore 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 di sistema. Ad esempio, in CentOS 7 aggiungi le impostazioni proxy nel /etc/systemd/system.conf file:

  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 rispettivamente con l'indirizzo IP e il numero di porta del server proxy.

Windows

Esegui questi comandi dal prompt dei comandi di un 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 server proxy, rispettivamente.

Google consiglia di escludere *.googleapis.com aggiungendo il parametro Variabile di ambiente no_proxy per evitare problemi di connessione da OS Config dell'agente. Se vuoi connettere solo VM specifiche all'agente di configurazione del sistema operativo, prefiggi 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

Puoi disattivare funzionalità non necessarie impostando i seguenti valori dei metadati: osconfig-disabled-features=FEATURE1,FEATURE2.

Sostituisci FEATURE1,FEATURE2 con uno dei seguenti valori:

Gestione dell'inventario del sistema operativo: osinventory
Criteri per patch e sistema operativo: tasks
Criteri relativi agli ospiti del sistema operativo (beta): guestpolicies

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

Console

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

Opzione 1: disattiva la funzionalità nei metadati a livello di progetto in modo che venga applicata a tutte le istanze del progetto.
1. Nella console Google Cloud, vai alla pagina Metadati.
  
  Vai a 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 su cui vuoi impostare il valore dei metadati.
3. Nella pagina Dettagli istanza, fai clic su Modifica per modificare le impostazioni della 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 comando project-info add-metadata o il instances add-metadata gcloud con il flag --metadata=osconfig-disabled-features.

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

Esempi

Esempio 1 Per disattivare Patch a livello di progetto Google Cloud utilizzando la CLI Google Cloud, esegui il seguente comando:

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

Esempio 2 Per disattivare i criteri del sistema operativo e la gestione dell'inventario del sistema operativo su 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 di istanza Google Cloud.

Per istruzioni sull'impostazione di metadati a livello di progetto, consulta impostare metadati personalizzati a livello di progetto.
Per istruzioni sull'impostazione dei metadati dell'istanza, consulta l'impostazione dei metadati dell'istanza.

Nei metadati è richiesta la seguente coppia chiave-valore proprietà:

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

Requisiti per un agente OS Config attivo

Affinché l'agente di configurazione del sistema operativo 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 un agente attivo.

Verifica la configurazione

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

Visualizzare le impostazioni delle funzionalità di VM Manager per il progetto

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

gcloud

Utilizza il comando gcloud compute os-config project-feature-settings describe come segue:

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

L'output del comando è simile al seguente:

name: projects/my-project/locations/global/projectFeatureSettings
patchAndConfigFeatureSet: OSCONFIG_C

Il valore OSCONFIG_C rappresenta l'insieme completo di funzionalità di VM Manager e OSCONFIG_B rappresenta l'insieme limitato di funzionalità.

REST

Per visualizzare le funzionalità di VM Manager nel progetto Google Cloud, crea una richiesta GET al metodo projects.locations.global.getProjectFeatureSettings.

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

Sostituisci PROJECT_ID con l'ID progetto.

In caso di esito positivo, il metodo restituisce le impostazioni delle funzionalità del progetto come mostrato nel seguente esempio:

{
 "name": "projects/my-project/locations/global/projectFeatureSettings",
 "patchAndConfigFeatureSet": "OSCONFIG_C"
}

Il valore OSCONFIG_C rappresenta il set completo di funzionalità di VM Manager e OSCONFIG_B rappresenta il 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 viene attivato 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 VM nella pagina dei criteri del sistema operativo, ma non puoi crearle o modificarle.

Abilita tutte le funzionalità di VM Manager per queste VM con Ops Agent. installato, procedi nel seguente modo:

Console

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

Vai ai criteri del sistema operativo

Fai clic su Abilita tutte le funzionalità di VM Manager per abilitare tutte le funzionalità di VM Manager. le funzionalità di machine learning.

Nota: se vuoi abilitare VM Manager per tutte le VM nel tuo progetto, imposta i metadati a livello di progetto enable-osconfig su true. Per ulteriori informazioni, consulta la sezione Impostare i valori dei metadati.

gcloud

Per attivare tutte le funzionalità di VM Manager per il progetto Google Cloud, utilizza il comando gcloud compute os-config project-feature-settings update:

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

REST

Per abilitare tutte le funzionalità di VM Manager a livello di progetto Google Cloud, invia una richiesta PATCH a Metodo projprojects.locations.global.updateProjectFeatureSettings.

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

Sostituisci PROJECT_ID con l'ID progetto. La il valore OSCONFIG_C rappresenta l'insieme completo di funzionalità di VM Manager.

Disattivare 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]

Passaggi successivi

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