Cette page explique comment installer un partage de fichiers Filestore sur une instance de machine virtuelle (VM) Compute Engine qui se trouve dans le même projet Google Cloudet le même réseau VPC. Pour savoir comment installer des partages de fichiers sur des clients d'un réseau distant, consultez Installer des partages de fichiers sur des clients distants. Si vous souhaitez accéder aux instances Filestore à partir de clusters Google Kubernetes Engine, consultez la section Accéder aux instances Filestore avec le pilote CSI Filestore.
Avant de commencer
Assurez-vous que le pare-feu du réseau est correctement configuré pour une utilisation avec Filestore. Consultez la section Configurer les règles de pare-feu pour plus d'informations.
Installer un partage de fichiers sur une instance de VM Compute Engine
Utilisez l'une des procédures suivantes pour installer un partage de fichiers Filestore sur une machine virtuelle Compute Engine : Nous vous recommandons d'effectuer une installation sur une VM n1-standard-8 ou supérieure pour des performances optimales.
Linux : installation
Pour installer manuellement un partage de fichiers sur une machine virtuelle cliente Linux :
Dans la console Google Cloud , accédez à la page "Instances de VM".
Localisez la machine virtuelle Linux que vous souhaitez utiliser en tant que client, puis cliquez sur SSH pour ouvrir un terminal sur cette VM.
Facultatif : installation d'un partage de fichiers sur une machine virtuelle cliente avec plusieurs interfaces réseau via un réseau secondaire.
Détails (cliquez pour développer)
Si vous souhaitez installer le partage de fichiers via un réseau secondaire, à savoir une interface autre que
nic0, vous devez modifier la règle de routage de la VM cliente. Exécutez la commande suivante :sudo ip route \ add filestore-reserved-address-range \ via default-gateway-of-nic-to-filestoreoù :
filestore-reserved-address-rangeest la plage d'adresses réservée à l'utilisation par l'instance Filestore.default-gateway-of-nic-to-filestoreest l'adresse IP de la passerelle par défaut de la carte d'interface réseau connectée au réseau VPC qui est partagé avec l'instance Filestore.
Pour en savoir plus sur l'utilisation des instances Compute Engine avec plusieurs cartes d'interface réseau, consultez Configurer le routage pour une interface réseau supplémentaire.
Installez NFS :
Debian/Ubuntu
Exécutez les commandes suivantes pour installer NFS sur Debian ou Ubuntu.
sudo apt-get -y update &&
sudo apt-get install nfs-commonRHEL/CentOS
Exécutez les commandes suivantes pour installer NFS sur Red Hat Enterprise Linux ou CentOS.
sudo yum update &&
sudo yum install nfs-utilsSUSE
Exécutez les commandes suivantes pour installer NFS sur SUSE.
sudo zypper update &&
sudo zypper -n install nfs-clientCréez un répertoire local à mapper au partage de fichiers Filestore :
sudo mkdir -p mount-point-directoryoù
mount-point-directoryest le répertoire à créer (par exemple,/mnt/filedir).Installez le partage de fichiers à partir de l'instance Filestore en exécutant la commande
mount. Vous pouvez utiliser toutes les options d'installation NFS. Pour obtenir des performances optimales, nous vous recommandons d'utiliser les options NFSmountsuivantes :Option Description hardLe client NFS relance indéfiniment les requêtes NFS. Pour réduire le risque de perturbations des E/S lors du redémarrage de l'instance Filestore, nous vous recommandons d'utiliser l'option de montage hardpour les clients Linux et Windows.timeo=600Le client NFS attend 600 décisecondes (60 secondes) avant de réessayer une demande NFS. retrans=3Le client NFS tente d'effectuer les requêtes NFS à trois reprises avant de poursuivre la procédure de récupération. rsize=524288Le client NFS peut recevoir un maximum de 524 288 octets du serveur NFS par demande READ.
Remarque : Pour les instances de niveau de base, définissez la valeurrsizesur1048576.wsize=524288Le client NFS peut envoyer un maximum de 524 288 octets au serveur NFS par requête WRITE.resvportLe client NFS utilise un port source privilégié lors de la communication avec le serveur NFS pour ce point d'installation. asyncLe client NFS retarde l'envoi des écritures d'application au serveur NFS jusqu'à ce que certaines conditions soient remplies.
Attention : L'utilisation de l'optionsyncréduit considérablement les performances.- Pour réduire la latence d'installation, spécifiez l'option
-o tcp. Si vous installez une instance régionale, zonale ou Enterprise sur une VM cliente qui exécute la version 5.3 ou ultérieure du noyau Linux, spécifiez l'option d'installation
nconnectpour augmenter les performances NFS. Pour certains niveaux de service, nous vous recommandons de spécifier le nombre de connexions suivant entre le client et le serveur :Niveau Capacité Nombre de connexions Régional, zonal 1 à 9,75 Tio nconnect=2Régional, zonal 10 à 100 Tio nconnect=7Entreprise - nconnect=2SSD à grande échelle - nconnect=7En général, plus la capacité du partage de fichiers est élevée et le nombre de VM clientes connectées est faible, plus vous obtenez de performances en spécifiant des connexions supplémentaires avec
nconnect.
Exécutez la commande
mountavec les options de votre choix, comme suit :sudo mount -o rw ip-address:/file-share mount-point-directoryoù :
ip-addressest l'adresse IP de l'instance Filestore.file-shareest le nom du partage de fichiers sur l'instance.mount-point-directoryest le chemin d'accès où vous souhaitez mapper le partage de fichiers Filestore.
L'adresse IP et le nom du partage de fichiers d'une instance sont obtenus à partir de l'une des sources suivantes :
Page des instances Filestore
Champ
IP_ADDRESSdans les résultats de la commandefilestore instances listSection
ipAddressesdans les résultats de la commandefilestore instances describe.
Par exemple, considérant une instance Filestore avec une adresse IP
10.0.1.2et un partage de fichiers nomméshare1, la commande suivante installe le partage de fichiers dans le répertoire du point d'installation local/mnt/render:sudo mount 10.0.1.2:/share1 /mnt/render- Pour réduire la latence d'installation, spécifiez l'option
Facultatif : Exécutez
chmodpour définir des autorisations sur le répertoire d'installation afin qu'une personne autre que l'utilisateur racine puisse écrire des données dans ce répertoire. Pour définir les autorisations de répertoire, exécutez la commande suivante:sudo chmod permissions mount-point-directoryoù :
permissionsest l'ensemble des autorisations à accorder. Par exemple,chmod go+rwrend le répertoire accessible en lecture et en écriture par les utilisateurs du groupe propriétaire du répertoire et par tous les autres utilisateurs. Pour plus d'informations sur la définition des autorisations, consultez la page Configurer l'accès sur un partage de fichiers.mount-point-directorycorrespond au chemin d'accès au répertoire dans lequel le partage de fichiers Filestore est installé.
Facultatif : Vérifiez que le partage de fichiers Filestore est installé :
df -h --type=nfsUn résultat semblable aux lignes suivantes doit s'afficher :
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
Si vous devez utiliser le verrouillage de fichier NFS, vous devrez peut-être définir les ports utilisés par les daemons
statdetnlockmgr, et configurer règles de pare-feu pour ouvrir ces ports.
Linux : /etc/fstab
Vous pouvez faire installer automatiquement les partages de fichiers sur les machines virtuelles clientes lors du démarrage en modifiant le fichier /etc/fstab du client :
Dans la console Google Cloud , accédez à la page "Instances de VM".
Localisez la machine virtuelle Linux que vous souhaitez utiliser en tant que client, puis cliquez sur SSH pour ouvrir un terminal sur cette VM.
Facultatif: installation d'un partage de fichiers sur une machine virtuelle cliente disposant de plusieurs interfaces réseau via un réseau secondaire.
Détails (cliquez pour développer)
Si vous souhaitez installer le partage de fichiers via un réseau secondaire, à savoir une interface autre que
nic0, vous devez modifier la règle de routage de la VM cliente:- Dans
/etc/default/instance_configs.cfg, définissez l'indicateursetupdeNetworkInterfacessurfalse:[NetworkInterfaces] dhclient_script = /sbin/google-dhclient-script dhcp_command = ip_forwarding = true setup = false
Dans
/etc/network/interfaces, ajoutez les lignes suivantes :auto eth1 iface eth1 inet dhcp up ip route add filestore-reserved-address-range via default-gateway-of-nic-to-filestore
où :
filestore-reserved-address-rangeest la plage d'adresses réservée à l'utilisation par l'instance Filestore.default-gateway-of-nic-to-filestoreest l'adresse IP de la passerelle par défaut de la carte d'interface réseau connectée au réseau VPC qui est partagé avec l'instance Filestore.
Pour en savoir plus sur l'utilisation des instances Compute Engine avec plusieurs cartes d'interface réseau, consultez Configurer le routage pour une interface réseau supplémentaire.
- Dans
Installez NFS :
Debian/Ubuntu
Exécutez les commandes suivantes pour installer NFS sur Debian ou Ubuntu.
sudo apt-get -y update &&
sudo apt-get install nfs-commonRHEL/CentOS
Exécutez les commandes suivantes pour installer NFS sur Red Hat Enterprise Linux ou CentOS.
sudo yum update &&
sudo yum install nfs-utilsSUSE
Exécutez les commandes suivantes pour installer NFS sur SUSE.
sudo zypper update &&
sudo zypper -n install nfs-clientCréez un répertoire local à mapper au partage de fichiers Filestore :
sudo mkdir -p mount-point-directoryoù
mount-point-directoryest le répertoire à créer (par exemple,/mnt/filedir).Ouvrez le fichier
/etc/fstab:sudo vim /etc/fstabAjoutez la ligne suivante dans le fichier
/etc/fstab:ip-address:/file-share mount-point-directory nfs options,_netdev 0 0où :
ip-addressest l'adresse IP de l'instance Filestore.file-shareest le nom du partage de fichiers sur l'instance.mount-point-directoryest le chemin auquel vous souhaitez mapper le partage de fichiers Filestore.optionscorrespond aux options d'installation NFS. Nous vous recommandons de conserver les options d'installation NFS par défaut, avec les exceptions suivantes :- Pour une installation automatique, nous vous recommandons de spécifier
-o tcpafin de réduire la latence lors de l'installation et de la désinstallation. - Si vous installez une instance régionale, zonale ou Enterprise sur une VM cliente exécutant le noyau Linux 5.3 ou version ultérieure, spécifiez l'option d'installation
nconnectpour augmenter les performances NFS. Pour certains niveaux de service, nous vous recommandons de spécifier le nombre de connexions suivant entre le client et le serveur :
Niveau Capacité Nombre de connexions Régional, zonal 1 à 9,75 Tio nconnect=2Régional, zonal 10 à 100 Tio nconnect=7Entreprise - nconnect=2SSD à grande échelle - nconnect=7En général, plus la capacité du partage de fichiers est élevée et le nombre de VM clientes connectées est faible, plus vous obtenez de performances en spécifiant des connexions supplémentaires avec
nconnect.- Pour une installation automatique, nous vous recommandons de spécifier
Exemple : La ligne suivante dans
/etc/fstabmonte le partage de fichiersvol1de l'instance Filestore avec l'adresse IP10.0.0.2dans le répertoire de point d'installation/mntavec les options d'installation par défaut :10.0.0.2:/vol1 /mnt nfs defaults,_netdev 0 0Montez tout dans
/etc/fstab:sudo mount -aLe partage de fichiers est désormais installé automatiquement à chaque démarrage de la VM cliente.
Linux : autofs
Vous pouvez configurer autofs pour installer automatiquement un partage de fichiers uniquement lorsqu'un utilisateur y accède et le garder démonté lorsqu'il n'est pas utilisé. Par rapport à un partage de fichiers monté statiquement dans /etc/fstab, cette méthode permet de conserver les ressources de la machine virtuelle cliente dans les situations où le client doit se mapper à de nombreux points d'installation.
Installer NFS et autofs sur la machine virtuelle cliente
Dans la console Google Cloud , accédez à la page "Instances de VM".
Localisez la machine virtuelle Linux que vous souhaitez utiliser en tant que client, puis cliquez sur SSH pour ouvrir un terminal sur cette VM.
Facultatif : installation d'un partage de fichiers sur une machine virtuelle cliente avec plusieurs interfaces réseau via un réseau secondaire.
Détails (cliquez pour développer)
Si vous souhaitez installer le partage de fichiers via un réseau secondaire, à savoir une interface autre que
nic0, vous devez modifier la règle de routage de la VM cliente:- Dans
/etc/default/instance_configs.cfg, définissez l'indicateursetupdeNetworkInterfacessurfalse:[NetworkInterfaces] dhclient_script = /sbin/google-dhclient-script dhcp_command = ip_forwarding = true setup = false
- Dans
/etc/network/interfaces, ajoutez les lignes suivantes : auto eth1 iface eth1 inet dhcp up ip route add filestore-reserved-address-range via default-gateway-of-nic-to-filestore
où :
filestore-reserved-address-rangeest la plage d'adresses réservée à l'utilisation par l'instance Filestore.default-gateway-of-nic-to-filestoreest l'adresse IP de la passerelle par défaut de la carte d'interface réseau connectée au réseau VPC qui est partagé avec l'instance Filestore.
Pour en savoir plus sur l'utilisation des instances Compute Engine avec plusieurs cartes d'interface réseau, consultez Configurer le routage pour une interface réseau supplémentaire.
- Dans
Installez NFS à l'aide des commandes suivantes :
Debian/Ubuntu
Exécutez les commandes suivantes pour installer NFS sur Debian ou Ubuntu.
sudo apt-get -y update &&
sudo apt-get install nfs-commonRHEL/CentOS
Exécutez les commandes suivantes pour installer NFS sur Red Hat Enterprise Linux ou CentOS.
sudo yum update &&
sudo yum install nfs-utilsSUSE
Exécutez les commandes suivantes pour installer NFS sur SUSE.
sudo zypper update &&
sudo zypper -n install nfs-clientDepuis la fenêtre du terminal de la machine virtuelle cliente, installez
autofs:Debian/Ubuntu
sudo apt-get install autofsRHEL/CentOS
sudo yum install autofsSUSE
sudo zypper -n install autofs
Configurer autofs pour installer dynamiquement le partage de fichiers sur la machine virtuelle client
Activer
autofs:sudo systemctl enable --now autofsCréez un répertoire local à mapper au partage de fichiers Filestore :
sudo mkdir -p mount-point-directoryoù
mount-point-directoryest le répertoire à créer. Il ne doit contenir aucun sous-répertoire. Dans ce guide, nous utilisons/nfscomme répertoire de point d'installation.Ouvrez le fichier
/etc/auto.master:sudo vim /etc/auto.masterAjoutez la ligne suivante dans le fichier
/etc/auto.master:/nfs /etc/auto.nfs --timeout secondsoù
secondsest le délai avant expiration d'installation en secondes. La valeur par défaut est300. Définir cette valeur sur0désactive la désinstallation parautofs.Créez un fichier appelé
/etc/auto.nfs:sudo vim /etc/auto.nfsAjoutez la ligne suivante dans le fichier
/etc/auto.nfs:mount-point-subdir options ip-address:/file-shareoù :
mount-point-subdircorrespond au sous-répertoire de/nfsdans lequel vous souhaitez mapper le partage de fichiers Filestore. Ce sous-répertoire est généré de manière dynamique et ne doit pas exister dans la VM cliente.optionscorrespond aux options d'installation NFS. Nous vous recommandons de conserver les options d'installation NFS par défaut, avec les exceptions suivantes :- Pour une installation automatique, nous vous recommandons de spécifier
-o tcpafin de réduire la latence lors de l'installation et de la désinstallation. - Si vous installez une instance régionale, zonale ou Enterprise sur une VM cliente exécutant le noyau Linux 5.3 ou version ultérieure, spécifiez l'option d'installation
nconnectpour augmenter les performances NFS. Pour certains niveaux de service, nous vous recommandons de spécifier le nombre de connexions suivant entre le client et le serveur :
Niveau Capacité Nombre de connexions Régional, zonal 1 à 9,75 Tio nconnect=2Régional, zonal 10 à 100 Tio nconnect=7Entreprise - nconnect=2SSD à grande échelle - nconnect=7En général, plus la capacité du partage de fichiers est élevée et le nombre de VM clientes connectées est faible, plus vous obtenez de performances en spécifiant des connexions supplémentaires avec
nconnect.ip-addressest l'adresse IP de l'instance Filestore.file-shareest le nom du partage de fichiers sur l'instance.
- Pour une installation automatique, nous vous recommandons de spécifier
Exemple : La ligne suivante dans
/etc/auto.nfsmonte le partage de fichiersvol1de l'instance Filestore avec l'adresse IP10.0.0.2dans le sous-répertoire généré dynamiquementfile-sharesavec l'accèsread/writeaccordé :file-shares -rw 10.0.0.2:/vol1
Tester votre configuration
Si le partage de fichiers est monté, vous devez le démonter :
sudo umount mount-point-directoryoù
mount-point-directoryest le chemin d'accès auquel le partage de fichiers Filestore est mappé.Si une entrée
/etc/fstabinstalle le partage de fichiers au démarrage du système, supprimez-la.Rechargez
autofs:sudo service autofs reloadVérifiez que votre configuration fonctionne :
ls mount-point-directory/mount-point-subdiroù :
mount-point-directoryest le répertoire de point d'installation indiqué dans le fichier/etc/auto.master.mount-point-subdirest le sous-répertoire de point d'installation indiqué dans le fichier/etc/auto.nfs.
D'après notre exemple, la commande serait :
ls /nfs/file-sharesSi l'installation automatique est correctement configurée, le système installe d'abord le partage de fichiers, puis renvoie les résultats de la commande
ls. Le partage de fichiers est automatiquement désinstallé après une période d'inactivité définie par la valeurtimeoutspécifiée dans le fichier/etc/auto.master.
Windows
Se connecter à la machine virtuelle Windows
Dans la console Google Cloud , accédez à la page "Instances de VM".
Recherchez la VM Windows que vous souhaitez utiliser en tant que client, puis cliquez sur RDP pour ouvrir une connexion Bureau à distance à cette VM. Pour en savoir plus, consultez la page Se connecter à des instances Windows.
Installer NFS sur la VM Windows
- Sur la VM Windows, ouvrez PowerShell en tant qu'administrateur pour garantir un accès et des autorisations NFS appropriés.
Dans PowerShell, installez le client NFS :
Install-WindowsFeature -Name NFS-ClientRedémarrez l'instance de VM Windows. À l'invite, ouvrez une nouvelle connexion Bureau à distance.
Configurer l'ID utilisateur utilisé par le client NFS
Dans PowerShell, exécutez les commandes suivantes pour créer deux nouvelles entrées de registre,
AnonymousUidetAnonymousGid:New-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" ` -Name "AnonymousUid" -Value "0" -PropertyType DWORDNew-ItemProperty -Path "HKLM:\SOFTWARE\Microsoft\ClientForNFS\CurrentVersion\Default" ` -Name "AnonymousGid" -Value "0" -PropertyType DWORDRedémarrez le service client NFS :
nfsadmin client stopnfsadmin client start
Mapper le partage de fichiers à la machine virtuelle Windows
Quittez PowerShell pour quitter la session de l'administrateur. Si vous omettez cette étape, les applications exécutées dans la session de l'utilisateur standard ne pourront pas voir ni accéder à ce partage de fichiers.
exitFacultatif : installation d'un partage de fichiers sur une machine virtuelle cliente avec plusieurs interfaces réseau via un réseau secondaire.
Détails (cliquez pour développer)
Si vous souhaitez installer le partage de fichiers via un réseau secondaire, à savoir une interface autre que
nic0, vous devez modifier la règle de routage de la VM cliente. Exécutez la commande suivante :route -p ^ add filestore-reserved-address-range ^ mask address-range-subnet-mask ^ default-gateway-of-nic-to-filestoreoù :
filestore-reserved-address-rangeest la plage d'adresses réservée à l'utilisation par l'instance Filestore.address-range-subnet-maskest le masque de sous-réseau defilestore-reserved-address-range. Par exemple, une plage d'adresses réservée /29 utiliserait le masque de sous-réseau 255.255.255.248.default-gateway-of-nic-to-filestoreest l'adresse IP de la passerelle par défaut de la carte d'interface réseau connectée au réseau VPC qui est partagé avec l'instance Filestore.
Exemple :
route -p add 10.65.21.176 mask 255.255.255.248 10.128.0.1Pour en savoir plus sur l'utilisation des instances Compute Engine avec plusieurs cartes d'interface réseau, consultez Configurer le routage pour une interface réseau supplémentaire.
À partir de
Command Prompt, mappez le partage de fichiers à une lettre de lecteur :net use drive-letter: \\filestore-ip\file-share-nameoù :
- filestore-ip est l'adresse IP de l'instance Filestore.
- file-share-name est le nom du partage de fichiers sur l'instance Filestore.
- drive-letter est la lettre du disque que vous souhaitez attribuer au mappage.
Exemple
La commande suivante mappe le partage de fichiers
vol1sur l'instance Filestore avec l'adresse IP10.0.0.2au lecteurz:sur la machine virtuelle Windows cliente :net use Z: \\10.0.0.2\vol1Facultatif : Pour utiliser le verrouillage des fichiers NFS, vérifiez les points suivants :
Assurez-vous que les règles de pare-feu sont configurées pour tous les ports NFS requis, y compris
statdetnlockmgr.Assurez-vous que le client NFS Windows est configuré avec des ports réservés à l'aide d'une commande semblable à la suivante dans PowerShell :
nfsadmin client config protocol=tcp UseReservedPorts=yes nfsadmin client stop nfsadmin client start
Créer et installer des sous-répertoires sur le partage de fichiers
Une fois que votre partage de fichiers est installé sur une VM cliente, vous pouvez créer des sous-répertoires sur celui-ci, que les clients peuvent installer directement au lieu d'installer l'intégralité du partage de fichiers :
Pour créer un sous-répertoire sur le partage de fichiers installé, exécutez la commande suivante :
sudo mkdir -p mount-point-directory/file-share-sub-diroù :
mount-point-directoryest le chemin d'accès sur lequel vous mappez le partage de fichiers.file-share-sub-direst le chemin d'accès du sous-répertoire du partage de fichiers que vous souhaitez créer.
Cette commande crée le sous-répertoire sur la VM cliente et sur le partage de fichiers. Par exemple, si vous avez installé le partage de fichiers
10.0.0.2:/vol1au répertoire/mntsur la VM cliente, la commandesudo mkdir -p /mnt/nfscrée10.0.0.2:/vol1/nfssur le partage de fichiers et/mnt/nfssur la VM cliente.Facultatif : Si vous souhaitez installer le sous-répertoire du partage de fichiers dans le répertoire de la VM cliente sur laquelle le partage de fichiers est installé, vous devez d'abord désinstaller le partage de fichiers :
sudo umount mount-point-directoryoù
mount-point-directoryest le répertoire vers lequel le partage de fichiers est mappé.Installez le sous-répertoire :
sudo mount ip-address:/file-share/file-share-sub-dir mount-point-directoryoù :
ip-addressest l'adresse IP de l'instance Filestore.file-shareest le nom du partage de fichiers sur l'instance.file-share-sub-direst le chemin d'accès du sous-répertoire dans le partage de fichiers à installer.mount-point-directoryest le chemin d'accès où vous souhaitez mapper le partage de fichiers Filestore.
Exemple : dans la commande suivante :
sudo mount 10.0.0.2:/vol1/nfs /mnt/nfs10.0.0.2est l'adresse IP de l'instance Filestore.vol1est le nom du partage de fichiers.nfsest un sous-répertoire du partage de fichiers./mnt/nfsest le répertoire de la VM cliente où le sous-répertoire de partage de fichiersnfsest mappé.
Étape suivante
- Découvrez comment copier des données dans le partage de fichiers installé.
- Découvrez comment installer des partages de fichiers sur des clients d'un réseau distant.
- Résolvez les problèmes d'installation liés à Filestore.