Como montar compartilhamentos de arquivos em clientes do Compute Engine

Nesta página, mostramos como ativar um compartilhamento de arquivos do Filestore em uma instância de máquina virtual (VM) do Compute Engine que está no mesmo projeto Google Cloud e na rede VPC. Para saber como montar compartilhamentos de arquivos em clientes em uma rede remota, consulte Montagem de compartilhamentos de arquivos em clientes remotos. Se você estiver tentando acessar instâncias do Filestore a partir de clusters do Google Kubernetes Engine, consulte Acessar instâncias do Filestore com o driver CSI do Filestore.

Antes de começar

Verifique se o firewall de rede está configurado corretamente para uso com o Filestore. Consulte Como configurar regras de firewall para mais detalhes.

Como ativar um compartilhamento de arquivos em uma instância de VM do Compute Engine

Use um dos procedimentos a seguir para ativar um compartilhamento de arquivos do Filestore em uma VM do Compute Engine. Recomendamos a ativação em uma VM n1-standard-8 ou superior para um desempenho ideal.

Linux: ativação

Observação: ao ativar com o comando mount, o compartilhamento de arquivos é desativado quando a VM do cliente é reiniciada. Para manter o compartilhamento de arquivos ativado quando a VM do cliente for reiniciada, use fstab ou autofs.

Para montar manualmente um compartilhamento de arquivos em uma VM cliente Linux:

1. No console do Google Cloud , acesse a página "Instâncias de VM".

   Acessar a página "Instâncias de VM"

2. Localize a VM do Linux que você quer usar como cliente e clique em SSH para abrir um terminal nessa VM.

3. Opcional: montar um compartilhamento de arquivos em uma VM cliente com várias interfaces de rede por meio de uma rede secundária.

   Detalhes (clique para expandir)

   Para ativar o compartilhamento de arquivos por meio de uma rede secundária, ou seja, uma interface diferente de nic0, modifique a política de roteamento da VM do cliente: Execute:

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

   onde:

   • filestore-reserved-address-range é o intervalo de endereços reservado para uso pela instância do Filestore.
   • default-gateway-of-nic-to-filestore é o endereço IP do gateway padrão da NIC conectada à rede VPC compartilhada com a instância do Filestore.

   Para mais informações sobre como usar instâncias do Compute Engine com várias NICs, consulte Configurar o roteamento para uma interface de rede adicional.

4. Instale o NFS:

   Debian/Ubuntu

   Use os seguintes comandos para instalar o NFS no Debian ou no Ubuntu.

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

   RHEL/CentOS

   Use os comandos a seguir para instalar o NFS no Red Hat Enterprise Linux ou no CentOS.

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Use os comandos a seguir para instalar o NFS no SUSE.

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

5. Crie um diretório local para mapear para o compartilhamento de arquivos do Filestore:

   sudo mkdir -p mount-point-directory
   

   em que mount-point-directory é o diretório a ser criado (por exemplo, /mnt/filedir).

6. Monte o compartilhamento de arquivos da instância do Filestore executando o comando mount. É possível usar qualquer opção de montagem do NFS. Para ter o melhor desempenho, recomendamos o uso das seguintes opções mount do NFS:

   Opção	Descrição
   hard	O cliente NFS repete solicitações NFS indefinidamente. Para reduzir a possibilidade de interrupções de E/S quando a instância do Filestore for reinicializada, recomendamos usar a opção de montagem hard para clientes Linux e Windows.
   timeo=600	O cliente NFS aguarda 600 segundos (60 segundos) antes de tentar novamente uma solicitação NFS.
   retrans=3	O cliente NFS tenta fazer solicitações NFS três vezes antes de realizar outras ações de recuperação.
   rsize=524288	O cliente NFS pode receber no máximo 524.288 bytes do servidor NFS por solicitação READ. Observação: para instâncias do nível básico, defina o valor rsize como 1048576.
   wsize=524288	O cliente NFS pode enviar no máximo 524.288 bytes ao servidor NFS por solicitação WRITE.
   resvport	O cliente NFS usa uma porta de origem com privilégios ao se comunicar com o servidor NFS para esse ponto de montagem.
   async	O cliente NFS atrasa o envio de gravações de aplicativos para o servidor NFS até que determinadas condições sejam atendidas. Cuidado: o uso da opção sync reduz significativamente o desempenho.

   • Para reduzir a latência da montagem, especifique a opção -o tcp.

   • Se você ativar uma instância regional, zonal ou enterprise em uma VM de cliente que esteja executando a versão 5.3 ou posterior do kernel do Linux, especifique a opção de ativação nconnect para melhorar o desempenho do NFS. Para níveis de serviço específicos, recomendamos especificar o seguinte número de conexões entre o cliente e o servidor:

     Nível	Capacidade	Número de conexões
     Regional, por zona	1 a 9,75 TiB	nconnect=2
     Regional, por zona	10-100 TiB	nconnect=7
     Enterprise	-	nconnect=2
     SSD de grande escala	-	nconnect=7

     Em geral, quanto maior a capacidade de compartilhamento de arquivos e menos VMs de cliente conectadas, mais desempenho você terá ao especificar outras conexões com nconnect.

   Execute o comando mount com as opções de sua preferência, semelhante ao seguinte:

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

   em que:

   • ip-address é o endereço IP da instância do Filestore.
   • file-share é o nome do compartilhamento de arquivos na instância.
   • mount-point-directory é o caminho para onde você quer mapear o compartilhamento de arquivos do Filestore.

   É possível ver o endereço IP e o nome do compartilhamento de arquivos de uma instância de qualquer uma destas fontes:

   • A página de instâncias do Filestore

     Acessar a página de instâncias do Filestore

   • O campo IP_ADDRESS nos resultados do comando filestore instances list.

   • A seção ipAddresses nos resultados do comando filestore instances describe.

   Por exemplo, considerando uma instância do Filestore com um endereço IP 10.0.1.2 e um compartilhamento de arquivos denominado share1, o comando a seguir monta o compartilhamento de arquivos no diretório de ponto de montagem local /mnt/render:

   sudo mount 10.0.1.2:/share1 /mnt/render
   

   Observação: recomendamos otimizar a taxa de transferência de leitura do NFS ajustando o valor do parâmetro read_ahead_kb. Para mais informações, consulte Otimizar a capacidade de processamento de leitura do NFS com o parâmetro read_ahead_kb.

7. Opcional: execute chmod para definir permissões no diretório de ativação para que alguém que não seja o usuário raiz possa gravar nele. Para definir permissões de diretório, execute o seguinte comando:

   sudo chmod permissions mount-point-directory
   

   onde:

   • permissions é o conjunto de permissões a serem concedidas. Por exemplo, chmod go+rw torna o diretório legível e gravável pelos usuários no grupo que é proprietário do diretório e de todos os outros usuários. Para ver mais informações sobre como definir permissões, consulte Como configurar o acesso em um compartilhamento de arquivos.
   • mount-point-directory é o caminho para o diretório em que o compartilhamento de arquivos do Filestore está montado.

8. Opcional: confirme se o compartilhamento de arquivos do Filestore está ativado:

   df -h --type=nfs
   

   A saída conterá uma entrada semelhante a esta:

   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 você precisar usar o bloqueio de arquivos do NFS, talvez seja necessário definir as portas usadas pelos daemons statd e nlockmgr e configurar regras de firewall para abrir essas portas.

Linux: /etc/fstab

Você pode fazer com que os compartilhamentos de arquivos sejam montados automaticamente nas VMs cliente durante a inicialização, modificando /etc/fstab arquivo:

1. No console do Google Cloud , acesse a página "Instâncias de VM".

   Acessar a página "Instâncias de VM"

2. Localize a VM do Linux que você quer usar como cliente e clique em SSH para abrir um terminal nessa VM.

3. Opcional: montar um compartilhamento de arquivos em uma VM cliente que tenha várias interfaces de rede por meio de uma rede secundária.

   Detalhes (clique para expandir)

   Para montar o compartilhamento de arquivos por meio de uma rede secundária, ou seja, uma interface diferente de nic0, modifique a política de roteamento da VM cliente:

   • Em /etc/default/instance_configs.cfg, defina a sinalização setup de NetworkInterfaces como false:

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

   • Em /etc/network/interfaces, adicione as seguintes linhas:

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

   onde:

   • filestore-reserved-address-range é o intervalo de endereços reservado para uso pela instância do Filestore.
   • default-gateway-of-nic-to-filestore é o endereço IP do gateway padrão da NIC conectada à rede VPC compartilhada com a instância do Filestore.

   Para mais informações sobre como usar instâncias do Compute Engine com várias NICs, consulte Configurar o roteamento para uma interface de rede adicional.

4. Instale o NFS:

   Debian/Ubuntu

   Use os seguintes comandos para instalar o NFS no Debian ou no Ubuntu.

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

   RHEL/CentOS

   Use os comandos a seguir para instalar o NFS no Red Hat Enterprise Linux ou no CentOS.

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Use os comandos a seguir para instalar o NFS no SUSE.

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

5. Crie um diretório local para mapear para o compartilhamento de arquivos do Filestore:

   sudo mkdir -p mount-point-directory
   

   em que mount-point-directory é o diretório a ser criado (por exemplo, /mnt/filedir).

6. Abra o arquivo /etc/fstab.

   sudo vim /etc/fstab
   

7. Adicione a seguinte linha no arquivo /etc/fstab:

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

   onde:

   • ip-address é o endereço IP da instância do Filestore.
   • file-share é o nome do compartilhamento de arquivos na instância.
   • mount-point-directory é o caminho para o qual você quer mapear o compartilhamento de arquivos do Filestore.

   • options são as opções de ativação do NFS. Recomendamos manter as opções de montagem do NFS padrão, com as seguintes exceções:

     • Para fazer a montagem automática, recomendamos especificar -o tcp para reduzir a latência ao montar e desmontar.
     • Se você ativar uma instância regional, zonal ou empresarial em uma VM de cliente que esteja executando a versão 5.3 ou posterior do kernel do Linux, especifique a opção de ativação nconnect para melhorar o desempenho do NFS. Para níveis de serviço específicos, recomendamos especificar o seguinte número de conexões entre o cliente e o servidor:

     Nível	Capacidade	Número de conexões
     Regional, por zona	1 a 9,75 TiB	nconnect=2
     Regional, por zona	10-100 TiB	nconnect=7
     Enterprise	-	nconnect=2
     SSD de grande escala	-	nconnect=7

     Em geral, quanto maior a capacidade de compartilhamento de arquivos e menos VMs de cliente conectadas, mais desempenho você terá ao especificar outras conexões com nconnect.

   Exemplo: a seguinte linha em /etc/fstab monta o compartilhamento de arquivos vol1 da instância do Filestore com o endereço IP 10.0.0.2 no diretório do ponto de montagem /mnt com as opções de montagem padrão:

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

8. Ative tudo em /etc/fstab:

       sudo mount -a
   

   O compartilhamento de arquivos agora é montado automaticamente sempre que a VM cliente é inicializada.

Linux: autofs

É possível configurar autofs para montar automaticamente um compartilhamento de arquivos somente quando ele for acessado e mantê-lo desmontado quando não for usado. Em comparação com um compartilhamento de arquivos estaticamente montado em /etc/fstab, esse método ajuda a economizar recursos de VM cliente em situações em que o cliente precisa mapear para muitos pontos de montagem.

Instalar NFS e autofs na VM do cliente

1. No console do Google Cloud , acesse a página "Instâncias de VM".

   Acessar a página "Instâncias de VM"

2. Localize a VM do Linux que você quer usar como cliente e clique em SSH para abrir um terminal nessa VM.

3. Opcional: montar um compartilhamento de arquivos em uma VM cliente com várias interfaces de rede por meio de uma rede secundária.

   Detalhes (clique para expandir)

   Para montar o compartilhamento de arquivos por meio de uma rede secundária, ou seja, uma interface diferente de nic0, modifique a política de roteamento da VM cliente:

   • Em /etc/default/instance_configs.cfg, defina a sinalização setup de NetworkInterfaces como false:

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

   • Em /etc/network/interfaces, adicione as seguintes linhas: auto eth1 iface eth1 inet dhcp up ip route add filestore-reserved-address-range via default-gateway-of-nic-to-filestore

   em que:

   • filestore-reserved-address-range é o intervalo de endereços reservado para uso pela instância do Filestore.
   • default-gateway-of-nic-to-filestore é o endereço IP do gateway padrão da NIC conectada à rede VPC compartilhada com a instância do Filestore.

   Para mais informações sobre como usar instâncias do Compute Engine com várias NICs, consulte Configurar o roteamento para uma interface de rede adicional.

4. Instale o NFS executando os seguintes comandos:

   Debian/Ubuntu

   Use os seguintes comandos para instalar o NFS no Debian ou no Ubuntu.

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

   RHEL/CentOS

   Use os comandos a seguir para instalar o NFS no Red Hat Enterprise Linux ou no CentOS.

   sudo yum update &&
   sudo yum install nfs-utils

   SUSE

   Use os comandos a seguir para instalar o NFS no SUSE.

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

5. Na janela do terminal da VM do cliente, instale autofs:

   Debian/Ubuntu

   sudo apt-get install autofs
   

   RHEL/CentOS

   sudo yum install autofs
   

   SUSE

   sudo zypper -n install autofs
   

Configurar autofs para montar dinamicamente o compartilhamento de arquivos para a VM cliente

1. Ativar autofs:

   sudo systemctl enable --now autofs
   

2. Crie um diretório local para mapear para o compartilhamento de arquivos do Filestore:

   sudo mkdir -p mount-point-directory
   

   em que mount-point-directory é o diretório a ser criado. Ele não pode conter subdiretórios. Neste guia, usamos /nfs como o diretório do ponto de montagem.

3. Abra o arquivo /etc/auto.master.

   sudo vim /etc/auto.master
   

4. Adicione a seguinte linha ao arquivo /etc/auto.master:

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

   em que seconds é a duração em segundos antes do tempo limite de ativação. O valor padrão é 300. Definir esse valor como 0 desativa a desmontagem por autofs.

5. Crie um arquivo chamado /etc/auto.nfs:

   sudo vim /etc/auto.nfs
   

6. Adicione a seguinte linha ao arquivo /etc/auto.nfs:

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

   em que:

   • mount-point-subdir é o subdiretório em /nfs para o qual você quer mapear o compartilhamento de arquivos do Filestore. Esse subdiretório é gerado dinamicamente e não deve existir na VM do cliente.

   • options são as opções de ativação do NFS. Recomendamos manter as opções de montagem do NFS padrão, com as seguintes exceções:

     • Para fazer a montagem automática, recomendamos especificar -o tcp para reduzir a latência ao montar e desmontar.
     • Se você ativar uma instância regional, zonal ou empresarial em uma VM de cliente que esteja executando a versão 5.3 ou posterior do kernel do Linux, especifique a opção de ativação nconnect para melhorar o desempenho do NFS. Para níveis de serviço específicos, recomendamos especificar o seguinte número de conexões entre o cliente e o servidor:

     Nível	Capacidade	Número de conexões
     Regional, por zona	1 a 9,75 TiB	nconnect=2
     Regional, por zona	10-100 TiB	nconnect=7
     Enterprise	-	nconnect=2
     SSD de grande escala	-	nconnect=7

     Em geral, quanto maior a capacidade de compartilhamento de arquivos e menos VMs de cliente conectadas, mais desempenho você terá ao especificar outras conexões com nconnect.

     • ip-address é o endereço IP da instância do Filestore.
     • file-share é o nome do compartilhamento de arquivos na instância.

   Exemplo: a seguinte linha em /etc/auto.nfs monta o compartilhamento de arquivos vol1 da instância do Filestore com o endereço IP 10.0.0.2 no subdiretório file-shares gerado dinamicamente com acesso read/write concedido:

   file-shares -rw 10.0.0.2:/vol1
   

Testar a configuração

1. Se o compartilhamento de arquivos estiver montado, será necessário desmontá-lo:

   sudo umount mount-point-directory
   

   em que mount-point-directory é o caminho para o qual o compartilhamento de arquivos do Filestore é mapeado.

   Se houver uma entrada /etc/fstab que monta o compartilhamento de arquivos na inicialização do sistema, remova-o.

2. Atualize autofs:

   sudo service autofs reload
   

3. Confirme se sua configuração funciona:

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

   onde:

   • mount-point-directory é o diretório do ponto de montagem indicado no arquivo /etc/auto.master.
   • mount-point-subdir é o subdiretório do ponto de ativação indicado no arquivo /etc/auto.nfs.

   No nosso exemplo, o comando seria:

   ls /nfs/file-shares
   

   Se o recurso de ativação automática estiver configurado corretamente, o sistema ativará primeiro o compartilhamento de arquivos e, em seguida, retornará os resultados do comando ls. O compartilhamento de arquivos é automaticamente desativado após um período de inatividade, que é definido pelo valor timeout especificado no arquivo /etc/auto.master.

Windows

Conectar-se à VM do Windows

1. No console do Google Cloud , acesse a página "Instâncias de VM".

   Acessar a página "Instâncias de VM"

2. Localize a VM do Windows que você quer usar como cliente e clique em RDP para abrir uma conexão de área de trabalho remota com essa VM. Para obter mais informações, consulte Como se conectar a instâncias do Windows.

Instalar o NFS na VM do Windows

1. Na VM do Windows, abra o PowerShell como administrador para garantir o acesso e as permissões adequados do NFS.

2. No PowerShell, instale o cliente NFS:

   Install-WindowsFeature -Name NFS-Client
   

3. Reinicie a instância da VM do Windows conforme solicitado e abra uma nova conexão de área de trabalho remota.

Configurar o ID de usuário usado pelo cliente NFS

1. No PowerShell, execute os seguintes comandos para criar duas novas entradas de 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. Reinicie o serviço do cliente NFS:

   nfsadmin client stop
   

   nfsadmin client start
   

Mapear o compartilhamento de arquivos para a VM do Windows

1. Saia do PowerShell para encerrar a sessão do administrador. Se você omitir esta etapa, os aplicativos em execução na sessão do usuário padrão não poderão ver nem acessar esse compartilhamento de arquivos.

   exit
   

2. Opcional: montar um compartilhamento de arquivos em uma VM cliente com várias interfaces de rede por meio de uma rede secundária.

   Detalhes (clique para expandir)

   Para ativar o compartilhamento de arquivos por meio de uma rede secundária, ou seja, uma interface diferente de nic0, modifique a política de roteamento da VM do cliente: Execute:

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

   onde:

   • filestore-reserved-address-range é o intervalo de endereços reservado para uso pela instância do Filestore.
   • address-range-subnet-mask é a máscara de sub-rede de filestore-reserved-address-range. Por exemplo, um intervalo de endereços reservado /29 usaria a máscara de sub-rede 255.255.255.248.
   • default-gateway-of-nic-to-filestore é o endereço IP do gateway padrão da NIC conectada à rede VPC compartilhada com a instância do Filestore.

   Exemplo:

   route -p add 10.65.21.176 mask 255.255.255.248 10.128.0.1
   

   Para mais informações sobre como usar instâncias do Compute Engine com várias NICs, consulte Configurar o roteamento para uma interface de rede adicional.

3. Em Command Prompt, mapeie o compartilhamento de arquivos para uma letra de unidade:

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

   onde:

   • filestore-ip é o endereço IP da instância do Filestore.
   • file-share-name é o nome do compartilhamento de arquivos na instância do Filestore.
   • drive-letter é a letra da unidade que você quer atribuir ao mapeamento.

   Exemplo

   O comando a seguir mapeia o compartilhamento de arquivos vol1 na instância do Filestore com o endereço IP 10.0.0.2 para o drive z: na VM do Windows do cliente:

   net use Z: \\10.0.0.2\vol1
   

4. Opcional: para usar o bloqueio de arquivos do NFS, verifique o seguinte:

   1. Verifique se as regras de firewall estão configuradas para todas as portas NFS necessárias, incluindo statd e nlockmgr.

   2. Verifique se o cliente NFS do Windows está configurado com portas reservadas usando um comando semelhante ao seguinte no PowerShell:

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

Como criar e montar subdiretórios no compartilhamento de arquivos

Depois que o compartilhamento de arquivos for montado em uma VM cliente, você poderá criar subdiretórios no compartilhamento de arquivos, que os clientes poderão montar diretamente em vez de montar o compartilhamento de arquivos inteiro:

1. Para criar um subdiretório no compartilhamento de arquivos montado, execute:

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

   onde:

   • mount-point-directory é o caminho a que o compartilhamento de arquivos é associado;
   • file-share-sub-dir é o caminho do subdiretório no compartilhamento de arquivos que você quer criar.

   Esse comando cria o subdiretório na VM do cliente e no compartilhamento de arquivos. Por exemplo, se você tiver montado o compartilhamento de arquivos 10.0.0.2:/vol1 no diretório /mnt na VM cliente, o comando sudo mkdir -p /mnt/nfs criará 10.0.0.2:/vol1/nfs no compartilhamento de arquivos e /mnt/nfs na VM do cliente.

2. Opcional: se você quiser montar o subdiretório de compartilhamento de arquivos para o diretório na VM do cliente em que o compartilhamento de arquivos está montado, primeiro desmonte o compartilhamento de arquivos:

   sudo umount mount-point-directory
   

   em que mount-point-directory é o diretório ao qual o compartilhamento de arquivos está mapeado.

3. Monte o subdiretório:

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

   onde:

   • ip-address é o endereço IP da instância do Filestore.
   • file-share é o nome do compartilhamento de arquivos na instância.
   • file-share-sub-dir é o caminho do subdiretório no compartilhamento de arquivos a ser montado.
   • mount-point-directory é o caminho para onde você quer mapear o compartilhamento de arquivos do Filestore.

   Exemplo: no seguinte comando:

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

   • 10.0.0.2 é o endereço IP da instância do Filestore.
   • vol1 é o nome do compartilhamento de arquivos;
   • nfs é um subdiretório de compartilhamento de arquivos;
   • /mnt/nfs é o diretório na VM cliente a que o subdiretório de compartilhamento de arquivos nfs é associado.

A seguir

• Saiba como copiar dados para o compartilhamento de arquivos montado.
• Saiba como montar compartilhamentos de arquivos em clientes em uma rede remota
• Resolva problemas de ativação relacionados ao Filestore.