Montaje de recursos compartidos de archivos de Azure de NFS en Linux

✔️ Se aplica a: Recursos compartidos de archivos NFS clásicos creados con el proveedor de recursos Microsoft.Storage

✔️ Se aplica a: recursos compartidos de archivos creados con el proveedor de recursos Microsoft.FileShares

Puede montar los recursos compartidos de archivos de Azure en distribuciones de Linux mediante el protocolo Server Message Block (SMB) o el protocolo Network File System (NFS). Este artículo se centra en el montaje con NFS. Para más información sobre el montaje de recursos compartidos de archivos SMB, consulte Uso de Azure Files con Linux. Para obtener más información sobre los protocolos disponibles, consulte Azure protocolos de recursos compartidos de archivos.

Requisito previo: configuración de la seguridad de red

Solo puede acceder a recursos compartidos de archivos NFSv4.1 (tanto los recursos compartidos de archivos clásicos creados con el proveedor de recursos Microsoft.Storage como los recursos compartidos de archivos creados con el proveedor de recursos Microsoft.FileShares) desde redes de confianza. Proteja los datos mediante una red virtual y otras configuraciones de seguridad de red. No puede usar la seguridad de Microsoft Entra ni las listas de control de acceso (ACL) para autorizar solicitudes de NFSv4.1. Para obtener más información sobre cómo configurar recursos compartidos de archivos NFSv4.1, consulte cómo crear un recurso compartido de archivos y cómo crear un recurso compartido de archivos clásico.

Montaje de un recurso compartido de archivos NFS de Azure

Puede montar el recurso compartido mediante la utilidad auxiliar de montaje de AZNFS en el portal de Azure, o también puede usar los comandos nativos de montaje de NFS en la CLI. También puede crear un registro en el archivo /etc/fstab para montar automáticamente el recurso compartido cada vez que arranque el servidor Linux o la máquina virtual.

Use la opción de montaje de nconnect Linux para mejorar el rendimiento de los recursos compartidos de archivos NFS de Azure a gran escala. Para más información, consulte Mejora del rendimiento del recurso compartido de archivos NFS de Azure.

Instrucciones de montaje predeterminadas

Las instrucciones de montaje difieren en función de si creó el recurso compartido de archivos NFS mediante el Microsoft. Proveedor de recursos de almacenamiento (recurso compartido de archivos clásico) o el Microsoft. Proveedor de recursos FileShares.

Recurso compartido de archivos NFS clásico (Microsoft.Storage)

Siga estos pasos para montar un recurso compartido de archivos NFS clásico.

  1. Después de crear el recurso compartido de archivos, seleccione el recurso compartido y, a continuación, seleccione Conectar desde Linux.
  2. Introduzca la ruta de montaje que desea usar y, a continuación, copie el script y ejecútelo en su cliente. Azure Portal ofrece un script de instalación paso a paso y listo para usar, adaptado a la distribución de Linux seleccionada, para instalar el paquete auxiliar de montaje de AZNFS y montar de forma segura el recurso compartido mediante Cifrado en tránsito. El script incluye solo las opciones de montaje necesarias, pero puede agregar otras opciones de montaje recomendadas.

Recorte de pantalla que muestra cómo conectarse a un recurso compartido de archivos NFS desde Linux mediante un script de montaje proporcionado.

Montar un recurso compartido NFS clásico mediante el montaje del cliente NFS en la línea de comandos

También puede montar el recurso compartido de archivos de Azure usando un montaje de cliente NFS en la línea de comandos. Seleccione la pestaña siguiente para la distribución de Linux para ver los comandos que necesita ejecutar. Reemplace <YourStorageAccountName> y <FileShareName> por su información.

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

Recurso compartido de archivos NFS (Microsoft.FileShares)

Siga estos pasos para montar un recurso compartido de archivos creado con el proveedor de recursos Microsoft.FileShares.

  1. Después de crear el recurso compartido de archivos, seleccione el recurso compartido y, a continuación, seleccione Conectar desde Linux.

  2. Introduzca la ruta de montaje que desea usar y, a continuación, copie el script y ejecútelo en su cliente. El portal de Azure ofrece un script de instalación paso a paso, listo para usar y adaptado a la distribución Linux seleccionada para instalar el paquete auxiliar de montaje de AZNFS y montar de forma segura el recurso compartido mediante cifrado en tránsito. Si el recurso compartido de archivos requiere cifrado en tránsito, el script de montaje usa el asistente de montaje Aznfs. Si la característica «Requerir cifrado en tránsito» está desactivada, active la casilla Montar con cifrado en tránsito para usar comandos de montaje diferentes y montar el recurso compartido de archivos. El script incluye solo las opciones de montaje necesarias, pero puede agregar otras opciones de montaje recomendadas.

    imagen para montaje mfs

Montaje de un recurso compartido NFS mediante el montaje del cliente NFS en la línea de comandos

También puede montar el recurso compartido de archivos usando un cliente NFS en la línea de comandos. Seleccione la pestaña siguiente para la distribución de Linux para ver los comandos que necesita ejecutar. Reemplace <your-subscription-id>y <your-resource-group><your-file-share-name> por su información.

# 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

Montaje mediante /etc/fstab

Para montar automáticamente el recurso compartido de archivos NFS cada vez que arranque el servidor Linux o la máquina virtual, cree un registro en el archivo /etc/fstab para el recurso compartido de archivos de Azure. El registro difiere en función de si usa el asistente de montaje de AZNFS o los comandos de montaje NFS nativos.

Para comprobar si el paquete auxiliar de montaje de AZNFS está instalado en el cliente, ejecute el siguiente comando:

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

Si el paquete está instalado, aparece el mensaje AZNFS Mount Helper is installed! .

Para el uso compartido de archivos clásico, reemplace <YourStorageAccountName> y <FileShareName> por los valores que desee. En el recurso compartido de archivos, reemplace hostName y shortName por los valores correctos. Para obtener más información, escriba el comando man fstab en la línea de comandos de Linux.

Montar mediante el asistente de montaje de AZNFS con cifrado en tránsito

Si usa el asistente de montaje de AZNFS y quiere montar el recurso compartido mediante cifrado en tránsito, el registro de /etc/fstab debe tener este aspecto:

# 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 mediante el asistente de montaje de AZNFS sin cifrado en tránsito

Si usa el asistente de montaje de AZNFS, pero no quiere usar el cifrado en tránsito, el registro de /etc/fstab debería tener este aspecto:

# 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

Montaje mediante el comando de montaje nativo

Si usa el montaje NFS nativo sin AZNFS, el registro de /etc/fstab debe tener este aspecto:

# 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

Opciones de montaje

Use las siguientes opciones de montaje al montar recursos compartidos de archivos de Azure mediante NFS.

Opción de montaje Valor recomendado Descripción
vers 4 Necesario. Especifica la versión del protocolo NFS que se va a usar. Azure Files solo admite NFSv4.1.
minorversion 1 Necesario. Especifica la versión secundaria del protocolo NFS. Algunas distribuciones de Linux no reconocen las versiones secundarias con puntos en el parámetro vers. Por lo tanto, en lugar de vers=4.1, use vers=4,minorversion=1.
sec sys Necesario. Especifica el tipo de seguridad que se va a usar al autenticar una conexión NFS. Al establecer sec=sys, se usan los UID y los GID de UNIX locales que usan AUTH_SYS para autenticar operaciones NFS.
rsize 1048576 Se recomienda su uso. Establece el número máximo de bytes que se van a transferir en una sola operación de lectura NFS. Especificar el nivel máximo de 1048 576 bytes suele generar el mejor rendimiento.
wsize 1048576 Se recomienda su uso. Establece el número máximo de bytes que se van a transferir en una sola operación de escritura NFS. Especificar el nivel máximo de 1048 576 bytes suele generar el mejor rendimiento.
noresvport N/D Se recomienda para los kernels anteriores a la versión 5.18. Indica al cliente NFS que use un puerto de origen sin privilegios al comunicarse con un servidor NFS para el punto de montaje. El uso de la opción de montaje noresvport ayuda a garantizar que el recurso compartido NFS tenga disponibilidad ininterrumpida después de una reconexión. Se recomienda usar esta opción para lograr una alta disponibilidad.
actimeo de 30 a 60 Se recomienda su uso. Al especificar actimeo, se establecen acregmin, acregmax, acdirmin y acdirmax en el mismo valor. El uso de un valor inferior a 30 segundos puede provocar una degradación del rendimiento porque las memorias caché de atributos de los archivos y directorios expiran demasiado rápidamente. Establezca actimeo entre 30 y 60 segundos.
nconnect 4 Se recomienda su uso. Nconnect aumenta el rendimiento mediante varias conexiones TCP entre el cliente y el recurso compartido NFS. Configure las opciones de montaje con el valor óptimo de nconnect=4. Actualmente, no se logran mejoras más allá de cuatro canales para la implementación de nconnect de Azure Files.
clean N/D Es posible que se produzca un error en un montaje que no sea TLS si un montaje TLS anterior al mismo servidor finalizó abruptamente, dejando entradas obsoletas. Para resolver este problema, vuelva a montar el recurso compartido usando la opción clean, que borra de inmediato las entradas obsoletas. Esta opción solo se aplica al montaje AZNFS.

Validar conectividad

Si se produce un error en el montaje, es posible que el punto de conexión privado no esté configurado correctamente o que no sea accesible. Para obtener más información, consulte Comprobación de la conectividad.

Instantáneas de recurso compartido de archivos NFS

Puede tomar instantáneas de recursos compartidos de archivos cuando use recursos compartidos de archivos NFS de Azure. Esta funcionalidad le permite revertir sistemas de archivos completos o recuperar archivos que se eliminan o dañan accidentalmente. Consulte Uso de instantáneas de recurso compartido con Azure Files.

Paso siguiente