Crea un'istanza Filestore utilizzando gcloud CLI

Crea un'istanza Filestore utilizzando gcloud CLI

Questa guida rapida mostra come iniziare a utilizzare rapidamente 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

Sign in to your Google Cloud account. If you're new to Google Cloud, create an account to evaluate how our products perform in real-world scenarios. New customers also get $300 in free credits to run, test, and deploy workloads.

Install the 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

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

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.

Verify that billing is enabled for your Google Cloud project.

Enable the Filestore API:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

gcloud services enable file.googleapis.com

Install the 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

Create or select a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

• Create a Google Cloud project:

  gcloud projects create PROJECT_ID

  Replace PROJECT_ID with a name for the Google Cloud project you are creating.

• Select the Google Cloud project that you created:

  gcloud config set project PROJECT_ID

  Replace PROJECT_ID with your Google Cloud project name.

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.

Verify that billing is enabled for your Google Cloud project.

Enable the Filestore API:

Roles required to enable APIs

To enable APIs, you need the Service Usage Admin IAM role (roles/serviceusage.serviceUsageAdmin), which contains the serviceusage.services.enable permission. Learn how to grant roles.

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. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance 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. Create a Compute Engine instance. Configure the instance as follows:
   • Name the instance 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,http-server,.

   gcloud compute instances create nfs-client --zone=us-central1-c --image-project=windows-cloud --image-family=windows-2012-r2 --tags=http-server,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

Annota 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. Establish an SSH connection to the nfs-client instance:

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

Delete a Google Cloud project:

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