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.

  1. 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.

  2. Attiva l'API Bare Metal Solution nel tuo progetto Cloud.

    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
       

  3. 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

  1. 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:

      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.

  2. Per accendere il server, utilizza il comando gcloud bms instances start.

    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

  1. 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"
        
      • 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.

    Per ulteriori informazioni sul riavvio del server Bare Metal Solution, consulta l'API Barare Metal Solution.

  2. 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.

  1. Vai a Compute Engine > Soluzione Bare Metal > Server.

  2. 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
  3. 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

  1. 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
  2. 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
    
  3. 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
    
  4. 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

  1. Apri una finestra del terminale Cloud Shell in Google Cloud Console.

  2. 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"
    
  3. 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"
    
  4. 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'}
    }"
    
  5. 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

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

  2. 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

  1. 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
    
  2. 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
    
  3. 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
    
  4. 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

  1. Apri una finestra del terminale Cloud Shell in Cloud Console.

  2. 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"
    
  3. 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"
    
  4. 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'}
    }"
    
  5. 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

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

  2. 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

  1. 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
    
  2. 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
    
  3. 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
    
  4. 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
    
  5. 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
    
  6. 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

  1. Apri una finestra del terminale Cloud Shell in Cloud Console.

  2. 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"
    
  3. 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"
    
  4. 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
    
  5. 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"
    
  6. 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'}
    }"
    
  7. 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

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

  2. 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

  1. 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"}]
    

  2. 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
    
  3. 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
    
  4. 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

  1. 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"
    
  2. 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"
    
  3. 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'
       }
      
  4. 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

  1. 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

  1. Apri una finestra del terminale Cloud Shell in Cloud Console.

  2. 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
    }