Montar partilhas de ficheiros do Azure NFS no Linux

✔️ Aplica-se a: Partilhas de ficheiros NFS clássicos criadas com o fornecedor de recursos Microsoft.Storage

✔️ Aplica-se a: Partilhas de ficheiros criadas com o fornecedor de recursos Microsoft.FileShares

Pode montar partilhas de ficheiros Azure em distribuições Linux utilizando o protocolo Server Message Block (SMB) ou o protocolo Network File System (NFS). Este artigo centra-se na montagem com NFS. Abrange os pré-requisitos de segurança de rede, instruções de montagem para os fornecedores de recursos Microsoft.Storage e Microsoft.FileShares, montagem automática através de /etc/fstab e opções de montagem NFS recomendadas. Para obter detalhes sobre a montagem de compartilhamentos de arquivos SMB, consulte Usar arquivos do Azure com Linux. Para detalhes sobre os protocolos disponíveis, consulte protocolos de partilha de ficheiros do Azure.

Pré-requisito: Configurar a segurança da rede

Só pode aceder a partilhas de ficheiros NFSv4.1 (tanto as partilhas de ficheiros clássicas criadas com o fornecedor de recursos Microsoft.Storage como as partilhas de ficheiros criadas com o fornecedor de recursos Microsoft.FileShares) a partir de redes fidedignas. Proteja os dados usando uma rede virtual e outras definições de segurança de rede. Não pode usar as listas de segurança e controlo de acesso (ACLs) da Microsoft Entra para autorizar pedidos NFSv4.1. Para saber mais sobre como configurar partilhas de ficheiros NFSv4.1, veja como criar uma partilha de ficheiros e como criar uma partilha de ficheiros clássica.

Montar um compartilhamento de arquivos do Azure NFS

Podes montar a partilha usando o ajudante de montagem do AZNFS (um pacote de ajuda de montagem do Azure NFS) no portal do Azure, ou podes usar os comandos nativos de montagem do NFS no CLI. Você também pode criar um registro no arquivo /etc/fstab para montar automaticamente o compartilhamento sempre que o servidor Linux ou a VM forem inicializados.

Utilize a nconnect opção de montagem do Linux para melhorar o desempenho das partilhas de ficheiros NFS do Azure em grande escala. Para obter mais informações, consulte Melhorar o desempenho do compartilhamento de arquivos do Azure NFS.

As instruções de montagem variam consoante se criaste a partilha de ficheiros NFS usando a Microsoft. Fornecedor de recursos de armazenamento (partilha de ficheiros clássica) ou a Microsoft. Fornecedor de recursos FileShares.

Compartilhamento de arquivos NFS clássico (Microsoft.Storage)

Siga estes passos para montar uma partilha de ficheiros NFS clássica.

  1. Depois de criar a partilha de ficheiros, selecione a partilha e depois selecione Ligar a partir do Linux.
  2. Introduz o caminho de montagem que querem usar, depois copiem o script e executem-no no vosso cliente. O portal Azure oferece um script de instalação passo a passo, pronto a usar, adaptado à sua distribuição Linux selecionada para instalar o pacote ajudante de montagem AZNFS e para montar a partilha de forma segura usando Encryption in Transit. O script inclui apenas as opções de montadas obrigatórias, mas podes adicionar outras opções de montadas recomendadas.

Captura de ecrã que mostra como se ligar a uma partilha de ficheiros NFS a partir do Linux usando um script de montagem fornecido.

Montar uma partilha NFS clássica utilizando o comando de montagem do cliente NFS na linha de comandos

Também pode montar a partilha de ficheiros do Azure utilizando o comando de montagem do cliente NFS na linha de comandos. Selecione a guia abaixo para sua distribuição Linux para ver os comandos que você precisa executar. Substitua <YourStorageAccountName> e <FileShareName> com a sua informação.

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

sudo mkdir -p /mount/<YourStorageAccountName>/<FileShareName>
sudo mount -t nfs <YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /mount/<YourStorageAccountName>/<FileShareName> -o vers=4,minorversion=1,sec=sys,nconnect=4

Compartilhamento de arquivos NFS (Microsoft.FileShares)

Siga estes passos para montar uma partilha de ficheiros criada com o fornecedor de recursos Microsoft.FileShares.

  1. Depois de criar a partilha de ficheiros, selecione a partilha e depois selecione Ligar a partir do Linux.

  2. Introduz o caminho de montagem que querem usar, depois copiem o script e executem-no no vosso cliente. O portal Azure oferece um script de instalação passo a passo, pronto a usar, adaptado à sua distribuição Linux selecionada para instalar o pacote ajudante de montagem AZNFS e para montar a partilha de forma segura usando Encryption in Transit. Se a partilha de ficheiros exigir encriptação durante o trânsito, o script de montagem utiliza o ajudante de montagem AZNFS. Se a funcionalidade Exigir encriptação em trânsito estiver desativada, desmarque a caixa de verificação Montar com encriptação em trânsito para utilizar comandos de montagem diferentes para montar a partilha de ficheiros. O script inclui apenas as opções de montadas obrigatórias, mas podes adicionar outras opções de montadas recomendadas.

    Captura de ecrã que mostra a opção Montar com a opção Encriptação em trânsito no portal do Azure.

Monte uma partilha NFS usando a montagem do cliente NFS na linha de comandos

Também pode montar a partilha de ficheiros utilizando o comando mount do cliente NFS na linha de comandos. Selecione a guia abaixo para sua distribuição Linux para ver os comandos que você precisa executar. Substitua <your-subscription-id>, <your-resource-group>, e <your-file-share-name> pela sua informação.

# Customize these placeholders:
# - `<your-subscription-id>` → Your Azure subscription ID.
# - `<your-resource-group>` → The resource group containing the file share.
# - `<your-file-share-name>` → The name of your file share.

# you will use $hostname later when mounting the file share.
hostName=$(az resource show \
  --ids "/subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group>/providers/Microsoft.FileShares/fileShares/<your-file-share-name>" \
  --query "properties.hostName" \
  --output tsv)
echo $hostName

# you will use shortName later when mounting the file share.
prefix=$(echo "$hostName" | sed 's/\.file\.storage\.azure\.net.*//')
shortName=$(echo "$prefix" | sed 's/\.[^.]*$//')
echo $shortName

sudo apt-get -y update
sudo apt-get install nfs-common
sudo mkdir -p /mount/<your-file-share-name>
sudo mount -t nfs $hostName:/$shortName/<your-file-share-name> /mount/<your-file-share-name> -o vers=4,minorversion=1,sec=sys

Montar usando /etc/fstab

Para montar automaticamente a partilha de ficheiros NFS sempre que o servidor Linux ou a VM arrancar, crie um registo no ficheiro /etc/fstab para a sua partilha de ficheiros Azure. O registo varia dependendo se está a usar o AZNFS Mount Helper ou os comandos nativos de montagem do NFS.

Para verificar se o pacote AZNFS Mount Helper está instalado no seu cliente, execute o seguinte comando:

systemctl is-active --quiet aznfswatchdog && echo -e "\nAZNFS Mount Helper is installed! \n"

Se o pacote for instalado, a mensagem AZNFS Mount Helper is installed! aparece.

Para uma partilha de ficheiros clássica, substitua <YourStorageAccountName> e <FileShareName> pelos seus próprios valores. Para uma partilha de ficheiros Microsoft.FileShares, substitui hostName e shortName pelos valores corretos. Para obter mais informações, digite o comando man fstab na linha de comando do Linux.

Montar usando o AZNFS Mount Helper com encriptação em trânsito

Se estiveres a usar o AZNFS Mount Helper e quiseres montar a partilha usando encriptação em trânsito, o registo em /etc/fstab deve ser assim:

# For Microsoft.Storage file share, use:
<YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /media/<YourStorageAccountName>/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev   0 2

# For Microsoft.FileShares file share, use:
$hostName:/$shortName/<FileShareName> /media/$shortName/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev   0 2

Montar usando o AZNFS Mount Helper sem encriptação durante o trânsito

Se você estiver usando o AZNFS Mount Helper, mas não quiser usar criptografia em trânsito, o registro em /etc/fstab deverá ter esta aparência:

# For Microsoft.Storage file share, use:
<YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /media/<YourStorageAccountName>/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev,notls   0 2

# For Microsoft.FileShares file share, use:
$hostName:/$shortName/<FileShareName> /media/$shortName/<FileShareName> aznfs defaults,sec=sys,vers=4,minorversion=1,nolock,proto=tcp,nofail,_netdev,notls   0 2

Montar usando o comando nativo de montagem

Se você estiver usando a montagem NFS nativa sem AZNFS, o registro em /etc/fstab deverá ter esta aparência:

# For Microsoft.Storage file share, use:
<YourStorageAccountName>.file.core.windows.net:/<YourStorageAccountName>/<FileShareName> /media/<YourStorageAccountName>/<FileShareName> nfs vers=4,minorversion=1,_netdev,nofail,sec=sys 0 0

# For Microsoft.FileShares file share, use:
$hostName:/$shortName/<FileShareName> /media/$shortName/<FileShareName> nfs vers=4,minorversion=1,_netdev,nofail,sec=sys 0 0

Opções de montagem NFS para partilhas de ficheiros no Azure

Use as seguintes opções de montagem ao montar partilhas de ficheiros NFS no Azure.

Opção de montagem Valor recomendado Descrição
vers 4 Obrigatório. Especifica qual versão do protocolo NFS usar. Os Arquivos do Azure só dão suporte a NFSv4.1.
minorversion 1 Obrigatório. Especifica a versão secundária do protocolo NFS. Algumas distribuições Linux não reconhecem versões menores pontuadas no vers parâmetro. Então, em vez de vers=4.1, use vers=4,minorversion=1.
sec Sistema Obrigatório. Especifica o tipo de segurança a ser usado ao autenticar uma conexão NFS. O Setting sec=sys utiliza os UIDs e GIDs UNIX locais que usam AUTH_SYS (o esquema de autenticação padrão UNIX/Linux) para autenticar operações NFS.
rsize 1048576 Recomendado. Define o número máximo de bytes a transferir numa única operação de leitura NFS. Especificar o nível máximo de 1.048.576 bytes geralmente resulta no melhor desempenho.
wsize 1048576 Recomendado. Define o número máximo de bytes a transferir numa única operação de escrita NFS. Especificar o nível máximo de 1.048.576 bytes geralmente resulta no melhor desempenho.
noresvport não aplicável Recomendado para kernels anteriores à versão 5.18. Diz ao cliente NFS para usar uma porta de origem não privilegiada quando se comunica com um servidor NFS para o ponto de montagem. Usar a opção de montagem noresvport ajuda a garantir que o seu compartilhamento NFS tenha disponibilidade contínua após uma reconexão. O uso desta opção é recomendado para obter alta disponibilidade.
actimeo 30-60 Recomendado. Especificar actimeo define todos os acregmin, acregmax, acdirmine acdirmax com o mesmo valor. Usar um valor inferior a 30 segundos pode causar degradação do desempenho porque os caches de atributos para arquivos e diretórios expiram muito rapidamente. Define actimeo entre 30 e 60 segundos.
nconnect 4 Recomendado. nconnect aumenta o desempenho ao usar múltiplas ligações TCP entre o cliente e a sua partilha NFS. Configure as opções de montagem com a configuração ideal de nconnect=4. Atualmente, não há ganhos que ultrapassem quatro canais para a implementação de Ficheiros do Azure de nconnect.
clean não aplicável Uma montagem não-TLS pode falhar se uma montagem TLS anterior no mesmo servidor terminar abruptamente, deixando entradas obsoletas. Para resolver este problema, volte a montar a partilha usando a clean opção, que elimina imediatamente quaisquer entradas obsoletas. Esta opção aplica-se apenas para montagem AZNFS.

Validar conectividade

Se a sua montagem falhar, é possível que o seu endpoint privado não esteja configurado corretamente ou não esteja acessível. Para mais detalhes, consulte Verificar conectividade.

Instantâneos de partilha de ficheiros NFS

Pode criar instantâneos de partilhas de ficheiros quando utiliza partilhas de ficheiros NFS do Azure. Esta funcionalidade permite-lhe reverter sistemas de ficheiros inteiros ou recuperar ficheiros que sejam acidentalmente eliminados ou corrompidos. Consulte Usar instantâneos de compartilhamento com Arquivos do Azure.

Próximo passo

  • Última atualização a