Manutenzione dell'ambiente per la soluzione Bare Metal

Dopo che l'ambiente Bare Metal Solution è in esecuzione, utilizza le informazioni incluse in questa guida per mantenere i server, la capacità di archiviazione e il networking di Bare Metal Solution.

Configura il tuo progetto Google Cloud per l'utilizzo dell'API Bare Metal Solution

L'API Bare Metal Solution fornisce molti strumenti che consentono di monitorare e gestire l'ambiente di Bare Metal Solution. In genere, devi utilizzare questa procedura solo la prima volta che utilizzi l'API Bare Metal Solution. Tuttavia, riutilizza queste istruzioni per risolvere i problemi nel caso in cui l'API non risponda come previsto.

Assegna il ruolo IAM predefinito Amministratore di soluzione Bare Metal o Editor soluzione Bare Metal alle entità. Per informazioni su come mappare i ruoli IAM, vedi Concedere un ruolo IAM.
Attiva l'API Bare Metal Solution nel tuo progetto Cloud.

Nota: per abilitare un servizio API, devi disporre di un ruolo IAM che ti conceda l'autorizzazione ad attivare servizi, ad esempio Proprietario o Amministratore utilizzo servizi. Per ulteriori informazioni, consulta la sezione Controllo dell'accesso.
Console
1. Vai all'API Barre Metal Solution nella tua dashboard di Google Cloud Console. Puoi anche cercare l'API Bare Metal Solution nella libreria API qui: APIs & Services > Library.
2. Nella pagina API Barre Metal Solution, fai clic su Abilita.
3. Fai clic sul pulsante Indietro del browser. Se visualizzi un segno di spunta verde accanto alle parole API abilitata, puoi utilizzare l'API.
gcloud
- Per abilitare l'API Bare Metal Solution tramite gcloud, inserisci il tuo ID progetto interfaccia a riga di comando gcloud nel comando seguente, copia il comando, incollalo nel prompt di Cloud Shell e premi Invio o Invio
```
 gcloud services enable baremetalsolution.googleapis.com --project=PROJECT_ID
 
```
Consenti all'interfaccia a riga di comando di Google Cloud di lavorare con il tuo progetto cloud.
1. Nella finestra di Cloud Shell, inserisci il comando gcloud auth login.
```
gcloud auth login
```
2. Copia l'URL risultante e incollalo in una scheda o in una finestra del browser separata.
3. Accedi alla pagina utilizzando il tuo nome utente associato al tuo progetto Cloud.
4. Fai clic su Consenti per abilitare l'interfaccia a riga di comando gcloud.
5. Copia il codice di autorizzazione.
6. Incolla il codice nella riga di comando del client Cloud Shell.
7. Premi il tasto Invio.

Per ulteriori informazioni sui passaggi generali necessari per configurare un'API in Google Cloud, consulta la guida introduttiva alle API di Google Cloud.

Utilizza il tuo server Bare Metal Solution

Sul server possono essere eseguite diverse operazioni, ad esempio riavvio e accensione. Utilizza i seguenti comandi con il tuo server.

gcloud

Per spegnere e riavviare il server Bare Metal Solution, procedi nel seguente modo.
1. Assicurati di seguire i passaggi di configurazione dell'API.
  
  Il riavvio di un server richiede l'abilitazione dell'API Bare Metal Solution e dell'interfaccia a riga di comando gcloud. Devi inoltre concedere il ruolo IAM Bare Metal Solution Admin o Bare Metal Solution Editor alle tue entità. Per completare i passaggi della configurazione, consulta Configurare il progetto Google Cloud per utilizzare l'API Bare Metal Solution.
2. Per spegnere e riavviare un server Bare Metal Solution, esegui il comando gcloud bms instances reset:
  
  Nota: per impostazione predefinita, questo comando viene eseguito in modalità sincrona e ti impedisce di emettere altri comandi fino al completamento dell'operazione. Se hai un ambiente automatico o devi lavorare ad altre attività durante l'operazione di riavvio, aggiungi l'opzione --async per eseguire questo comando in modalità asincrona.
```
gcloud bms instances reset SERVER_NAME --project=PROJECT_ID --region=REGION
```
  L'output mostra lo stato della richiesta di riavvio del server.
```
Reset request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
  Dopo aver inserito il comando, il server Bare Metal Solution si riavvia. Il riavvio richiede da 15 a 60 minuti, a seconda della configurazione del server.
  
  L'output di questo comando fornisce un ID operazioni che puoi usare per verificare lo stato del riavvio. Per utilizzare l'ID operazione e visualizzare lo stato del riavvio, vedi Visualizzare lo stato di un'operazione a lunga esecuzione.
Per accendere il server, utilizza il comando gcloud bms instances start.

Nota: per impostazione predefinita, questo comando viene eseguito in modalità sincrona e ti impedisce di emettere altri comandi fino al completamento dell'operazione. Se hai un ambiente automatico o devi lavorare su altre attività durante l'operazione di avvio, aggiungi l'opzione --async per eseguire questo comando in modalità asincrona.
```
gcloud bms instances start SERVER_NAME --project=PROJECT_ID --region=REGION
```
L'output mostra lo stato della richiesta di riavvio del server.
```
Start request issued for: [SERVER_NAME]

Waiting for operation [operations/880d346a-4836-4467-acc4-29e6a430bfdd] to complete...done.
```
Nella maggior parte dei casi, il server rimane acceso. Se devi staccare la corrente, utilizza le seguenti opzioni:
- Utilizza i comandi di arresto del sistema operativo del server.
- Alcune applicazioni disattivano automaticamente l'alimentazione dal server dopo una nuova immagine.

API

Per spegnere e riavviare il server Bare Metal Solution, procedi nel seguente modo.
1. Assicurati di seguire i passaggi di configurazione dell'API.
  
  Il riavvio di un server richiede l'abilitazione dell'API Bare Metal Solution e dell'interfaccia a riga di comando gcloud. Devi inoltre concedere il ruolo IAM Amministratore soluzione Bare Metal o Editor soluzione Bare Metal. Per completare i passaggi della configurazione, consulta Configurare il progetto Google Cloud per utilizzare l'API Bare Metal Solution.
2. Accedi al server Bare Metal Solution per riavviare il server.
  - Apri una finestra di Cloud Console.
  - Accedi all'istanza VM dell'host jump: Compute Engine > Istanze VM
  - Fai clic sul pulsante SSH per connetterti all'istanza VM dell'host jump.
  - Per accedere al server Bare Metal Solution, inserisci il comando SSH nella riga di comando dell'host jump.
```
[username@instance-jump-host ~]$ ssh customeradmin@bms-ip-address>
customeradmin@bms-ip-address's password: bms-password
Last login: Mon Mar 15 22:43:19 2022 from bms-ip-address
[customeradmin@BMS_SERVER_NAME ~]$
```
  - Inserisci il comando top per verificare che il server sia in esecuzione. Puoi utilizzare questa finestra per monitorare l'avanzamento del riavvio.
3. Esegui il comando di riavvio
  - Apri la finestra di Cloud Shell.
  - Aggiungi l'ID progetto Cloud, l'area geografica e il nome del server Cloud Bar Solution al comando seguente.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/BMS_SERVER_NAME:reset"
```
    Nota: la versione V2 di questo comando ha sostituito la versione V1. Ti consigliamo di utilizzare la versione V2 di questo comando.
  - Copia e incolla il comando nella finestra di Cloud Shell e premi il tasto Invio o Return.
    
    Il server di Bare Metal Solution si riavvia. Il riavvio richiede da 15 a 60 minuti per essere completato, a seconda della configurazione del server.
    
    L'output di questo comando fornisce un ID operazioni che puoi usare per verificare lo stato del riavvio. Per utilizzare l'ID operazione e visualizzarne lo stato, consulta Visualizzare lo stato di un'operazione a lunga esecuzione.
```
{
 "name": "operations/5c0c8b3f-5edc-4117-be9f-812af9740aaf"
}
```
    Durante il riavvio del server, non puoi utilizzare ping o SSH dall'istanza VM dell'host jump per raggiungere il server Bare Metal Solution. Dopo alcuni minuti, il server di soluzione Bare Metal torna online.
    
    Quando il server torna online, puoi inviare un ping o utilizzare SSH dalla tua istanza VM dell'host jump per raggiungere il server Bare Solution.
    
    Nota: il riavvio richiede 15-60 minuti. Se riprova a inviare il comando di riavvio prima che il server sia pronto, riceverai un messaggio di errore. Attendi ed esegui di nuovo il comando quando il server è di nuovo online.
Per ulteriori informazioni sul riavvio del server Bare Metal Solution, consulta l'API Barare Metal Solution.
Per accendere il server, inserisci l'ID progetto, l'area geografica e il nome del server, quindi esegui il seguente comando curl.
```
curl -X POST \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME:start"
```
Nella maggior parte dei casi, il server rimane acceso. Se devi staccare la corrente, utilizza le seguenti opzioni:
- Utilizza i comandi di arresto del sistema operativo del server.
- Alcune applicazioni disattivano automaticamente l'alimentazione dal server dopo una nuova immagine.

Gestisci le risorse nel tuo ambiente Bare Metal Solution

Le API Bare Metal Solution Management, i comandi gcloud e Google Cloud Console consentono di visualizzare lo stato delle risorse nel tuo ambiente Bare Metal Solution, come server, networking e archiviazione.

Assicurati di configurare l'API Bare Metal Solution

Per visualizzare lo stato delle risorse è necessario abilitare l'API Bare Metal Solution e l'interfaccia a riga di comando gcloud. Devi inoltre concedere uno dei ruoli IAM Bare Metal Solution alle tue entità, ad esempio Amministratore soluzione Bare Metal o Editor soluzione Bare Metal. Per completare i passaggi di configurazione dell'API prima di gestire le risorse, consulta la pagina Configurare il progetto Google Cloud per utilizzare l'API Bare Metal Solution.

Visualizza i server nel tuo ambiente Bare Metal Solution

Quando esegui comandi per chiamare le API di gestione della soluzione Bare Metal, puoi avere informazioni sullo stato dei dispositivi nell'ambiente Bare Metal Solution. Per visualizzare lo stato corrente, scegli una delle seguenti opzioni di comando:

Console

Puoi controllare lo stato dei server Bare Metal Solution e i relativi componenti di networking e archiviazione associati in Cloud Console.

Vai a Compute Engine > Soluzione Bare Metal > Server.

Visualizza le informazioni disponibili.

Campo	Descrizione	Esempio
Stato	Indica la disponibilità di un server	Un cerchio verde con un segno di spunta indica che il server è stato sottoposto a provisioning ed è disponibile.
ID	Identificatore assegnato al server. Fai clic sull'ID per visualizzare le informazioni di base sul server. Condividi l'ID con l'assistenza Google Cloud quando risolvi i problemi di questa risorsa.	`at-1234567-svr001`
Nome	Nome del server. Fai clic sul nome per visualizzare ulteriori informazioni sul server. Nota: se non hai inserito un nome quando hai eseguito il provisioning del tuo server, in questo campo viene visualizzato l'ID.	`server-1`
Località	Area geografica soluzione Bare Metal	`asia-southeast1`
Tipo di server	Specifiche del server	`o2-standard-32-metal`
IP client	Indirizzo IP del server che si connette al Virtual Private Cloud di Google	`10.200.0.5`
IP privato	Indirizzo IP del server che si connette ad altre risorse dell'ambiente Bare Metal Solution	`192.168.2.5`
Etichette	Visualizza tutte le etichette che hai aggiunto a questo server Puoi utilizzare le etichette per filtrare l'output della console copiando il testo di un'etichetta e incollandolo nella casella Filtro appena sopra il campo Stato.	`environment:test`

Per visualizzare ulteriori informazioni sul server e sulle sue funzionalità di networking e archiviazione, fai clic su Nome del server.
- Nella sezione Informazioni di base, puoi scoprire se il server supporta iperthreading.
- In Networking, puoi visualizzare i nomi delle interfacce di rete, i tipi di interfaccia (client o privato), gli indirizzi IP e gli indirizzi MAC.
- Per lo spazio di archiviazione, puoi visualizzare le informazioni sull'unità logica (LUN), come stato, nome, volume, dimensioni e tipo. Puoi anche vedere se il LUN è condivisibile e avviabile.

gcloud

Per elencare i server nell'ambiente Bare Metal Solution e visualizzarne lo stato, inserisci l'ID progetto ed esegui il comando gcloud bms instances list:
```
gcloud bms instances list --project=PROJECT_ID
```
L'esempio di output che segue mostra le informazioni di un server, tra cui nome, tipo, indirizzi IP e stato.
```
NAME               PROJECT              REGION           MACHINE_TYPE          IP_ADDRESSES             STATE
SERVER_NAME      PROJECT_ID        REGION         o2-standard-32-metal  192.168.1.1,192.168.2.1  RUNNING
```
Altre opzioni di comando includono:
- --region: visualizza i dispositivi in un'area geografica specifica di Google Cloud.
- --limit: limita l'output in modo che mostri un numero specifico di dispositivi

Per recuperare le informazioni di rete e di archiviazione per un server specifico nel tuo ambiente Barre Metal Solution, inserisci il nome del server, l'ID progetto e l'area geografica ed esegui il comando gcloud bms instances describe:

gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION

L'esempio di output seguente mostra un server operativo con 12 LUN, una rete client 192.168.1.1 e una rete privata 192.168.2.1.

luns:
- bootLun: true
  name: SERVER_NAME-lun000-b1
  sizeGb: '200'
  state: READY
  storageVolume: SERVER_NAME-vol000-b1
- name: STORAGE_DEVICE_NAME-lun001
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun002
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun003
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun004
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun005
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun006
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun007
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun008
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun009
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun010
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun011
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
- name: STORAGE_DEVICE_NAME-lun012
  sizeGb: '85'
  state: READY
  storageVolume: STORAGE_DEVICE_NAME-vol001
machineType: o2-standard-32-metal
name: projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME
networks:
- ipAddress: 192.168.1.1
  macAddress:
  - 34:80:0D:52:AF:28
  - 34:80:0D:15:3E:0D
  network: STORAGE_DEVICE_NAME-vlan001
- ipAddress: 192.168.2.1
  macAddress:
  - 34:80:0D:52:AF:38
  - 34:80:0D:15:3E:1D
  network: STORAGE_DEVICE_NAME-vlan002
state: RUNNING

Per aggiungere, aggiornare o rimuovere etichette per i server, esegui il comando gcloud bms instances update. Puoi utilizzare le seguenti opzioni:
- --update-labels: Aggiunge etichette alle risorse in modo da poter filtrare l'output dei comandi di stato. Devi aggiungere ogni etichetta con una coppia chiave-valore, ad esempio environment = test.
- --remove-labels: rimuove etichette specifiche
- --clear-labels: rimuove tutte le etichette
Di seguito è riportato un comando di esempio che aggiunge le etichette environment = dev e location = branch e rimuove l'etichetta department da un server:
```
gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=branch --remove-labels=department
```
Il seguente comando rimuove tutte le etichette da un server:
```
gcloud bms instances update SERVER_NAME --project=PROJECT_ID --region=REGION --clear-labels
```
Per visualizzare le modifiche alle etichette del server, esegui il comando seguente:
```
gcloud bms instances describe SERVER_NAME --project=PROJECT_ID --region=REGION
```
Per utilizzare un'etichetta per filtrare l'output di un comando gcloud bms instances list, aggiungi --filter labels.KEY=VALUE alla fine del comando. L'esempio seguente limita l'output per un server etichettato con la coppia chiave-valore ambiente = dev.
```
gcloud bms instances list --project=PROJECT_ID --region=REGION --filter labels.environment=dev
```

API

Apri una finestra del terminale Cloud Shell in Google Cloud Console.
Per elencare i server nell'ambiente Bare Metal Solution e visualizzarne lo stato, inserisci l'ID progetto e l'area geografica nel seguente comando curl, copia il comando, incollalo nel messaggio di richiesta di Cloud Shell e premi il tasto Invio o Invio:
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"
```

Per recuperare le informazioni di rete e di archiviazione per un server nel tuo ambiente soluzione Bare Metal, esegui il comando seguente:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME"

Per aggiungere etichette a un server, inserisci l'ID progetto, l'area geografica e il nome del server nel seguente comando curl. La coppia chiave-valore in questo esempio assegna un'etichetta ambiente = test. Copia il comando, incollalo nel prompt di Cloud Shell e premi il tasto Invio oppure INVIO:

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances/SERVER_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Per utilizzare un'etichetta per filtrare l'output di un comando curl GET per un server Cloud Solution, inserisci l'ID progetto e l'area geografica, quindi aggiungi ?filter=labels.KEY=VALUE alla fine del comando. L'esempio seguente limita l'output per trovare i server con l'etichetta della coppia chiave-valore ambiente = test.
```
curl -X GET -H \
"Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/instances"?filter=labels.environment=test
```

Visualizza le reti nel tuo ambiente Bare Metal Solution

Il monitoraggio delle risorse di rete nell'ambiente Bare Metal Solution ti consente di sapere come i server si connettono ad altre risorse. Per controllare lo stato della rete, scegli una delle seguenti opzioni:

Console

In Google Cloud Console, vai a Compute Engine > Soluzione Bare Metal > Reti.

Visualizza le informazioni disponibili.

Campo	Descrizione	Esempio
Stato	Indica la disponibilità di una rete	Un cerchio verde con un segno di spunta indica che il provisioning della rete è stato eseguito ed è disponibile.
ID	Identificatore assegnato alla tua rete. Fai clic sull'ID per visualizzare informazioni di base sulla rete. Condividi l'ID con l'assistenza Google Cloud quando risolvi i problemi di questa risorsa.	`at-1234567-vlan001`
Nome	Nome della rete. Fai clic sul nome per visualizzare ulteriori informazioni sulla rete. Nota: se non hai inserito un nome al momento del provisioning della rete, in questo campo verrà visualizzato l'ID.	`network-1`
Località	Area geografica in cui si trova la rete	`asia-southeast1`
Tipo	Client o rete privata	`Client`
ID cliente	Intervallo di indirizzi IP per la rete	`192.168.1.0/24`
ID VLAN	Identificatore VLAN assegnato da Google Cloud	`100`
Etichette	Visualizza tutte le etichette che hai aggiunto a questa risorsa di networking Puoi utilizzare le etichette per filtrare l'output della console copiando il testo di un'etichetta e incollandolo nella casella Filtro appena sopra il campo Stato.	`environment:test`

gcloud

Per visualizzare tutte le reti nel tuo ambiente Bare Metal Solution e controllarne lo stato, inserisci il tuo ID progetto ed esegui il comando gcloud bms networks list.
```
gcloud bms networks list --project=PROJECT_ID
```
L'esempio di output seguente mostra nome, area geografica, intervallo di indirizzi IP, tipo di rete e ID VLAN per ciascuna rete.
```
NAME                REGION           RANGE           TYPE     VLAN_ID
at-1111111-vlan001  REGION         192.168.1.0/24  CLIENT   122
at-1111111-vlan002  REGION         192.168.2.0/24  PRIVATE  123
```

Per visualizzare i dettagli di una singola rete, inserisci l'ID progetto, l'area geografica e il nome della rete ed esegui il comando gcloud bms networks describe:

gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION

L'esempio di output seguente mostra i dettagli relativi a intervallo di indirizzi IP, nome della rete, stato, tipo di rete, ID VLAN e routing e forwarding virtuali.

cidr: 192.168.1.0/24
name: projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME
state: PROVISIONED
type: CLIENT
vlanId: '122'
vrf:
  autonomousSystemNumber: '65500'
  juniperAlias: g00000-at-1111111-ic001
  name: at-1111111-ic001
  routeTarget: '282'
  state: PROVISIONED

Per aggiungere, aggiornare o rimuovere etichette per le reti, esegui il comando gcloud bms networks update. Puoi utilizzare le seguenti opzioni:
- --update-labels: Aggiunge etichette alle risorse in modo da poter filtrare l'output dei comandi di stato. Devi aggiungere ogni etichetta con una coppia chiave-valore, ad esempio environment = test.
- --remove-labels: rimuove etichette specifiche
- --clear-labels: rimuove tutte le etichette
Di seguito è riportato un comando di esempio che aggiunge le etichette environment = dev e location = Downtown e rimuove l'etichetta cost-center da una rete:
```
gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --update-labels environment=dev,location=downtown --remove-labels=cost-center
```
Il comando seguente rimuove tutte le etichette da una rete:
```
gcloud bms networks update NETWORK_NAME --project=PROJECT_ID --region=REGION --clear-labels
```
Per visualizzare le modifiche alle etichette di rete, esegui il comando seguente:
```
gcloud bms networks describe NETWORK_NAME --project=PROJECT_ID --region=REGION
```
Per utilizzare un'etichetta per filtrare l'output di un comando gcloud bms networks list, aggiungi --filter labels.KEY=VALUE alla fine del comando. L'esempio seguente limita l'output per una rete con etichetta nella coppia chiave-valore ambiente = dev.
```
gcloud bms networks list --project=PROJECT_ID --region=REGION --filter labels.environment=dev
```

API

Apri una finestra del terminale Cloud Shell in Cloud Console.

Per visualizzare tutte le reti nel tuo ambiente Bare Metal Solution e visualizzarne lo stato, inserisci l'ID progetto e l'area geografica nel seguente comando curl. Copia il comando, incollalo nel prompt di Cloud Shell e premi il tasto Invio o Return:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"

Per visualizzare i dettagli di una singola rete, inserisci l'ID progetto, l'area geografica e il nome della rete ed esegui il comando seguente:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME"

Per aggiungere etichette a una rete, inserisci l'ID progetto, l'area geografica e il nome della rete, quindi esegui il comando curl seguente. La coppia chiave-valore in questo esempio assegna un'etichetta ambiente = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks/NETWORK_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Per utilizzare un'etichetta per filtrare l'output di un comando curl GET per una rete Barre Metal Solution, inserisci l'ID progetto e l'area geografica, quindi aggiungi ?filter=labels.KEY=VALUE alla fine del comando. L'esempio seguente limita l'output per trovare le reti con l'etichetta della coppia chiave-valore environment = test.
```
curl -X GET -H \
"Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/networks"?filter=labels.environment=test
```

Visualizza lo spazio di archiviazione nell'ambiente Bare Metal Solution

Prestare attenzione alle risorse di archiviazione nell'ambiente Bare Metal Solution ti aiuta a determinare se i tuoi server hanno una capacità di archiviazione sufficiente per applicazioni e carichi di lavoro. Per visualizzare lo stato dell'archiviazione, scegli una delle seguenti opzioni:

Console

In Cloud Console, vai a Compute Engine > soluzione Bare Metal > volumi.

Visualizza le informazioni disponibili.

Campo	Descrizione	Esempio
Stato	Indica la disponibilità di un volume di archiviazione	Un cerchio verde con un segno di spunta indica che il volume dello spazio di archiviazione è pronto.
ID	Identificatore assegnato al volume di archiviazione. Fai clic sull'ID per visualizzare le informazioni di base sul volume di archiviazione, inclusi LUN e snapshot. Condividi l'ID con l'assistenza Google Cloud durante la risoluzione dei problemi di questa risorsa.	Volume di avvio: `at-1234567-svr001-vol000-b1` Volume canale fibra: `at-1111111-vol001` Condivisione NFS: `at-2222222-nfs001-vol000`
Nome	Nome del volume di archiviazione. Fai clic sul nome per visualizzare ulteriori informazioni sul volume di archiviazione, inclusi LUN e snapshot. Nota: se non hai inserito un nome al momento del provisioning del volume di archiviazione, in questo campo viene visualizzato l'ID.	Volume di avvio: `boot-volume-1` Volume canale fibra: `fibre-channel-volume-5` Condivisione NFS: `nfs-share-7`
Località	Area geografica in cui si trova il volume di archiviazione	`asia-southeast1`
Tipo	Disco rigido o unità a stato solido	`HDD - Hard drive`
Etichette	Visualizza tutte le etichette che hai aggiunto a questa risorsa di archiviazione Puoi utilizzare le etichette per filtrare l'output della console copiando il testo di un'etichetta e incollandolo nella casella Filtro appena sopra il campo Stato.	`environment:test`

gcloud

Per visualizzare tutti i volumi di archiviazione nel tuo ambiente Bare Metal Solution e visualizzare il loro stato, inserisci l'ID progetto ed esegui il comando gcloud bms volumes list:

gcloud bms volumes list --project=PROJECT_ID

L'esempio di output seguente mostra tre volumi di archiviazione: ID progetto, area geografica, dimensioni del volume e tipo di archiviazione.

NAME                         PROJECT              REGION           REQUESTED_SIZE_GIB  STORAGE_TYPE  STATE
at-1234567-svr001-vol000-b1  PROJECT_ID         REGION         200                 SSD           READY
at-1111111-vol001            PROJECT_ID         REGION         1024                SSD           READY
at-2222222-nfs001-vol000     PROJECT_ID         REGION         400                 HDD           READY

Per visualizzare un singolo volume di archiviazione, inserisci il nome, l'ID progetto e l'area geografica del volume di archiviazione, quindi esegui il comando gcloud bms volumes describe:

gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION

L'esempio di output seguente mostra dimensione del volume di archiviazione, nome, criterio di eliminazione automatica snapshot, stato e tipo di archiviazione.

currentSizeGib: '250'
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME
requestedSizeGib: '250'
snapshotAutoDeleteBehavior: OLDEST_FIRST
snapshotReservationDetail:
  reservedSpaceGib: '50'
  reservedSpaceRemainingGib: '50'
state: READY
storageType: SSD

Per aggiungere, aggiornare o rimuovere etichette per i volumi di archiviazione, esegui il comando gcloud bms volumes update. Puoi utilizzare le seguenti opzioni:
- --update-labels: Aggiunge etichette alle risorse in modo da poter filtrare l'output dei comandi di stato. Devi aggiungere ogni etichetta con una coppia chiave-valore, ad esempio environment = production.
- --remove-labels: rimuove etichette specifiche
- --clear-labels: rimuove tutte le etichette
Di seguito è riportato un comando di esempio che aggiunge le etichette environment = production e location = hq e rimuove l'etichetta rack da un volume di archiviazione:
```
gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --update-labels environment=production,location=hq --remove-labels=rack
```
Il seguente comando rimuove tutte le etichette da un volume di archiviazione:
```
gcloud bms volumes update VOLUME_NAME --project=PROJECT_ID --region=REGION --clear-labels
```
Per visualizzare le modifiche alle etichette del volume di archiviazione, esegui il comando seguente:
```
gcloud bms volumes describe VOLUME_NAME --project=PROJECT_ID --region=REGION
```
Per utilizzare un'etichetta per filtrare l'output di un comando gcloud bms volumes list, aggiungi --filter labels.KEY=VALUE alla fine del comando. L'esempio seguente limita l'output del volume di archiviazione etichettato con la coppia chiave-valore ambiente = produzione.
```
gcloud bms volumes list --project=PROJECT_ID --region=REGION --filter labels.environment=production
```
Per visualizzare tutti i LUN per il volume di archiviazione, inserisci l'ID progetto, l'area geografica e il nome del volume di archiviazione ed esegui il comando gcloud bms volumes luns list:
```
gcloud bms volumes luns list --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
```
L'esempio di output seguente mostra i nomi di LUN, area geografica, nome del volume di archiviazione, dimensioni del volume e stato.
```
NAME                         REGION           VOLUME       SIZE_GB  STATE
at-11111111-vol001-lun000    REGION        VOLUME_NAME 200      READY
```
Per visualizzare i dettagli di un singolo LUN, inserisci l'ID progetto, l'area geografica e il nome LUN ed esegui il comando gcloud bms volumes luns describe:
```
gcloud bms volumes luns describe LUN_NAME --project=PROJECT_ID --region=REGION --volume=VOLUME_NAME
```
L'esempio di output seguente mostra le informazioni relative a nome LUN e volume di archiviazione, ad esempio dimensione, stato, tipo di archiviazione, nome e ID.
```
bootLun: true
name: projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME
sizeGb: '200'
state: READY
storageType: SSD
storageVolume: VOLUME_NAME
wwid: 600a09803831434434244f774d616b94
```

API

Apri una finestra del terminale Cloud Shell in Cloud Console.
Per visualizzare tutti i volumi di archiviazione nel tuo ambiente Bare Metal Solution e visualizzare il loro stato, inserisci l'ID progetto e l'area geografica nel seguente comando curl. Copia il comando, incollalo nel messaggio di Cloud Shell e premi il tasto Invio:
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"
```
Nota: quando è in corso un aggiornamento del volume, il campo dello stato viene visualizzato come Creazione. Al termine dell'aggiornamento del volume, il campo di stato viene visualizzato come Pronto.

Per visualizzare un singolo volume di archiviazione, inserisci ID progetto, area geografica e nome del volume di archiviazione ed esegui il comando seguente:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME"

Per visualizzare tutti i LUN (logic unit number) del volume di archiviazione, inserisci l'ID progetto, l'area geografica e il nome del volume di archiviazione, quindi esegui il seguente comando:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns

Per visualizzare i dettagli relativi a un singolo LUN, inserisci l'ID progetto, l'area geografica, il nome del volume di archiviazione e il nome LUN, quindi esegui il seguente comando:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME/luns/LUN_NAME"

Per aggiungere etichette a un volume di archiviazione, inserisci ID progetto, area geografica e nome del volume di archiviazione, quindi esegui il comando curl riportato di seguito. La coppia chiave-valore in questo esempio assegna un'etichetta ambiente = test.

curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes/VOLUME_NAME?updateMask=labels"
 -d "{
  'labels' : {'environment': 'test'}
}"

Per utilizzare un'etichetta per filtrare l'output di un comando curl GET per un volume di archiviazione di Bare Metal Solution, inserisci l'ID e l'area geografica del progetto, quindi aggiungi ?filter=labels.KEY=VALUE alla fine del comando. L'esempio seguente limita l'output per trovare i volumi di archiviazione con l'etichetta della coppia chiave-valore environment = test.
```
curl -X GET -H \
"Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/volumes"?filter=labels.environment=test
```

Visualizza l'archiviazione di file NFS nel tuo ambiente Bare Metal Solution

Dopo aver ordinato e eseguito il provisioning di NFS per Bare Metal Solution, puoi visualizzare lo stato dell'archiviazione di file NFS e verificare che Google Cloud abbia implementato le impostazioni configurate come previsto. Per visualizzare lo stato corrente, scegli una delle seguenti opzioni di comando:

Console

In Cloud Console, vai a Compute Engine > Soluzione Bare Metal > Condivisioni NFS.

Visualizza le informazioni disponibili.

Campo	Descrizione	Esempio
Stato	Indica la disponibilità di un volume NFS	Un cerchio verde con un segno di spunta indica che è stato eseguito il provisioning del volume NFS.
ID	Identificatore assegnato al dispositivo di archiviazione NFS che ospita il tuo volume. Fai clic sull'ID per visualizzare informazioni aggiuntive sul volume di archiviazione, inclusi i client consentiti e le proprietà NFS. Condividi l'ID con l'assistenza Google Cloud durante la risoluzione dei problemi di questa risorsa.	`at-2222222-nfs001`
Nome	Nome del dispositivo di archiviazione NFS che ospita il tuo volume. Fai clic sul nome per visualizzare informazioni aggiuntive sul volume di archiviazione, inclusi i client consentiti e le proprietà NFS. Nota: se non hai inserito un nome al momento del provisioning del dispositivo di archiviazione NFS, in questo campo viene visualizzato l'ID.	`nfs-share-7`
Località	Area geografica per il volume di archiviazione NFS	`asia-southeast1`
Volume	Nome del volume di archiviazione NFS. Fai clic sul nome per visualizzare ulteriori informazioni sul volume di archiviazione NFS, ad esempio gli snapshot.	`at-2222222-nfs001-vol000`
Etichette	Visualizza tutte le etichette che hai aggiunto a questa risorsa di archiviazione file NFS Puoi utilizzare le etichette per filtrare l'output della console copiando il testo di un'etichetta e incollandolo nella casella Filtro appena sopra il campo Stato.	`environment:test`

gcloud

Per visualizzare lo stato dell'archiviazione di file NFS nell'ambiente di soluzione Bare Metal, esegui il comando gcloud bms nfs-shares list:
```
gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION
```
Altre opzioni di comando includono:
- --limit: limita l'output per mostrare un numero specifico di dispositivi.
- --filter: limita l'output per mostrare i dispositivi con un'etichetta specifica o con un altro parametro filtro.
L'output fornisce dettagli sull'archiviazione dei file NFS, inclusi nome, ID, volume e client consentiti.
```
NAME: nfs-share-7
ID: at-2222222-nfs001
PROJECT: PROJECT_ID
REGION: REGION
VOLUME_NAME: at-2222222-nfs001-vol000
STATE: PROVISIONED
ALLOWED_CLIENTS: [{"allowedCidr": "192.168.1.1/32", "networkName": "at-1111111-vlan001", "shareIp": "192.168.1.240"}]
```

Per visualizzare lo stato di un dispositivo di archiviazione file NFS specifico, esegui il comando gcloud bms nfs-shares describe. Puoi utilizzare il nome o l'ID della condivisione NFS come variabile NFS_SHARE:

gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION

L'output fornisce dettagli sui client consentiti, sulle impostazioni NFS, sul server NFS e sul relativo stato, nonché sul volume di archiviazione.

allowedClients:
– allowDev: true
  allowedClientsCidr: 192.168.1.1/32
  mountPermissions: READ_WRITE
  network: projects/PROJECT_ID/locations/REGION/networks/at-1111111-vlan001
  noRootSquash: true
  shareIp: 192.168.1.240
name: projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE
nfsShareId: at-2222222-nfs001
state: PROVISIONED
volume: projects/PROJECT_ID/locations/REGION/volumes/at-2222222-nfs001-vol000

Per aggiungere, aggiornare o rimuovere etichette per l'archiviazione di file NFS, esegui il comando gcloud bms nfs-shares update. Puoi utilizzare le seguenti opzioni:
- --update-labels: Aggiunge etichette alle risorse in modo da poter filtrare l'output dei comandi di stato. Devi aggiungere ogni etichetta con una coppia chiave-valore, ad esempio environment = test.
- --remove-labels: rimuove etichette specifiche
- --clear-labels: rimuove tutte le etichette
Di seguito è riportato un comando di esempio che aggiunge le etichette environment = test e location = Downtown e rimuove l'etichetta cost-center da un dispositivo di archiviazione file NFS:
```
gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --update-labels environment=test,location=downtown --remove-labels=cost-center
```
Il seguente comando rimuove tutte le etichette da un dispositivo di archiviazione file NFS:
```
gcloud bms nfs-shares update NFS_SHARE --project=PROJECT_ID --region=REGION --clear-labels
```
Per visualizzare le modifiche alle etichette di archiviazione file NFS, esegui il comando seguente:
```
gcloud bms nfs-shares describe NFS_SHARE --project=PROJECT_ID --region=REGION
```
Per utilizzare un'etichetta per filtrare l'output di un comando gcloud bms nfs-shares list, aggiungi --filter labels.KEY=VALUE alla fine del comando. L'esempio seguente limita l'output per un dispositivo di archiviazione file NFS con l'etichetta della coppia chiave-valore ambiente = test.
```
gcloud bms nfs-shares list --project=PROJECT_ID --region=REGION --filter labels.environment=test
```

API

Per visualizzare lo stato dell'archiviazione di file NFS nell'ambiente di soluzione Bare Metal, inclusi i client consentiti e le proprietà NFS, inserisci l'ID e l'area geografica del progetto nel seguente comando curl. Copia il comando, incollalo nel prompt di Cloud Shell e premi il tasto Invio oppure INVIO:
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"
```

Per visualizzare lo stato di un dispositivo di archiviazione file NFS specifico, inserisci l'ID progetto, l'area geografica e il nome o l'ID server NFS, quindi esegui il comando seguente:

curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE"

Per aggiungere etichette a un dispositivo di archiviazione file NFS, inserisci l'ID progetto, l'area geografica e il nome o l'ID server NFS nel seguente comando curl. Le coppie chiave-valore in questo esempio assegnano tre etichette: utente = test, env = gestione temporanea e scopo = new_hardware_cert. Copia il comando, incollalo nel prompt di Cloud Shell e premi il tasto Invio o Invio:
```
curl -X PATCH \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares/NFS_SHARE?updateMask=labels"
 -d "{
  'labels' : {
     'user': 'test',
     'env': 'staging',
     'purpose': 'new_hardware_cert'
   }
}"
```
- Se esegui il comando curl senza etichette o valori, cancelli tutte le etichette.
```
'labels' : {
 }
```
- Se emetti il comando curl con nuovi valori per un'etichetta, il nuovo valore sovrascrive quello precedente.
```
'labels' : {
     'user': 'production',
     'env': 'production',
     'purpose': 'shared_data_store'
 }
```
Per utilizzare un'etichetta per filtrare l'output di un comando GET curlper un dispositivo di archiviazione file NFS Bare Metal Solution, inserisci l'ID progetto e l'area geografica, quindi aggiungi ?filter=labels.KEY=VALUEalla fine del comando. L'esempio seguente limita l'output per trovare i dispositivi di archiviazione file NFS con l'etichetta della coppia chiave-valore env = gestione temporanea.
```
curl -X GET -H \
"Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"https://baremetalsolution.googleapis.com/v2/projects/PROJECT_ID/locations/REGION/nfsShares"?filter=labels.env=staging
```

Visualizzare lo stato di un'operazione a lunga esecuzione

L'esecuzione di alcuni comandi o chiamate API, ad esempio la reimpostazione di un server, potrebbe richiedere molto tempo. Se vuoi controllare lo stato di un'operazione a lunga esecuzione, utilizza le seguenti opzioni di comando:

gcloud

Per visualizzare lo stato di un'operazione a lunga esecuzione, utilizza il comando gcloud bms operations describe.
```
gcloud bms operations describe --project=PROJECT_ID --region=REGION operations/OPERATION_ID
```

API

Apri una finestra del terminale Cloud Shell in Cloud Console.
Per visualizzare lo stato di un'operazione a lunga esecuzione nel tuo ambiente Bare Metal Solution, inserisci l'ID progetto e l'ID operazione nel comando curl seguente. Copia il comando, incollalo nel prompt di Cloud Shell e premi il tasto Invio:
```
curl -X GET \
-H "Authorization: Bearer $(gcloud auth print-access-token)" \
-H "X-Goog-User-Project: PROJECT_ID" \
-H "Content-Type: application/json" \
"[https://baremetalsolution.googleapis.com/v1/operations/OPERATION_ID"
```
Al termine dell'operazione, il campo Fine viene visualizzato come true nell'output.
```
{
  "name": "operations/OPERATION_ID",
  "done": true
}
```