Montaggio delle condivisioni file sui client Compute Engine

Questa pagina mostra come montare una condivisione file di Filestore su un'istanza di una macchina virtuale (VM) Compute Engine che si trova nello stesso progetto e nella stessa rete VPC di Google Cloud. Per scoprire come montare le condivisioni file su client in una rete remota, consulta Montaggio di condivisioni file su client remoti. Se invece vuoi accedere alle istanze Filestore dai cluster 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 ulteriori dettagli, consulta la sezione Configurazione delle regole del 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. Per ottenere prestazioni ottimali, consigliamo di eseguire il montaggio su una VM n1-standard-8 o superiore.

Linux: mount

Nota: quando esegui il 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, utilizza 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 sulla VM.

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

   Dettagli (fai clic per espandere)

   Se vuoi 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 da utilizzare per l'istanza Filestore.
   • default-gateway-of-nic-to-filestore è l'default-gateway-of-nic-to-filestore è l'indirizzo IP del gateway predefinito della NIC connessa alla rete VPC condivisa con l'istanza Filestore.

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

4. Installa NFS:

   Debian/Ubuntu

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

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

   RHEL/CentOS

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

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Utilizza i seguenti comandi 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 NFS. Per un rendimento ottimale, consigliamo di utilizzare le seguenti opzioni NFS mount:

   Opzione	Descrizione
   hard	Il client NFS riprova le richieste NFS a tempo indeterminato. Per ridurre la possibilità di interruzioni I/O al riavvio dell'istanza Filestore, consigliamo di utilizzare l'opzione di montaggio hard sia per i client Linux sia per quelli 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 ulteriori azioni di recupero.
   rsize=262144	Il client NFS può ricevere un massimo di 262.144 byte dal server NFS per richiesta READ. Nota: per le istanze di livello base, imposta il valore rsize su 1048576.
   wsize=1048576	Il client NFS può ricevere un massimo di 1.048.576 byte dal server NFS per richiesta WRITE.
   resvport	Il client NFS utilizza una porta di origine privilegiata quando comunica con il server NFS per questo punto di montaggio.
   async	Il client NFS ritarda l'invio delle scritture dell'applicazione al server NFS finché non vengono soddisfatte determinate condizioni. Attenzione: l'utilizzo dell'opzione sync riduce notevolmente le prestazioni.

   • Per ridurre la latenza di montaggio, specifica l'opzione -o tcp.
   • Se stai montando un'istanza enterprise o zonale (in precedenza SSD ad alta scalabilità) su una VM client che esegue la versione 5.3 o successive del kernel Linux, valuta la possibilità di specificare l'opzione di montaggio nconnect per migliorare le prestazioni NFS. Ti consigliamo di specificare fino a 7 connessioni per il livello zonale e fino a 2 connessioni per i livelli regionale ed enterprise. In generale, maggiore è la capacità della condivisione file e minore è il numero di VM client che si connettono, maggiori sono le prestazioni che ottieni specificando connessioni aggiuntive con nconnect.

   Esegui il comando mount con le opzioni che preferisci, in modo simile al seguente:

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

   dove:

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

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

   • 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 sulla directory di montaggio in modo che persone diverse dagli utenti root possano scrivere al suo interno. Per impostare le autorizzazioni della directory, esegui il seguente 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 da tutti gli altri utenti. Per ulteriori informazioni sull'impostazione delle autorizzazioni, consulta la pagina sulla configurazione dell'accesso per una condivisione file.
   • mount-point-directory è il percorso della directory in cui è montata la condivisione file di 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 demoni statd e nlockmgr e configurare le regole del firewall per aprirle.

Linux: /etc/fstab

Puoi montare automaticamente le condivisioni file sulle 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 sulla VM.

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

   Dettagli (fai clic per espandere)

   Se vuoi 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 da utilizzare per l'istanza Filestore.
   • default-gateway-of-nic-to-filestore è l'indirizzo IP del gateway predefinito della NIC connessa alla rete VPC condivisa con l'istanza Filestore.

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

4. Installa NFS:

   Debian/Ubuntu

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

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

   RHEL/CentOS

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

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Utilizza i seguenti comandi 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 al 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 nell'istanza.
   • mount-point-directory è il percorso a cui vuoi mappare la condivisione file Filestore.
   • options sono le opzioni di montaggio NFS. Ti consigliamo di mantenere le opzioni di montaggio NFS predefinite, con le seguenti eccezioni:
     • Per il montaggio automatico, consigliamo di specificare -o tcp per ridurre la latenza durante il montaggio e lo smontaggio.
     • Se stai montando un'istanza zonale (in precedenza SSD ad alta scalabilità) su una VM client che esegue la versione 5.3 o successive del kernel Linux, ti consigliamo di specificare l'opzione di montaggio nconnect per migliorare le prestazioni NFS. Ti consigliamo di specificare fino a 7 connessioni per il livello zonale e fino a 2 connessioni per il livello regionale ed enterprise. In generale, maggiore è la capacità della condivisione file e minore è il numero di VM client che si connettono, maggiore è il rendimento che ottieni specificando connessioni aggiuntive con nconnect.

   Esempio: la riga seguente in /etc/fstab monta la condivisione file vol1 dell'istanza Filestore con 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 ogni volta che la VM client viene avviata.

Linux: autofs

Puoi configurare autofs in modo da montare automaticamente una condivisione file solo quando viene acceduta e mantenerla smontata quando non è in uso. Rispetto a una condivisione file montata in modo statico in /etc/fstab, questo metodo consente di risparmiare risorse della VM client in situazioni in cui il client deve mapparsi a molti 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 sulla VM.

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

   Dettagli (fai clic per espandere)

   Se vuoi 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 del gateway predefinito della NIC connessa alla rete VPC condivisa con l'istanza Filestore.

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

4. Installa NFS eseguendo i seguenti comandi:

   Debian/Ubuntu

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

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

   RHEL/CentOS

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

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Utilizza i seguenti comandi 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 dinamicamente 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 al file /etc/auto.master:

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

   dove seconds è la durata in secondi prima del timeout del montaggio. Il valore predefinito è 300. Se imposti questo valore su 0, viene disattivato il smontaggio per autofs.

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

   sudo vim /etc/auto.nfs
   

6. Aggiungi la seguente riga al 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 di 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 NFS predefinite, con le seguenti eccezioni:
     • Per il montaggio automatico, consigliamo di specificare -o tcp per ridurre la latenza durante il montaggio e lo smontaggio.
     • Se stai montando un'istanza zonale (in precedenza SSD ad alta scalabilità) su una VM client che esegue la versione 5.3 o successive del kernel Linux, ti consigliamo di specificare l'opzione di montaggio nconnect per migliorare le prestazioni NFS. Ti consigliamo di specificare fino a 7 connessioni per il livello zonale e fino a 2 connessioni per i livelli regionale ed enterprise. In generale, maggiore è la capacità della condivisione file e minore è il numero di VM client connesse, maggiore è il rendimento che ottieni specificando connessioni aggiuntive con nconnect.
     • ip-address è l'indirizzo IP dell'istanza Filestore.
     • file-share è il nome della condivisione file sull'istanza.

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

   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 è presente 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 indicato nel file /etc/auto.master.
   • mount-point-subdir è la sottodirectory del punto di montaggio indicato nel file /etc/auto.nfs.

   Nel nostro esempio, il comando sarà:

   ls /nfs/file-shares
   

   Se il montaggio automatico è configurato correttamente, il sistema monta prima la condivisione file e poi restituisce i risultati del comando ls. La condivisione di 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, poi fai clic su RDP per aprire una connessione desktop remoto alla VM. Per ulteriori informazioni, consulta la sezione Connessione alle istanze Windows.

Installa NFS sulla VM Windows

1. Nella 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 desktop remoto.

Configura l'ID utente utilizzato dal client NFS

1. In PowerShell, esegui i seguenti comandi per creare due nuove voci di 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
   

2. Riavvia il servizio client NFS:

   nfsadmin client stop
   

   nfsadmin client start
   

Mappa la condivisione file alla VM Windows

1. Uscita PowerShell:

   exit
   

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

   Dettagli (fai clic per espandere)

   Se vuoi 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 da utilizzare per l'istanza Filestore.
   • address-range-subnet-mask è la subnet mask di filestore-reserved-address-range. Ad esempio, un intervallo di indirizzi riservati /29 utilizzerà la subnet mask 255.255.255.248.
   • default-gateway-of-nic-to-filestore è l'indirizzo IP del gateway predefinito della NIC connessa 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 di istanze 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à:

   net use drive-letter: \\filestore-ip\file-share-name
   

   dove:

   • filestore-ip è l'indirizzo IP dell'istanza Filestore.
   • file-share-name è il nome della condivisione file nell'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 all'unità z: sulla VM Windows client:

   net use Z: \\10.0.0.2\vol1
   

4. (Facoltativo) Per utilizzare il blocco dei file NFS, verifica quanto segue:

   1. Assicurati che le regole del 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 su una VM client, puoi creare sottodirectory al suo interno, che i client possono montare direttamente anziché l'intera condivisione file:

1. Per creare una sottodirectory nella 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 sul fileshare. 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 nella 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 smontarla:

   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 sull'istanza.
   • file-share-sub-dir è il percorso della subdirectory nella condivisione file da montare.
   • mount-point-directory è il percorso a cui vuoi mappare la condivisione file di Filestore.

   Esempio: nel seguente comando:

   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 della condivisione file.
   • /mnt/nfs è la directory sulla VM client a cui è mappata la sottodirectory nfs della condivisione file.

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.