Crea un'istanza Filestore utilizzando gcloud CLI

Crea un'istanza Filestore utilizzando gcloud CLI

Questa guida rapida mostra come iniziare rapidamente a utilizzare Filestore utilizzando Google Cloud CLI. In questa guida rapida imparerai a:

• Creare un'istanza di Filestore.
• Monta la condivisione file da questa istanza su una VM client Compute Engine.
• Crea un file nella condivisione file montata.
• Elimina l'istanza Filestore.

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei workload.

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

Abilita l'API Filestore:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

gcloud services enable file.googleapis.com

Installa Google Cloud CLI.

Se utilizzi un provider di identità (IdP) esterno, devi prima accedere a gcloud CLI con la tua identità federata.

Per inizializzare gcloud CLI, esegui questo comando:

gcloud init

Crea o seleziona un Google Cloud progetto.

Ruoli richiesti per selezionare o creare un progetto

• Seleziona un progetto: la selezione di un progetto non richiede un ruolo IAM specifico. Puoi selezionare qualsiasi progetto per il quale ti è stato concesso un ruolo.
• Crea un progetto: per creare un progetto, devi disporre del ruolo Autore progetto (roles/resourcemanager.projectCreator), che contiene l'autorizzazione resourcemanager.projects.create. Scopri come concedere i ruoli.

Nota: se non prevedi di conservare le risorse che crei in questa procedura, crea un progetto invece di selezionarne uno già esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

• Creare un progetto Google Cloud :

  gcloud projects create PROJECT_ID

  Sostituisci PROJECT_ID con un nome per il progetto Google Cloud che stai creando.

• Seleziona il progetto Google Cloud che hai creato:

  gcloud config set project PROJECT_ID

  Sostituisci PROJECT_ID con il nome del progetto Google Cloud .

Se utilizzi un progetto esistente per questa guida, verifica di disporre delle autorizzazioni necessarie per completare la guida. Se hai creato un nuovo progetto, disponi già delle autorizzazioni necessarie.

Verifica che la fatturazione sia abilitata per il tuo progetto Google Cloud .

Abilita l'API Filestore:

Ruoli richiesti per abilitare le API

Per abilitare le API, devi disporre del ruolo IAM Amministratore utilizzo dei servizi (roles/serviceusage.serviceUsageAdmin), che include l'autorizzazione serviceusage.services.enable. Scopri come concedere i ruoli.

gcloud services enable file.googleapis.com

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per completare questa guida rapida, chiedi all'amministratore di concederti i seguenti ruoli IAM nel tuo progetto:

• Crea e gestisci istanze Filestore: Editor Cloud Filestore (roles/file.editor)
• Crea e gestisci istanze Compute Engine: Compute Instance Admin (v1) (roles/compute.instanceAdmin.v1)

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.

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per saperne di più, consulta Esegui la pulizia.

Crea una VM di Compute Engine

Linux

1. Crea un'istanza Compute Engine. Configura l'istanza come segue:
   • Assegna all'istanza il nome nfs-client.
   • Imposta il flag --zone su us-central1-c.
   • Imposta il flag --image-project su debian-cloud.
   • Imposta il flag --image-family su debian-11.
   • Imposta il flag --tags su http-server.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=debian-cloud --image-family=debian-11 --tags=http-server

Windows

1. Crea un'istanza Compute Engine. Configura l'istanza come segue:
   • Assegna all'istanza il nome nfs-client.
   • Imposta il flag --zone su us-central1-c.
   • Imposta il flag --image-project su windows-cloud.
   • Imposta il flag --image-family su windows-2012-r2.
   • Imposta il flag --tags su http-server.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server

Crea un'istanza di Filestore

Questa guida rapida mostra come creare un'istanza nel livello di servizio regionale con prestazioni personalizzate abilitate. Per informazioni dettagliate sulla creazione di istanze, vedi Creare un'istanza.

1. Creare un'istanza di Filestore. Configura l'istanza come segue:

   • Assegna all'istanza il nome nfs-server.
   • Imposta il flag --region su us-central1.
   • Imposta il flag --tier su REGIONAL.

   • Imposta il flag --performance su max-iops-per-tb=17000.

     Nota: dopo aver attivato le prestazioni personalizzate per un'istanza, non puoi disattivarle per quell'istanza. Le istanze con prestazioni personalizzate attivate vengono fatturate in base alle IOPS acquistate. Per maggiori dettagli, vedi Configurare le prestazioni personalizzate e Prezzi di Filestore.

   • Imposta il flag --file-share su name="vol1",capacity=1TB.

   • Imposta il flag --network su name="default".

     gcloud filestore instances create nfs-server --region=us-central1 --tier=REGIONAL --performance=max-iops-per-tb=17000 --file-share=name="vol1",capacity=1TB --network=name="default"

2. Recupera informazioni sull'istanza Filestore che hai creato:

     gcloud filestore instances describe nfs-server --region=us-central1 

   Il comando restituisce un output simile al seguente:

       createTime: '2025-02-12T09:15:08.163246004Z'
       customPerformanceSupported: true
       fileShares:
        -capacityGb: '1024'
           name: vol1
       name: projects/yourproject/locations/us-central1/instances/nfs-server
       networks:
       -connectMode: DIRECT_PEERING
         ipAddresses:
          - 10.0.0.2
         network: default
         reservedIpRange: 10.0.0.2/26
       performanceConfig:
         iopsPerTb:
           maxIopsPerTb: '17000'
       performanceLimits:
         maxIops: '17000'
         maxReadIops: '17000'
         maxReadThroughputBps: '417792000'
         maxWriteIops: '5100'
         maxWriteThroughputBps: '139264000'
       protocol: NFS_V3
       state: READY
       tier: REGIONAL

Copia l'indirizzo IP dell'istanza da utilizzare per il montaggio della condivisione file. Per questa guida rapida, utilizziamo l'indirizzo IP 10.0.0.2.

Monta la condivisione file di Filestore sull'istanza nfs-client

Linux

1. Stabilisci una connessione SSH all'istanza nfs-client:

   gcloud compute ssh nfs-client

1. Installa NFS eseguendo i seguenti comandi nella finestra del terminale di nfs-client:

   sudo apt-get -y update &&
   sudo apt-get -y install nfs-common
   

2. Crea una directory di montaggio sull'istanza nfs-client per la condivisione file di Filestore:

   sudo mkdir /mnt/test
   

3. Monta la condivisione file sull'istanza nfs-client con il comando mount specificando l'indirizzo IP dell'istanza Filestore, il nome della condivisione file e la directory di montaggio:

   sudo mount MOUNT-POINT-DIRECTORY /mnt/test
   

   dove:

   MOUNT-POINT-DIRECTORY è il percorso della directory in cui è montata la condivisione file di Filestore. Ad esempio: 10.0.0.2:/vol1

   Nota: per i consigli sulle opzioni di montaggio NFS, consulta Montaggio delle condivisioni file.

4. (Facoltativo): verifica che la condivisione file Filestore sia montata:

   df -h --type=nfs

5. Rendi la condivisione file accessibile modificando le relative autorizzazioni:

   sudo chmod go+rw /mnt/test
   

Importante: ti consigliamo di impostare autorizzazioni più specifiche in un ambiente di produzione. Per ulteriori informazioni, consulta la pagina sulla configurazione dell'accesso per una condivisione file.

Windows

Accedi all'istanza nfs-client e apri un prompt dei comandi come amministratore

1. Crea un account e imposta una password iniziale per l'istanza nfs-client:

   gcloud compute reset-windows-password nfs-client
   

2. Configura l'istanza per abilitare la connessione alle porte seriali:

   gcloud compute instances add-metadata nfs-client --metadata=serial-port-enable=1
   

3. Per partecipare a una sessione interattiva:

   gcloud compute connect-to-serial-port nfs-client --port=2
   

4. Al prompt SAC>, crea un nuovo canale:

   cmd
   

   Viene creato un canale con il nome Cmd0001.

5. Connettiti al canale:

   ch -sn Cmd0001
   

6. Inserisci il nome utente e la password dell'istanza nfs-client e lascia vuoto il campo Domain. Sei connesso all'interfaccia Command Prompt dell'istanza nfs-client.

Installa il client NFS

1. Nella sezione Command Prompt di nfs-client, passa a Windows PowerShell:

   powershell
   

2. Installa il client NFS:

   Install-WindowsFeature -Name NFS-Client
   

3. Riavvia l'istanza nfs-client quando ti viene richiesto:

   restart-computer
   

4. Al prompt SAC>, attendi che venga visualizzata la seguente notifica:

   EVENT: The CMD command is now available.

   Quindi, esegui i comandi cmd e ch -sn come indicato in precedenza per accedere e riconnetterti all'istanza nfs-client.

Configura l'ID utente utilizzato dal client NFS

1. Nel prompt dei comandi, esegui powershell per passare a Windows PowerShell.

2. In PowerShell, esegui i seguenti comandi per creare due nuove voci del registro, AnonymousUid e AnonymousGid:

   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
       -Name "AnonymousUid" -Value "0" -PropertyType DWORD
   
   New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" `
       -Name "AnonymousGid" -Value "0" -PropertyType DWORD
   

3. Riavvia il servizio client NFS:

   nfsadmin client stop
   
   nfsadmin client start
   

Mappa la condivisione file vol1 all'istanza nfs-client

1. Uscita PowerShell:

   exit
   

2. Da Command Prompt, monta la condivisione file sull'istanza nfs-client con il comando mount specificando l'indirizzo IP dell'istanza di Filestore, il nome della condivisione file e la lettera di unità da montare:

   mount -o mtype=hard 10.0.0.2:/vol1 z:
   

Crea un file nella condivisione file montata

Linux

1. Nella finestra del terminale nfs-client, crea un file denominato testfile eseguendo questo comando:

   echo 'This is a test' > /mnt/test/testfile
   

2. Conferma che il file sia stato creato eseguendo questo comando e verificando che testfile sia nei contenuti della directory restituiti:

   ls /mnt/test
   

Windows

1. Nella finestra del prompt dei comandi dell'istanza nfs-client, crea un file denominato testfile:

   echo 'This is a test' > Z:\testfile
   

2. Verifica che il file sia stato creato eseguendo questo comando:

   dir Z:
   

   e verificando che testfile sia presente nei contenuti della directory restituiti.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questa pagina, elimina il progetto Google Cloud con le risorse.

Elimina il progetto Google Cloud

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:

• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per, le attività descritte in questo documento, eliminerai anche tutto il lavoro che hai svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.

Se intendi esplorare più architetture, tutorial o guide rapide, puoi riutilizzare i progetti ed evitare così di superare i limiti di quota.

Elimina un progetto Google Cloud :

gcloud projects delete PROJECT_ID

Elimina l'istanza Filestore

Elimina l'istanza nfs-server:

gcloud filestore instances delete nfs-server --zone=us-central1-c

Elimina l'istanza Compute Engine

Elimina l'istanza:

gcloud compute instances delete nfs-client

Passaggi successivi

• Leggi la panoramica di Filestore per scoprire di più sulle nozioni di base di Filestore.
• Configura un'istanza di Filestore autonomamente seguendo le istruzioni riportate in Creazione di istanze.
• Leggi Controllo dell'accesso per scoprire come controllare l'accesso alle operazioni Filestore e alle risorse di un'istanza.
• Scopri come copiare i dati in o da un'istanza Filestore.
• Scopri come trasferire set di dati di grandi dimensioni da Cloud Storage a Filestore.