Montaggio delle condivisioni file sui client Compute Engine

Questa pagina mostra come montare una condivisione file di Filestore su un'istanza di macchina virtuale (VM) Compute Engine che si trova nello stesso progetto Google Cloud e nella stessa rete VPC. Per informazioni su come montare le condivisioni file sui client in una rete remota, vedi Montaggio delle condivisioni file su client remoti. Se vuoi accedere alle istanze Filestore dai cluster di Google Kubernetes Engine, consulta Accedere alle istanze Filestore con il driver CSI Filestore.

Prima di iniziare

Assicurati che il firewall di rete sia configurato correttamente per l'utilizzo con Filestore. Per i dettagli, consulta Configurazione delle regole firewall.

Montaggio di una condivisione file su un'istanza VM di Compute Engine

Utilizza una delle seguenti procedure per montare una condivisione file di Filestore su una VM Compute Engine. Ti consigliamo di montare la VM n1-standard-8 o superiore per ottenere prestazioni ottimali.

Linux: montaggio

Nota: in caso di montaggio con il comando mount, la condivisione file viene smontata al riavvio della VM client. Per mantenere montata la condivisione file al riavvio della VM client, usa invece fstab o autofs.

Per montare manualmente una condivisione file su una VM client Linux:

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai alla pagina Istanze VM

2. Individua la VM Linux che vuoi utilizzare come client, quindi fai clic su SSH per aprire un terminale su quella VM.

3. Facoltativo: monta una condivisione file su una VM client con più interfacce di rete tramite una rete secondaria.

   Dettagli (fai clic per espandere)

   Se desideri montare la condivisione file tramite una rete secondaria, ovvero un'interfaccia diversa da nic0, devi modificare il criterio di routing della VM client. Esegui:

   sudo ip route \
       add filestore-reserved-address-range \
       via default-gateway-of-nic-to-filestore
   

   dove:

   • filestore-reserved-address-range è l'intervallo di indirizzi riservato per l'utilizzo da parte dell'istanza Filestore.
   • default-gateway-of-nic-to-filestore è l'indirizzo IP predefinito del gateway del NIC connesso alla rete VPC condivisa con l'istanza Filestore.

   Per ulteriori informazioni sull'utilizzo delle istanze di Compute Engine con più NIC, consulta Configurare il routing per un'interfaccia di rete aggiuntiva.

4. Installa NFS:

   Debian/Ubuntu

   Utilizza i comandi seguenti per installare NFS su Debian o Ubuntu.

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

   RHEL/CentOS

   Utilizza i comandi seguenti per installare NFS su Red Hat Enterprise Linux o CentOS.

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Utilizza i comandi seguenti per installare NFS su SUSE.

   sudo zypper update &&
   sudo zypper -n install nfs-client

5. Crea una directory locale da mappare alla condivisione file di Filestore:

   sudo mkdir -p mount-point-directory
   

   dove mount-point-directory è la directory da creare, ad esempio /mnt/filedir.

6. Monta la condivisione file dall'istanza Filestore eseguendo il comando mount. Puoi utilizzare qualsiasi opzione di montaggio di NFS. Per ottenere prestazioni ottimali, consigliamo di utilizzare le seguenti opzioni mount NFS:

   Opzione	Descrizione
   hard	Il client NFS riprova le richieste NFS a tempo indeterminato. Per ridurre le probabilità di interruzioni di I/O al riavvio dell'istanza Filestore, ti consigliamo di utilizzare l'opzione di montaggio hard per i client Linux e Windows.
   timeo=600	Il client NFS attende 600 decisecondi (60 secondi) prima di riprovare una richiesta NFS.
   retrans=3	Il client NFS tenta le richieste NFS tre volte prima di intraprendere un'ulteriore azione di ripristino.
   rsize=262144	Il client NFS può ricevere dal server NFS un massimo di 262.144 byte per ogni richiesta READ. Nota: per le istanze di livello base, imposta il valore rsize su 1048576.
   wsize=1048576	Il client NFS può ricevere dal server NFS un massimo di 1.048.576 byte per ogni richiesta WRITE.
   resvport	Il client NFS utilizza una porta di origine con privilegi per comunicare con il server NFS per questo punto di montaggio.
   async	Il client NFS ritarda l'invio delle scritture dell'applicazione al server NFS fino a quando non vengono soddisfatte determinate condizioni. Attenzione: l'utilizzo dell'opzione sync riduce notevolmente le prestazioni.

   • Per una latenza di montaggio ridotta, specifica l'opzione -o tcp.
   • Se stai montando un'istanza aziendale o a livello di zona (precedentemente SSD ad alta scalabilità) su una VM client che esegue il kernel Linux 5.3 o versioni successive, valuta la possibilità di specificare l'opzione di montaggio nconnect per aumentare le prestazioni NFS. Consigliamo di specificare fino a 7 connessioni per il livello a livello di zona e fino a 2 connessioni per il livello regionale e Enterprise. In generale, maggiore è la capacità di condivisione file e minore è la quantità di VM client che eseguono la connessione, maggiori sono le prestazioni che ottieni specificando connessioni aggiuntive con nconnect.

   Esegui il comando mount con le tue opzioni preferite, simili a quelle di seguito:

   sudo mount -o rw,intr ip-address:/file-share mount-point-directory
   

   dove:

   • ip-address è l'indirizzo IP dell'istanza Filestore.
   • file-share è il nome della condivisione file nell'istanza.
   • mount-point-directory è il percorso in cui vuoi mappare la condivisione file di Filestore.

   Puoi ottenere l'indirizzo IP e il nome della condivisione file di un'istanza da una qualsiasi delle seguenti origini:

   • La pagina delle istanze Filestore.

     Vai alla pagina delle istanze Filestore.

   • Il campo IP_ADDRESS nei risultati del comando filestore instances list.

   • La sezione ipAddresses nei risultati del comando filestore instances describe.

   Ad esempio, data un'istanza Filestore con un indirizzo IP 10.0.1.2 e una condivisione file denominata share1, il seguente comando monta la condivisione file nella directory del punto di montaggio locale /mnt/render:

   sudo mount 10.0.1.2:/share1 /mnt/render
   

7. Facoltativo: esegui chmod per impostare le autorizzazioni nella directory di montaggio in modo che altri utenti diversi dagli utenti root possano scrivere nella directory. Per impostare le autorizzazioni della directory, esegui questo comando:

   sudo chmod permissions mount-point-directory
   

   dove:

   • permissions è l'insieme di autorizzazioni da concedere. Ad esempio, chmod go+rw rende la directory leggibile e scrivibile dai membri del gruppo proprietario della directory e di tutti gli altri utenti. Per ulteriori informazioni sull'impostazione delle autorizzazioni, consulta Configurazione dell'accesso per una condivisione file.
   • mount-point-directory è il percorso della directory in cui è montata la condivisione file Filestore.

8. (Facoltativo) Verifica che la condivisione file di Filestore sia montata:

   df -h --type=nfs
   

   L'output dovrebbe contenere una voce simile alla seguente:

   Filesystem        Size    Used  Avail  Use%  Mounted on
   10.0.1.2:/share1  1018G   76M   966G   1%    /mnt/render
   10.0.2.2:/vol3    1018G   76M   966G   1%    /mnt/filestore3

9. Se devi utilizzare il blocco dei file NFS, potresti dover impostare le porte utilizzate dai daemon statd e nlockmgr, nonché configurare le regole del firewall per aprirle.

Linux: /etc/fstab

Puoi fare in modo che le condivisioni file vengano montate automaticamente nelle VM client durante l'avvio modificando il file /etc/fstab del client:

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai alla pagina Istanze VM

2. Individua la VM Linux che vuoi utilizzare come client, quindi fai clic su SSH per aprire un terminale su quella VM.

3. Facoltativo: monta una condivisione file su una VM client con più interfacce di rete tramite una rete secondaria.

   Dettagli (fai clic per espandere)

   Se desideri montare la condivisione file tramite una rete secondaria, ovvero un'interfaccia diversa da nic0, devi modificare il criterio di routing della VM client:

   • In /etc/default/instance_configs.cfg, imposta il flag setup per NetworkInterfaces su false:

     [NetworkInterfaces]
     dhclient_script = /sbin/google-dhclient-script
     dhcp_command =
     ip_forwarding = true
        setup = false
     

   • In /etc/network/interfaces, aggiungi le seguenti righe:

     auto eth1
     iface eth1 inet dhcp
         up ip route add filestore-reserved-address-range via default-gateway-of-nic-to-filestore
     

   dove:

   • filestore-reserved-address-range è l'intervallo di indirizzi riservato per l'utilizzo da parte dell'istanza Filestore.
   • default-gateway-of-nic-to-filestore è l'indirizzo IP predefinito del gateway del NIC connesso alla rete VPC condivisa con l'istanza Filestore.

   Per ulteriori informazioni sull'utilizzo delle istanze di Compute Engine con più NIC, consulta Configurare il routing per un'interfaccia di rete aggiuntiva.

4. Installa NFS:

   Debian/Ubuntu

   Utilizza i comandi seguenti per installare NFS su Debian o Ubuntu.

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

   RHEL/CentOS

   Utilizza i comandi seguenti per installare NFS su Red Hat Enterprise Linux o CentOS.

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Utilizza i comandi seguenti per installare NFS su SUSE.

   sudo zypper update &&
   sudo zypper -n install nfs-client

5. Crea una directory locale da mappare alla condivisione file di Filestore:

   sudo mkdir -p mount-point-directory
   

   dove mount-point-directory è la directory da creare, ad esempio /mnt/filedir.

6. Apri il file /etc/fstab:

   sudo vim /etc/fstab
   

7. Aggiungi la seguente riga nel file /etc/fstab:

   ip-address:/file-share mount-point-directory nfs options,_netdev 0 0
   

   dove:

   • ip-address è l'indirizzo IP dell'istanza Filestore.
   • file-share è il nome della condivisione file per l'istanza.
   • mount-point-directory è il percorso a cui vuoi mappare la condivisione file Archivio.
   • options sono le opzioni di montaggio NFS. Ti consigliamo di mantenere le opzioni di montaggio predefinite per NFS, con le seguenti eccezioni:
     • Per l'installazione automatica, consigliamo di specificare -o tcp per ridurre la latenza durante il montaggio e lo smontaggio.
     • Se stai montando un'istanza di zona (precedentemente SSD ad alta scalabilità) su una VM client che esegue il kernel Linux 5.3 o versioni successive, valuta la possibilità di specificare l'opzione di montaggio nconnect per aumentare le prestazioni NFS. Ti consigliamo di specificare fino a 7 connessioni per il livello a livello di zona e fino a 2 connessioni per il livello regionale e Enterprise. In generale, maggiore è la capacità di condivisione file e minore è la quantità di VM client che si connettono, maggiori sono le prestazioni che ottieni specificando connessioni aggiuntive con nconnect.

   Esempio: la seguente riga in /etc/fstab monta la condivisione file vol1 dell'istanza Filestore con l'indirizzo IP 10.0.0.2 nella directory del punto di montaggio /mnt con le opzioni di montaggio predefinite:

   10.0.0.2:/vol1 /mnt nfs defaults,_netdev 0 0
   

8. Monta tutto in /etc/fstab:

   sudo mount -a
   

   La condivisione file viene ora montata automaticamente a ogni avvio della VM client.

Linux: autofs

Puoi configurare autofs in modo che monta automaticamente una condivisione file solo quando viene eseguito l'accesso e di mantenerla smontata quando non viene utilizzata. Rispetto ad avere una condivisione file montata in modo statico in /etc/fstab, questo metodo consente di risparmiare le risorse delle VM del client in situazioni in cui il client deve essere mappato a più punti di montaggio.

Installa NFS e autofs sulla VM client

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai alla pagina Istanze VM

2. Individua la VM Linux che vuoi utilizzare come client, quindi fai clic su SSH per aprire un terminale su quella VM.

3. Facoltativo: monta una condivisione file su una VM client con più interfacce di rete tramite una rete secondaria.

   Dettagli (fai clic per espandere)

   Se desideri montare la condivisione file tramite una rete secondaria, ovvero un'interfaccia diversa da nic0, devi modificare il criterio di routing della VM client:

   • In /etc/default/instance_configs.cfg, imposta il flag setup per NetworkInterfaces su false:

     [NetworkInterfaces]
     dhclient_script = /sbin/google-dhclient-script
     dhcp_command =
     ip_forwarding = true
        setup = false
     

   • In /etc/network/interfaces, aggiungi le seguenti righe:

     auto eth1
     iface eth1 inet dhcp
         up ip route add filestore-reserved-address-range via default-gateway-of-nic-to-filestore
     

   dove:

   • filestore-reserved-address-range è l'intervallo di indirizzi riservato per l'utilizzo da parte dell'istanza Filestore.
   • default-gateway-of-nic-to-filestore è l'indirizzo IP predefinito del gateway del NIC connesso alla rete VPC condivisa con l'istanza Filestore.

   Per ulteriori informazioni sull'utilizzo delle istanze di Compute Engine con più NIC, consulta Configurare il routing per un'interfaccia di rete aggiuntiva.

4. Installa NFS eseguendo questi comandi:

   Debian/Ubuntu

   Utilizza i comandi seguenti per installare NFS su Debian o Ubuntu.

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

   RHEL/CentOS

   Utilizza i comandi seguenti per installare NFS su Red Hat Enterprise Linux o CentOS.

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Utilizza i comandi seguenti per installare NFS su SUSE.

   sudo zypper update &&
   sudo zypper -n install nfs-client

5. Dalla finestra del terminale della VM client, installa autofs:

   Debian/Ubuntu

   sudo apt-get install autofs
   

   RHEL/CentOS

   sudo yum install autofs
   

   SUSE

   sudo zypper -n install autofs
   

Configura autofs per montare in modo dinamico la condivisione file sulla VM client

1. Attiva autofs:

   sudo systemctl enable --now autofs
   

2. Crea una directory locale da mappare alla condivisione file di Filestore:

   sudo mkdir -p mount-point-directory
   

   dove mount-point-directory è la directory da creare. Non deve contenere sottodirectory. In questa guida utilizziamo /nfs come directory del punto di montaggio.

3. Apri il file /etc/auto.master:

   sudo vim /etc/auto.master
   

4. Aggiungi la seguente riga nel file /etc/auto.master:

   /nfs /etc/auto.nfs --timeout seconds
   

   dove seconds indica la durata in secondi precedente al timeout del montaggio. Il valore predefinito è 300. Se questo valore viene impostato su 0, lo smontaggio entro il giorno autofs viene disabilitato.

5. Crea un file denominato /etc/auto.nfs:

   sudo vim /etc/auto.nfs
   

6. Aggiungi la seguente riga nel file /etc/auto.nfs:

   mount-point-subdir options ip-address:/file-share
   

   dove:

   • mount-point-subdir è la sottodirectory in /nfs a cui vuoi mappare la condivisione file Filestore. Questa sottodirectory viene generata dinamicamente e non deve esistere nella VM client.
   • options sono le opzioni di montaggio NFS. Ti consigliamo di mantenere le opzioni di montaggio predefinite per NFS, con le seguenti eccezioni:
     • Per l'installazione automatica, consigliamo di specificare -o tcp per ridurre la latenza durante il montaggio e lo smontaggio.
     • Se stai montando un'istanza di zona (precedentemente SSD ad alta scalabilità) su una VM client che esegue il kernel Linux 5.3 o versioni successive, valuta la possibilità di specificare l'opzione di montaggio nconnect per aumentare le prestazioni NFS. Ti consigliamo di specificare fino a 7 connessioni per il livello a livello di zona e fino a 2 connessioni per il livello regionale e Enterprise. In generale, maggiore è la capacità di condivisione file e minore è la quantità di VM client che si connettono, maggiori sono le prestazioni che ottieni specificando connessioni aggiuntive con nconnect.
     • ip-address è l'indirizzo IP dell'istanza Filestore.
     • file-share è il nome della condivisione file nell'istanza.

   Esempio: la seguente riga in /etc/auto.nfs monta la condivisione file vol1 dell'istanza Filestore con indirizzo IP 10.0.0.2 nella sottodirectory generata dinamicamente file-shares con accesso read/write concesso:

   file-shares -rw 10.0.0.2:/vol1
   

Test della configurazione

1. Se la condivisione file è montata, devi smontarla:

   sudo umount mount-point-directory
   

   dove mount-point-directory è il percorso a cui è mappata la condivisione file Filestore.

   Se esiste una voce /etc/fstab che monta la condivisione file all'avvio del sistema, assicurati di rimuoverla.

2. Ricarica autofs:

   sudo service autofs reload
   

3. Verifica che la configurazione funzioni:

   ls mount-point-directory/mount-point-subdir
   

   dove:

   • mount-point-directory è la directory del punto di montaggio indicata nel file /etc/auto.master.
   • mount-point-subdir è la sottodirectory del punto di montaggio indicata nel file /etc/auto.nfs.

   Nel nostro esempio, il comando sarebbe:

   ls /nfs/file-shares
   

   Se il montaggio automatico è configurato correttamente, il sistema monta prima la condivisione file, quindi restituisce i risultati del comando ls. La condivisione file viene smontata automaticamente dopo un periodo di inattività, definito nel valore timeout specificato nel file /etc/auto.master.

Windows

Connettiti alla VM Windows

1. Nella console Google Cloud, vai alla pagina Istanze VM.

   Vai alla pagina Istanze VM

2. Individua la VM Windows che vuoi utilizzare come client, quindi fai clic su RDP per aprire una connessione desktop remoto a questa VM. Per ulteriori informazioni, consulta Connessione alle istanze Windows.

Installa NFS sulla VM Windows

1. Sulla VM Windows, apri PowerShell come amministratore.

2. In PowerShell, installa il client NFS:

   Install-WindowsFeature -Name NFS-Client
   

3. Riavvia l'istanza VM Windows come richiesto, quindi apri una nuova connessione Remote Desktop.

Configura l'ID utente utilizzato dal client NFS

1. In PowerShell, esegui questi comandi per creare due nuove voci del Registro di sistema, 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
   

2. Riavvia il servizio client NFS:

   nfsadmin client stop
   

   nfsadmin client start
   

Mappare la condivisione file alla VM Windows

1. Uscita PowerShell:

   exit
   

2. Facoltativo: monta una condivisione file su una VM client con più interfacce di rete tramite una rete secondaria.

   Dettagli (fai clic per espandere)

   Se desideri montare la condivisione file tramite una rete secondaria, ovvero un'interfaccia diversa da nic0, devi modificare il criterio di routing della VM client. Esegui:

   route -p ^
       add filestore-reserved-address-range ^
       mask address-range-subnet-mask ^
       default-gateway-of-nic-to-filestore
   

   dove:

   • filestore-reserved-address-range è l'intervallo di indirizzi riservato per l'utilizzo da parte dell'istanza Filestore.
   • address-range-subnet-mask è la subnet mask di filestore-reserved-address-range. Ad esempio, un intervallo di indirizzi riservati /29 utilizza la subnet mask 255.255.255.248.
   • default-gateway-of-nic-to-filestore è l'indirizzo IP predefinito del gateway del NIC connesso alla rete VPC condivisa con l'istanza Filestore.

   Esempio:

   route -p add 10.65.21.176 mask 255.255.255.248 10.128.0.1
   

   Per ulteriori informazioni sull'utilizzo delle istanze di Compute Engine con più NIC, consulta Configurare il routing per un'interfaccia di rete aggiuntiva.

3. Da Command Prompt, mappa la condivisione file a una lettera di unità:

   ```none
   mount -o mtype=hard filestore-ip:/file-share-name drive-letter:
   ```
   

   dove:

   • filestore-ip è l'indirizzo IP dell'istanza Filestore.
   • file-share-name è il nome della condivisione file sull'istanza Filestore.
   • drive-letter è la lettera dell'unità che vuoi assegnare per la mappatura.

   Esempio

   Il seguente comando mappa la condivisione file vol1 sull'istanza Filestore con l'indirizzo IP 10.0.0.2 su Drive z: sulla VM Windows client:

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

4. Facoltativo: per utilizzare il blocco dei file NFS, verifica quanto segue:

   1. Assicurati che le regole firewall siano configurate per tutte le porte NFS richieste, tra cui statd e nlockmgr.

   2. Assicurati che il client NFS di Windows sia configurato con porte riservate utilizzando un comando simile al seguente in PowerShell:

      nfsadmin client config protocol=tcp UseReservedPorts=yes
      nfsadmin client stop
      nfsadmin client start
      

Creazione e montaggio di sottodirectory nella condivisione file

Una volta montata la condivisione file sulla VM client, puoi creare sottodirectory nella condivisione file, che i client potranno montare direttamente invece di montare l'intera condivisione file:

1. Per creare una sottodirectory sulla condivisione file montata, esegui:

   sudo mkdir -p mount-point-directory/file-share-sub-dir
   

   dove:

   • mount-point-directory è il percorso a cui mappi la condivisione file.
   • file-share-sub-dir è il percorso della sottodirectory nella condivisione file che vuoi creare.

   Questo comando crea la sottodirectory sia sulla VM client sia sulla condivisione file. Ad esempio, se hai montato la condivisione file 10.0.0.2:/vol1 nella directory /mnt sulla VM client, il comando sudo mkdir -p /mnt/nfs crea 10.0.0.2:/vol1/nfs sulla condivisione file e /mnt/nfs sulla VM client.

2. Facoltativo: se vuoi montare la sottodirectory della condivisione file nella directory della VM client in cui è montata la condivisione file, devi prima smontare la condivisione file:

   sudo umount mount-point-directory
   

   dove mount-point-directory è la directory a cui è mappata la condivisione file.

3. Monta la sottodirectory:

   sudo mount ip-address:/file-share/file-share-sub-dir mount-point-directory
   

   dove:

   • ip-address è l'indirizzo IP dell'istanza Filestore.
   • file-share è il nome della condivisione file nell'istanza.
   • file-share-sub-dir è il percorso della sottodirectory nella condivisione file da montare.
   • mount-point-directory è il percorso in cui vuoi mappare la condivisione file di Filestore.

   Esempio: nel comando seguente:

   sudo mount 10.0.0.2:/vol1/nfs /mnt/nfs
   

   • 10.0.0.2 è l'indirizzo IP dell'istanza Filestore.
   • vol1 è il nome della condivisione file.
   • nfs è una sottodirectory di una condivisione file.
   • /mnt/nfs è la directory sulla VM client in cui è mappata la sottodirectory della condivisione file nfs.

Passaggi successivi

• Scopri come copiare i dati nella condivisione file montata.
• Scopri come montare le condivisioni file sui client in una rete remota.
• Risolvi i problemi di montaggio relativi a Filestore.