Sistemi operativi supportati
Per l'elenco completo dei sistemi operativi e delle versioni che supportano OS Inventory Management, consulta Dettagli del sistema operativo.
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni necessarie per elencare e descrivere i dati di inventario,
chiedi all'amministratore di concederti il
ruolo IAM Visualizzatore inventario sistema operativo(roles/osconfig.inventoryViewer)
nel progetto.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.
Configura la VM
Prima di poter utilizzare OS Inventory Management, devi configurare le VM per utilizzare la funzionalità. Per configurare le VM in modo che utilizzino OS Inventory Management, configura VM Manager.
Dopo aver configurato VM Manager sulle VM, puoi visualizzare i dati di inventario del sistema operativo e i report sulle vulnerabilità.
Configura l'intervallo di scansione dell'inventario del sistema operativo
Per impostazione predefinita, l'agente OS Config esegue una scansione dell'inventario su ogni VM ogni 10 minuti. Se le VM registrano un utilizzo elevato della CPU o delle risorse a causa di scansioni frequenti o se hai bisogno di una pianificazione diversa per motivi operativi, puoi modificare la frequenza di scansione impostando la chiave di metadati osconfig-poll-interval.
Specifica il valore osconfig-poll-interval in minuti. Ad esempio, per eseguire una scansione dell'inventario una volta all'ora, imposta osconfig-poll-interval su 60. Per eseguire una scansione una volta ogni 24 ore, imposta il valore su 1440.
Per configurare il valore dei metadati osconfig-poll-interval:
Console
Puoi applicare il valore dei metadati ai tuoi progetti o alle tue VM utilizzando uno dei seguenti metodi:
Imposta i metadati a livello di progetto per applicare l'impostazione a tutte le VM del progetto:
Nella Cloud de Confiance console, vai alla pagina Metadati.
Fai clic su Modifica.
Aggiungi la seguente voce di metadati:
Chiave:
osconfig-poll-interval
Valore: INTERVAL_IN_MINUTESFai clic su Salva.
Imposta i metadati a livello di istanza durante la creazione di una VM:
Nella Cloud de Confiance console, 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 la seguente voce di metadati:
Chiave:
osconfig-poll-interval
Valore: INTERVAL_IN_MINUTES
Per creare la VM, fai clic su Crea.
Imposta i metadati su una VM esistente:
Nella Cloud de Confiance console, 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.
In Metadati, fai clic su Aggiungi elemento e poi aggiungi la seguente voce di metadati:
Chiave:
osconfig-poll-interval
Valore: INTERVAL_IN_MINUTESFai clic su Salva.
Sostituisci INTERVAL_IN_MINUTES con l'intervallo di scansione in minuti. Ad esempio, specifica 60 per un intervallo di scansione di un'ora.
gcloud
Utilizza il comando project-info add-metadata o instances add-metadata con il flag --metadata=osconfig-poll-interval=INTERVAL_IN_MINUTES.
Puoi applicare il valore dei metadati ai tuoi progetti o alle tue VM utilizzando uno dei seguenti metodi:
Imposta i metadati a livello di progetto per applicare l'impostazione a tutte le VM del progetto:
gcloud compute project-info add-metadata \ --project PROJECT_ID \ --metadata=osconfig-poll-interval=INTERVAL_IN_MINUTES
Imposta i metadati a livello di istanza durante la creazione di una VM:
gcloud compute instances create INSTANCE_NAME \ --project PROJECT_ID \ --metadata=enable-osconfig=TRUE,osconfig-poll-interval=INTERVAL_IN_MINUTES
Imposta i metadati su una VM esistente:
gcloud compute instances add-metadata INSTANCE_NAME \ --project PROJECT_ID \ --metadata=osconfig-poll-interval=INTERVAL_IN_MINUTES
Sostituisci quanto segue:
PROJECT_ID: il tuo ID progettoINSTANCE_NAME: il nome dell'istanza VMINTERVAL_IN_MINUTES: l'intervallo di scansione in minuti. Ad esempio, specifica60per un intervallo di scansione di un'ora.
Visualizza i dati di inventario del sistema operativo
Per visualizzare i dati di inventario del sistema operativo, utilizza uno dei seguenti metodi:
- Utilizza la Cloud de Confiance console, gcloud CLI o l'API OS Config
- Utilizza Cloud Asset Inventory
Visualizza i dati di inventario del sistema operativo per una VM
Puoi utilizzare la Cloud de Confiance console, gcloud CLI o l'API OS Config per visualizzare le informazioni sul sistema operativo per una VM specifica.
Console
Per visualizzare le vulnerabilità del sistema operativo e le informazioni sui pacchetti installati su una VM utilizzando la Cloud de Confiance console, segui questi passaggi:
- Nella Cloud de Confiance console, vai alla pagina Istanze VM.
- Fai clic sul nome dell'istanza per cui vuoi visualizzare le informazioni sul sistema operativo. Viene visualizzata la pagina Dettagli istanza.
- Fai clic sulla scheda Informazioni sul sistema operativo.
Per visualizzare i dati dell'inventario del sistema operativo, devi attivare VM Manager. Se la console Cloud de Confiance ti chiede di attivare VM Manager, seleziona una delle seguenti opzioni:- Attiva per il progetto corrente: consente di attivare VM Manager per tutte le VM nel progetto selezionato
- Attiva per questa VM: consente di attivare VM Manager solo per la VM selezionata
- Esamina l'elenco delle vulnerabilità del sistema operativo e dei pacchetti installati nella scheda Informazioni sul sistema operativo.
- (Facoltativo) Se sono disponibili aggiornamenti per uno dei pacchetti installati, seleziona i nomi dei pacchetti e fai clic su Applica aggiornamenti.
Viene visualizzata la pagina Patch. Per saperne di più sull' utilizzo della funzionalità Patch in VM Manager, consulta Creare job di patch.
gcloud
Per visualizzare i dettagli dell'inventario per una VM specifica, esegui il
os-config inventories describe comando:
gcloud compute os-config inventories describe INSTANCE_NAME \
--location=ZONE \
--view=VIEW
Sostituisci quanto segue:
INSTANCE_NAME: il nome della VMZONE: la zona in cui si trova l'istanza VMVIEW: il tipo di informazioni di output richieste. Sono disponibili i seguenti tipi di visualizzazione:basic: visualizza solo le informazioni sul sistema operativofull: visualizza le informazioni sul sistema operativo e sui pacchettiSe non specificato, il valore predefinito è
basic.
Esempio (visualizzazione di base)
gcloud compute os-config inventories describe vm1-centos \ --location=us-central1-c
Output di esempio
architecture: x86_64 hostname: vm1-centos kernelRelease: 3.10.0-1160.92.1.el7.x86_64 kernelVersion: '#1 SMP Tue Jun 20 11:48:01 UTC 2023' longName: CentOS Linux 7 (Core) osconfigAgentVersion: 20230504.00-g1.el7 shortName: centos updateTime: '2023-07-26T17:03:50Z' version: '7'
Esempio (visualizzazione completa)
gcloud compute os-config inventories describe vm1-centos \ --location=us-central1-c \ --view=full
Output di esempio di Linux
┌─────────────────────────────────────────────────────────────────────────────────────┐ │ Installed Packages (Yum) │ ├─────────────────────────────────────┬──────────────┬────────────────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├─────────────────────────────────────┼──────────────┼────────────────────────────────┤ │ GeoIP │ x86_64 │ 1.5.0-13.el7 │ │ NetworkManager │ x86_64 │ 1:1.12.0-8.el7_6 │ │ NetworkManager-libnm │ x86_64 │ 1:1.12.0-8.el7_6 │ │ NetworkManager-team │ x86_64 │ 1:1.12.0-8.el7_6 │ │ NetworkManager-tui │ x86_64 │ 1:1.12.0-8.el7_6 │ │ acl │ x86_64 │ 2.2.51-14.el7 │ │ yum-cron │ all │ 3.4.3-161.el7.centos │ │ yum-metadata-parser │ x86_64 │ 1.1.4-10.el7 │ │ yum-plugin-fastestmirror │ all │ 1.1.31-50.el7 │ │ zlib │ x86_64 │ 1.2.7-18.el7 │ └─────────────────────────────────────┴──────────────┴────────────────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────────┐ │ Package Updates Available (Yum) │ ├───────────────────────────────┬──────────────┬────────────────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├───────────────────────────────┼──────────────┼────────────────────────────────┤ │ GeoIP │ x86_64 │ 1.5.0-14.el7 │ │ NetworkManager │ x86_64 │ 1:1.18.8-2.el7_9 │ │ NetworkManager-libnm │ x86_64 │ 1:1.18.8-2.el7_9 │ │ NetworkManager-team │ x86_64 │ 1:1.18.8-2.el7_9 │ │ yum-cron │ all │ 3.4.3-168.el7.centos │ │ yum-plugin-fastestmirror │ all │ 1.1.31-54.el7_8 │ │ zlib │ x86_64 │ 1.2.7-19.el7_9 │ └───────────────────────────────┴──────────────┴────────────────────────────────┘ architecture: x86_64 hostname: vm1-centos kernelRelease: 3.10.0-957.1.3.el7.x86_64 kernelVersion: '#1 SMP Thu Nov 29 14:49:43 UTC 2018' longName: CentOS Linux 7 (Core) osconfigAgentVersion: 20230504.00-g1.el7 shortName: centos updateTime: '2021-05-11T22:21:52.323Z' version: '7'
Output di esempio di Windows
┌───────────────────────────────────────────────────────────┐ │ Installed Packages (GooGet) │ ├───────────────────────┬──────────────┬────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├───────────────────────┼──────────────┼────────────────────┤ │ google-osconfig-agent │ x86_64 │ 20210415.4.0+win@1 │ └───────────────────────┴──────────────┴────────────────────┘ ┌───────────────────────────────────────────────────┐ │ Installed Packages (Windows Update Agent) │ ├───────┬────────────┬────────────────┬─────────────┤ │ TITLE │ CATEGORIES │ KB_ARTICLE_IDS │ SUPPORT_URL │ ├───────┼────────────┼────────────────┼─────────────┤ │ title │ C1, C2 │ 4589208 │ url.com │ └───────┴────────────┴────────────────┴─────────────┘ ┌───────────────────────────────────────────────────────────────┐ │ Installed Packages (Quick Fix Engineering) │ ├─────────┬─────────────────┬────────────┬──────────────────────┤ │ CAPTION │ DESCRIPTION │ HOT_FIX_ID │ INSTALL_TIME │ ├─────────┼─────────────────┼────────────┼──────────────────────┤ │ caption │ Security Update │ KB4470788 │ 2019-03-12T00:00:00Z │ └─────────┴─────────────────┴────────────┴──────────────────────┘ ┌───────────────────────────────────────────────────────────────────────────┐ │ Installed Packages (Windows Application) │ ├──────────────────┬─────────────────┬───────────────────────┬──────────────┤ │ DISPLAY_NAME │ DISPLAY_VERSION │ PUBLISHER │ INSTALL_DATE │ ├──────────────────┼─────────────────┼───────────────────────┼──────────────┤ │ PowerShell 7-x64 │ 7.0.2.0 │ Microsoft Corporation │ 2021-06-08 │ └──────────────────┴─────────────────┴───────────────────────┴──────────────┘ ┌───────────────────────────────────────────────────────────┐ │ Package Updates Available (GooGet) │ ├───────────────────────┬──────────────┬────────────────────┤ │ PACKAGE_NAME │ ARCHITECTURE │ VERSION │ ├───────────────────────┼──────────────┼────────────────────┤ │ google-osconfig-agent │ x86_64 │ 20210415.4.0+win@1 │ └───────────────────────┴──────────────┴────────────────────┘ ┌───────────────────────────────────────────────────┐ │ Package Updates Available (Windows Update Agent) │ ├───────┬────────────┬────────────────┬─────────────┤ │ TITLE │ CATEGORIES │ KB_ARTICLE_IDS │ SUPPORT_URL │ ├───────┼────────────┼────────────────┼─────────────┤ │ title │ C1, C2 │ 4589208 │ url.com │ └───────┴────────────┴────────────────┴─────────────┘ ┌───────────────────────────────────────────────────────────────┐ │ Package Updates Available (Quick Fix Engineering) │ ├─────────┬─────────────────┬────────────┬──────────────────────┤ │ CAPTION │ DESCRIPTION │ HOT_FIX_ID │ INSTALL_TIME │ ├─────────┼─────────────────┼────────────┼──────────────────────┤ │ caption │ Security Update │ KB4470788 │ 2019-03-12T00:00:00Z │ └─────────┴─────────────────┴────────────┴──────────────────────┘ architecture: x86_64 hostname: vm3-windows kernelRelease: 10.0.17763.1817 kernelVersion: 10.0.17763.1817 (WinBuild.160101.0800) longName: Microsoft Windows Server 2019 Datacenter osconfigAgentVersion: 20210901.00.0+win@1 shortName: windows updateTime: '2021-09-12T22:14:35Z' version: 10.0.17763
REST
Per visualizzare i dettagli dell'inventario per una VM specifica, crea una GET richiesta al
projects.locations.instances.inventories.get metodo.
GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/INSTANCE/inventory
Sostituisci quanto segue:
PROJECT_ID: il tuo ID progettoZONE: la zona in cui si trova l'istanza VMINSTANCE: specifica l'ID dell'istanza o il nome della VM
Visualizza i dati di inventario del sistema operativo per le VM in una zona specifica
Puoi utilizzare gcloud CLI o l'API OS Config per visualizzare le informazioni sul sistema operativo per le VM in una zona specifica.
gcloud
Per visualizzare un elenco di dati di inventario per le VM in una zona specifica, esegui il
os-config inventories list comando.
gcloud compute os-config inventories list \
--location=ZONE \
--view=VIEW
Sostituisci quanto segue:
ZONE: la zona in cui si trova la VMVIEW: il tipo di informazioni di output richieste. Sono disponibili i seguenti tipi di visualizzazione:basic: visualizza solo le informazioni sul sistema operativofull: visualizza le informazioni sul sistema operativo e sui pacchettiSe non specificato, il valore predefinito è
basic.
Esempio (visualizzazione di base)
gcloud compute os-config inventories list \ --location=us-central1-c
L'output è simile al seguente:
INSTANCE_ID INSTANCE_NAME OS OSCONFIG_AGENT_VERSION UPDATE_TIME 29255009728795105 vm1-centos CentOS Linux 7 (Core) 20230504.00-g1.el7 2023-07-26T16:53:49Z 5138980234596718741 vm2-rhel8 Red Hat Enterprise Linux 8.8 (Ootpa) 20230504.00-g1.el8 2023-07-26T16:55:33Z 7127836223366142250 vm3-windows Microsoft Windows Server 2022 Datacenter 20230403.00.0+win@1 2023-07-26T16:49:16Z
Esempio (visualizzazione completa)
gcloud compute os-config inventories list \ --location=us-central1-c \ --view=full
L'output è simile al seguente:
INSTANCE_ID INSTANCE_NAME OS INSTALLED_PACKAGES AVAILABLE_PACKAGES OSCONFIG_AGENT_VERSION UPDATE_TIME 29255009728795105 vm1-centos CentOS Linux 7 (Core) 334 2 20230504.00-g1.el7 2023-07-26T16:53:49Z 5932621394110773366 vm2-rhel8 Red Hat Enterprise Linux 8.8 (Ootpa) 410 138 20230504.00-g1.el8 2023-07-26T16:55:33Z 7127836223366142250 vm3-windows Microsoft Windows Server 2022 Datacenter 36 6 20230403.00.0+win@1 2023-07-26T16:49:16Z
REST
Per visualizzare un elenco di dati di inventario per le VM in una zona specifica, crea una
GET richiesta al
projects.locations.instances.inventories.list metodo.
GET https://osconfig.googleapis.com/v1/projects/PROJECT_ID/locations/ZONE/instances/-/inventories
Sostituisci quanto segue:
PROJECT_ID: il tuo ID progettoZONE: la zona in cui si trovano le VM
Visualizza i dati di inventario del sistema operativo da Cloud Asset Inventory
OS Inventory Management archivia e inoltra i dati dell'inventario e dei report sulle vulnerabilità a Cloud Asset Inventory. Cloud Asset Inventory è un servizio di inventario di metadati che consente di visualizzare, monitorare e analizzare gli asset in Cloud de Confiance by S3NS. Da Cloud Asset Inventory puoi eseguire il polling delle informazioni e visualizzare le modifiche ai dati.
Per accedere ai dati dell'inventario e dei report sulle vulnerabilità del sistema operativo da Cloud Asset Inventory, devi completare la seguente configurazione:
- Configura VM Manager.
- Nel progetto Cloud de Confiance , abilita API Cloud Asset Inventory e Google Cloud CLI e assegna le autorizzazioni.
Per ulteriori informazioni, consulta Visualizzazione dei dati di VM Manager.
OS Inventory Management (versione precedente)
Se utilizzi ancora la versione precedente di OS Inventory Management, espandi la sezione seguente per esaminare le istruzioni per il Google Cloud CLI.
OS Inventory Management (versione precedente)
Elenca le VMPer visualizzare l'elenco delle VM su cui è configurato OS Inventory Management, esegui il instances
os-inventory list-instances comando.
Ad esempio, per elencare tutte le VM con dati di inventario, esegui il seguente comando:
gcloud compute instances os-inventory list-instances
L'output è simile al seguente:
NAME ZONE MACHINE_TYPE PREEMPTIBLE INTERNAL_IP EXTERNAL_IP STATUS inventory-instance us-east1-b e2-standard-2 192.0.2.1 RUNNING instance-inventory1 us-west1-b e2-standard-2 192.0.2.2 RUNNING instance-inventory2 asia-east2-b e2-standard-2 192.0.2.3 RUNNING
Puoi anche utilizzare i filtri per restringere i risultati. Ad esempio, puoi
elencare tutte le VM su cui è configurato OS Inventory Management e il cui nome host corrisponde
all'espressione regolare instance-* eseguendo il seguente comando:
gcloud compute instances os-inventory list-instances
--inventory-filter="Hostname~instance-*"L'output è simile al seguente:
NAME ZONE MACHINE_TYPE PREEMPTIBLE INTERNAL_IP EXTERNAL_IP STATUS inventory-instance us-east1-b e2-standard-2 192.0.2.1 RUNNING instance-inventory1 us-west1-b e2-standard-2 192.0.2.2 RUNNING instance-inventory2 asia-east2-b e2-standard-2 192.0.2.3 RUNNING
Per visualizzare i dati di inventario della VM, utilizza il instances
os-inventory describe comando.
Per visualizzare i dati di inventario raccolti per una VM, esegui il seguente comando:
gcloud compute instances os-inventory describe INSTANCE_NAME \
--zone=ZONESostituisci quanto segue:
INSTANCE_NAME: il nome della VMZONE: la zona in cui si trova la VM
Per visualizzare i tipi di dettagli di output restituiti, consulta Informazioni fornite da OS Inventory Management.