Su Compute Engine puoi gestire i sistemi operativi in esecuzione sulle tue macchine virtuali (VM) utilizzando VM Manager.
Puoi abilitare VM Manager per singole VM, per un progetto o per tutti i progetti in una cartella o un'organizzazione. Per rivedere i passaggi necessari per configurare le VM per utilizzare 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.
-
Se non l'hai già fatto, configura l'autenticazione.
L'autenticazione è il processo mediante il quale viene verificata l'identità dell'utente per ottenere l'accesso ai servizi e alle API Google Cloud.
Per eseguire codice o esempi da un ambiente di sviluppo locale, puoi eseguire l'autenticazione in 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
-
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
- Set a default region and zone.
enable-osconfig=TRUE
è incluso nei metadati di progetto per tutti i nuovi progetti.- Le richieste che impostano
enable-osconfig
suFALSE
nei metadati dell'istanza o del progetto vengono rifiutate per VM e progetti nuovi ed esistenti. - Questo criterio dell'organizzazione non modifica il valore dei metadati
enable-osconfig
inTRUE
per le VM o per i progetti creati prima di abilitare il criterio. Se vuoi abilitare VM Manager su queste VM o progetti, ti consigliamo di aggiornare i metadati. Per ulteriori informazioni, consulta la sezione Impostare i valori dei metadati. Nella console Google Cloud, vai alla pagina Criteri dell'organizzazione.
Dal selettore di progetti, scegli il progetto, la cartella o l'organizzazione per cui 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 OS Config dall'elenco di vincoli. La pagina Dettagli criterio visualizzata descrive il vincolo e fornisce 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, scegli se l'applicazione forzata di questo criterio dell'organizzazione deve essere attivata.
Per applicare il criterio, fai clic su Imposta criterio.
Trova l'ID organizzazione.
gcloud organizations list
Imposta il vincolo nella tua organizzazione. Sostituisci
organization-id
con il tuo ID organizzazione.gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \ --organization=organization-id
folder-id
: il tuo ID cartella.project-id
: il tuo ID progetto.- Abilitazione automatica: si applica all'intero progetto Google Cloud. L'abilitazione automatica viene completata dalla console Google Cloud. Potresti comunque dover completare manualmente alcuni passaggi.
Abilitazione manuale: può essere eseguita per ogni VM o per l'intero progetto Google Cloud.
- Nel tuo progetto Google Cloud, abilita l'API OS Config.
- Su ogni VM, controlla se l'agente OS Config è installato. Se l'agente non è già installato, installa l'agente OS Config.
- Sul tuo progetto o su ogni VM, imposta i metadati dell'istanza per l'agente OS Config. Questo passaggio è necessario per rendere attivo l'agente OS Config attivo nella tua VM o nel tuo progetto.
- Verifica che tutte le VM abbiano un account di servizio collegato. 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 pubblico a internet, abilita l'accesso privato Google.
- Se utilizzi il proxy HTTP per le VM, configura un proxy HTTP.
- Facoltativo. Sul progetto o su ogni VM, disabilita le funzionalità che non ti servono.
- Abilita VM Manager (API OS Config) nel progetto Google Cloud
- Attiva gli agenti OS Config su tutte le VM nel progetto Google Cloud in cui è installato l'agente
- 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.
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 questo comando:
googet -noconfirm install google-osconfig-agent
Ubuntu
Per installare l'agente OS Config su una VM Ubuntu, esegui questi comandi:
Configura il repository Ubuntu.
Per Ubuntu 20.04 e versioni successive, esegui questi 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 questi 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 questi 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 questi comandi:
sudo apt update sudo apt -y install google-osconfig-agent
Aggiunta del repository di 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 un 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:
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 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:
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 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"
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
- Copia i comandi manuali del tuo sistema operativo.
Fornisci lo script di avvio al tuo metodo di creazione della VM.
Ad esempio, se utilizzi il 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 tua VM.Verifica che lo script di avvio venga completato. Per verificare se lo script di avvio è stato completato, esamina i log o controlla la console seriale.
- 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
suTRUE
. Se entrambi i valori dei metadati non sono impostati, la dashboard mostrano data
per la VM. Questa operazione non è necessaria per le versioni successive. Per informazioni sulle due versioni di OS Inventory Management, consulta Versioni di OS Inventory Management.
- Per la versione precedente di OS Inventory Management, devi anche
impostare il valore dei metadati
Opzione 1: imposta
enable-osconfig
nei metadati a livello di progetto, in modo che venga applicato a tutte le VM nel progetto.Nella console Google Cloud, vai alla pagina Metadati.
Fai clic su Modifica.
Aggiungi la seguente voce di metadati:
Chiave:
enable-osconfig
Valore:TRUE
Per la versione precedente di OS Inventory Management, imposta sia
enable-osconfig
siaenable-guest-attributes
:- Chiave:
enable-osconfig
Valore:TRUE
- Chiave:
enable-guest-attributes
Valore:TRUE
- Chiave:
Fai clic su Salva per applicare le modifiche.
Opzione 2: imposta
enable-osconfig
nei metadati della VM quando crei un'istanza.Nella console Google Cloud, vai alla pagina Crea un'istanza.
Specifica i dettagli della VM.
Espandi la sezione Opzioni avanzate e procedi nel seguente modo:
- Espandi la sezione Gestione.
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
siaenable-guest-attributes
:- Chiave:
enable-osconfig
Valore:TRUE
- Chiave:
enable-guest-attributes
Valore:TRUE
- Chiave:
Per creare la VM, fai clic su Crea.
Opzione 3: imposta
enable-osconfig
nei metadati di una VM esistente.Nella console Google Cloud, vai alla pagina Istanze VM.
Fai clic sul nome della VM per cui vuoi impostare il valore dei metadati.
Nella pagina Dettagli istanza, fai clic su Modifica per modificare le impostazioni.
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
siaenable-guest-attributes
:- Chiave:
enable-osconfig
Valore:TRUE
- Chiave:
enable-guest-attributes
Valore:TRUE
- Chiave:
Fai clic su Salva per applicare le modifiche alla VM.
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
siaenable-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
siaenable-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
siaenable-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.- Per istruzioni sull'impostazione dei metadati a livello di progetto, consulta l'impostazione dei metadati personalizzati a livello di progetto.
- Per istruzioni sull'impostazione dei metadati dell'istanza, consulta Impostazione dei metadati dell'istanza.
- Chiave:
enable-osconfig
Valore:TRUE
- Chiave:
enable-guest-attributes
Valore:TRUE
- Gestione dell'inventario del sistema operativo:
osinventory
- Criteri di sistema operativo e patch:
tasks
- Criteri relativi agli ospiti del sistema operativo (beta):
guestpolicies
Opzione 1: disabilita la funzionalità nei metadati a livello di progetto in modo che venga applicata a tutte le istanze del progetto.
Nella console Google Cloud, vai alla pagina Metadati.
Fai clic su Modifica.
Aggiungi la seguente voce di metadati:
Chiave:
osconfig-disabled-features
Valore:FEATURE1,FEATURE2
Ad esempio:
Chiave:osconfig-disabled-features
Valore:osinventory,guestpolicies
Fai clic su Salva per applicare le modifiche.
Opzione 2: disabilita la funzionalità nei metadati di una VM esistente.
Nella console Google Cloud, vai alla pagina Istanze VM.
Fai clic sul nome della VM su cui vuoi impostare il valore dei metadati.
Nella pagina Dettagli istanza, fai clic su Modifica per modificare le impostazioni della VM.
In Metadati personalizzati, aggiungi le seguenti voci di metadati:
Chiave:
osconfig-disabled-features
Valore:FEATURE1,FEATURE2
Ad esempio:
Chiave:osconfig-disabled-features
Valore:osinventory
Fai clic su Salva per applicare le modifiche alla VM.
- Per istruzioni sull'impostazione dei metadati a livello di progetto, consulta l'impostazione dei metadati personalizzati a livello di progetto.
- Per istruzioni sull'impostazione dei metadati dell'istanza, consulta Impostazione dei metadati dell'istanza.
- Chiave:
osconfig-disabled-features
- Valore: può essere uno qualsiasi dei seguenti flag o una combinazione dei seguenti:
osinventory
tasks
guestpolicies
- 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.
- Nella console Google Cloud, vai alla pagina Criteri del sistema operativo.
Fai clic su Abilita la funzionalità completa di VM Manager per abilitare tutte le funzionalità di VM Manager.
- 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.
REST
Per utilizzare gli esempi di API REST in questa pagina in un ambiente di sviluppo locale, utilizzi le credenziali che fornisci a gcloud CLI.
Installa Google Cloud CLI, quindi initialize eseguendo questo comando:
gcloud init
Per maggiori informazioni, consulta Autenticazione per l'utilizzo di REST nella documentazione sull'autenticazione di Google Cloud.
Sistemi operativi supportati
Per l'elenco completo delle versioni del sistema operativo che supportano VM Manager, vedi Dettagli del sistema operativo. Se l'agente OS Config non è disponibile per un determinato sistema operativo, non puoi abilitare VM Manager per una VM che esegue questo sistema operativo.
Abilita VM Manager mediante un criterio dell'organizzazione
Puoi abilitare automaticamente VM Manager per tutte le nuove VM nell'organizzazione, nella cartella o nel progetto utilizzando il criterio dell'organizzazione Richiedi OS Config.
Quando viene configurato il vincolo booleano Richiedi OS Config, vengono applicate le seguenti condizioni:
Abilita criterio dell'organizzazione di OS Config
Per abilitare il criterio di configurazione del sistema operativo, puoi impostare il vincolo di richiesta per la configurazione del sistema operativo nell'intera organizzazione, nelle cartelle o in progetti specifici utilizzando la console Google Cloud o Google Cloud CLI.
Console
Per impostare il criterio dell'organizzazione di OS Config dalla console, completa i seguenti passaggi:
gcloud
Per impostare il criterio dell'organizzazione di OS Config, utilizza il comando
gcloud beta resource-manager org-policies enable-enforce
.Puoi anche applicare il criterio dell'organizzazione OS Config a una cartella o a un progetto con i flag
--folder
o--project
, nonché l'ID cartella e l'ID progetto, rispettivamente.Per le cartelle, esegui questo comando:
gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \ --folder=folder-id
Per i progetti, esegui questo comando:
gcloud beta resource-manager org-policies enable-enforce compute.requireOsConfig \ --project=project-id
Sostituisci quanto segue:
Abilita VM Manager in un progetto
Per abilitare VM Manager nel tuo progetto, hai due opzioni:
Manuale
Per configurare manualmente VM Manager, completa i seguenti passaggi:
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 i passaggi guidati, puoi utilizzare l'abilitazione automatica per completare quanto segue:
Abilita l'API del servizio OS Config
Nel tuo progetto Google Cloud, abilita l'API OS Config.
Console
Nella console Google Cloud, abilita VM Manager (API OS Config).
gcloud
Per abilitare l'API, esegui questo comando:
gcloud services enable osconfig.googleapis.com
Verifica se l'agente OS Config è installato
L'agente OS Config viene 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 in cui è installato l'agente OS Config, consulta i dettagli del sistema operativo. Questi agenti vengono eseguiti in modo inattivo fino a quando non abiliti i metadati dell'agente e attivi l'API di servizio.Linux
Per verificare se l'agente è installato nella tua 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 nella tua 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 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, completa i seguenti passaggi:
Installa l'agente utilizzando uno script di avvio
Puoi anche utilizzare i comandi di installazione manuale per creare uno script di avvio che installa l'agente OS Config durante la creazione della VM.
Impostare i valori dei metadati
Puoi impostare i metadati dell'istanza su ogni VM o metadati di progetto applicabili a tutte le VM nel progetto.
Nel progetto o nella VM Google Cloud, imposta il valore dei metadati
enable-osconfig
suTRUE
. L'impostazione del valore dei metadatienable-osconfig
suTRUE
consente di:Console
Puoi applicare i valori dei metadati ai progetti o alle VM Google Cloud utilizzando una delle seguenti opzioni:
gcloud
Usa il
project-info add-metadata
o il comandoinstances 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:
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:
Per la versione precedente di OS Inventory Management, aggiungi anche la seguente coppia chiave-valore:
configura un proxy HTTP
Se utilizzi un proxy HTTP per le VM, esegui questi comandi per impostare le variabili di ambiente
http_proxy
ehttps_proxy
. Devi anche escludere il server di metadati (169.254.169.254
) configurando la variabile di ambienteno_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 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
ePROXY_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
ePROXY_PORT
rispettivamente con l'indirizzo IP e il numero di porta del server proxy.Google consiglia di escludere
*.googleapis.com.
e*.googleapis.com
aggiungendo la variabile di ambienteno_proxy
per evitare problemi di connessione da parte dell'agente OS Config. Per trovare una corrispondenza con tutte le richieste dei nomi host, specifica entrambi i formati (uno che termina con "." e l'altro senza "."). Se vuoi connettere solo VM specifiche all'agente OS Config, aggiungi il prefisso alla 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à di cui potresti non avere bisogno, puoi disabilitarle impostando i seguenti valori dei metadati:
osconfig-disabled-features=FEATURE1,FEATURE2
.Sostituisci
FEATURE1,FEATURE2
con uno dei seguenti valori:Utilizza uno dei seguenti metodi per disabilitare i valori dei metadati.
Console
Puoi disabilitare i valori dei metadati nei progetti o nelle VM Google Cloud utilizzando una delle seguenti opzioni:
gcloud
Usa il
project-info add-metadata
o il comandogcloud
instances add-metadata
con il flag--metadata=osconfig-disabled-features
.Se stai disabilitando più funzionalità, il flag deve avere il formato
--metadata=osconfig-disabled-features=FEATURE1,FEATURE2
. Vedi l'esempio 2.Esempi
Esempio 1 Per disabilitare le 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:
Requisiti per un agente OS Config attivo
Affinché l'agente OS Config sia considerato attivo e fatturabile, deve soddisfare tutti i seguenti requisiti:
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
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 eOSCONFIG_B
rappresenta l'insieme di funzionalità limitato.REST
Per visualizzare le funzionalità di VM Manager nel progetto Google Cloud, crea una richiesta
GET
per il metodoprojects.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 nell'esempio seguente:
{ "name": "projects/my-project/locations/global/projectFeatureSettings", "patchAndConfigFeatureSet": "OSCONFIG_C" }
Il valore
OSCONFIG_C
rappresenta l'insieme completo di funzionalità di VM Manager eOSCONFIG_B
rappresenta l'insieme di funzionalità limitato.Abilita le funzionalità complete di VM Manager
Se VM Manager non è abilitato nel progetto e installi Ops Agent durante la creazione della VM, VM Manager viene 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 dei 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 in cui è installato Ops Agent:
Console
Vai ai criteri del sistema operativo
gcloud
Per abilitare 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
al metodoprojprojects.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. Il valoreOSCONFIG_C
rappresenta l'insieme completo di funzionalità di VM Manager.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.
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?
Salvo quando diversamente specificato, i contenuti di questa pagina sono concessi in base alla licenza Creative Commons Attribution 4.0, mentre gli esempi di codice sono concessi in base alla licenza Apache 2.0. Per ulteriori dettagli, consulta le norme del sito di Google Developers. Java è un marchio registrato di Oracle e/o delle sue consociate.
Ultimo aggiornamento 2024-06-28 UTC.
[{ "type": "thumb-down", "id": "hardToUnderstand", "label":"Hard to understand" },{ "type": "thumb-down", "id": "incorrectInformationOrSampleCode", "label":"Incorrect information or sample code" },{ "type": "thumb-down", "id": "missingTheInformationSamplesINeed", "label":"Missing the information/samples I need" },{ "type": "thumb-down", "id": "translationIssue", "label":"Problema di traduzione" },{ "type": "thumb-down", "id": "otherDown", "label":"Altra" }] [{ "type": "thumb-up", "id": "easyToUnderstand", "label":"Facile da capire" },{ "type": "thumb-up", "id": "solvedMyProblem", "label":"Il problema è stato risolto" },{ "type": "thumb-up", "id": "otherUp", "label":"Altra" }] -