Azure FilesをLinuxからマウントする方法｜NFS・SMB共有の作成からfstabによる永続化まで

この記事のポイント

・SMBマウントは cifs-utils をインストールして mount -t cifs で実行できる
・NFS 4.1マウントは Premium File Shares 限定・VNet 接続が必須
・/etc/smbcredentials に認証情報を分離し fstab に直書きしない
・nofail オプションを fstab に付けてネットワーク障害時の起動失敗を防ぐ

# リソースグループの作成
$ az group create --name rg-files-test --location japaneast

# Standard ストレージアカウント（SMB用）
$ az storage account create \
    --name mystgaccountlinux01 \
    --resource-group rg-files-test \
    --location japaneast \
    --sku Standard_LRS \
    --kind StorageV2

# Premium ストレージアカウント（NFS用）
$ az storage account create \
    --name mypremiumfiles01 \
    --resource-group rg-files-test \
    --location japaneast \
    --sku Premium_LRS \
    --kind FileStorage

# SMB 用ファイル共有（クォータは GiB 単位）
$ az storage share-rm create \
    --resource-group rg-files-test \
    --storage-account mystgaccountlinux01 \
    --name myshare \
    --quota 100 \
    --enabled-protocols SMB

# NFS 用ファイル共有（Premium アカウントのみ有効）
$ az storage share-rm create \
    --resource-group rg-files-test \
    --storage-account mypremiumfiles01 \
    --name mynfsshare \
    --quota 100 \
    --enabled-protocols NFS

$ az storage account keys list \
    --resource-group rg-files-test \
    --account-name mystgaccountlinux01 \
    --query "[0].value" -o tsv
Abcde1234FGHijklMNOPQRstuvwxyz/AbcdEFGHijkLmNOpQRSTUVwxyz0123456789==

# Ubuntu 24.04 LTS の場合
$ sudo apt update
$ sudo apt install -y cifs-utils

# Rocky Linux 9.4 / RHEL 9.x の場合
$ sudo dnf install -y cifs-utils

# 認証情報ファイルの作成
$ sudo vi /etc/smbcredentials

# --- ファイルの内容 ---
username=mystgaccountlinux01
password=Abcde1234FGHijklMNOPQRstuvwxyz/AbcdEFGHijkLmNOpQRSTUVwxyz0123456789==
# --- ここまで ---

# パーミッションを root のみ読み取り可に設定
$ sudo chmod 600 /etc/smbcredentials
$ sudo chown root:root /etc/smbcredentials

# 確認
$ sudo ls -la /etc/smbcredentials
-rw------- 1 root root 124 Jul 14 09:00 /etc/smbcredentials

# マウントポイントの作成
$ sudo mkdir -p /mnt/azurefiles

# SMB でマウント（テスト）
$ sudo mount -t cifs \
    //mystgaccountlinux01.file.core.windows.net/myshare \
    /mnt/azurefiles \
    -o credentials=/etc/smbcredentials,serverino,nosharesock,actimeo=30

# マウント確認
$ df -h /mnt/azurefiles
Filesystem                                                       Size  Used Avail Use% Mounted on
//mystgaccountlinux01.file.core.windows.net/myshare              100G  128M  100G   1% /mnt/azurefiles

# ファイルの読み書きテスト
$ echo "test write" | sudo tee /mnt/azurefiles/test.txt
test write
$ cat /mnt/azurefiles/test.txt
test write

# Ubuntu 24.04 LTS の場合
$ sudo apt update
$ sudo apt install -y nfs-common

# Rocky Linux 9.4 / RHEL 9.x の場合
$ sudo dnf install -y nfs-utils

# ストレージアカウントのネットワーク設定に VNet を追加
$ az storage account network-rule add \
    --resource-group rg-files-test \
    --account-name mypremiumfiles01 \
    --vnet-name myVNet \
    --subnet mySubnet

# デフォルトアクセスを「Deny」に変更（VNet 内のみ許可）
$ az storage account update \
    --resource-group rg-files-test \
    --name mypremiumfiles01 \
    --default-action Deny

# マウントポイントの作成
$ sudo mkdir -p /mnt/nfsshare

# NFS 4.1 でマウント（VNet 内 VM から実行）
$ sudo mount -t nfs mypremiumfiles01.file.core.windows.net:/mypremiumfiles01/mynfsshare \
    /mnt/nfsshare \
    -o vers=4,minorversion=1,sec=sys

# マウント確認
$ df -h /mnt/nfsshare
Filesystem                                                       Size  Used Avail Use% Mounted on
mypremiumfiles01.file.core.windows.net:/mypremiumfiles01/mynfsshare
                                                                 100G   10M  100G   1% /mnt/nfsshare

# 書き込みテスト
$ sudo touch /mnt/nfsshare/nfstest.txt
$ ls -la /mnt/nfsshare/nfstest.txt
-rw-r--r-- 1 root root 0 Jul 14 09:05 /mnt/nfsshare/nfstest.txt

# /etc/fstab への追記内容（SMB）
//mystgaccountlinux01.file.core.windows.net/myshare  /mnt/azurefiles  cifs  credentials=/etc/smbcredentials,serverino,nosharesock,actimeo=30,nofail,_netdev  0  0

# /etc/fstab への追記内容（NFS）
mypremiumfiles01.file.core.windows.net:/mypremiumfiles01/mynfsshare  /mnt/nfsshare  nfs  vers=4,minorversion=1,sec=sys,nofail,_netdev  0  0

# fstab の構文確認（実際にはマウントしない）
$ sudo mount -a --fake

# fstab に基づいて全マウントポイントをマウント
$ sudo mount -a

# マウント状態の確認
$ mount | grep azurefiles
//mystgaccountlinux01.file.core.windows.net/myshare on /mnt/azurefiles type cifs (rw,relatime,vers=3.1.1,cache=strict,username=mystgaccountlinux01,uid=0,noforceuid,gid=0,noforcegid,addr=52.239.x.x,file_mode=0755,dir_mode=0755,soft,nosharesock,serverino,mapposix,nofail,_netdev,actimeo=30)

# ポート 445 の疎通確認（Linux VM から Azure へ）
$ nc -zv mystgaccountlinux01.file.core.windows.net 445
Connection to mystgaccountlinux01.file.core.windows.net (52.239.x.x) 445 port [tcp/microsoft-ds] succeeded!

# 接続できない場合（タイムアウト）
$ nc -zv mystgaccountlinux01.file.core.windows.net 445
nc: connect to mystgaccountlinux01.file.core.windows.net port 445 (tcp) failed: Connection timed out

# 認証情報ファイルのパーミッション確認
$ sudo ls -la /etc/smbcredentials
-rw------- 1 root root 124 Jul 14 09:00 /etc/smbcredentials

# 600 でなければ修正
$ sudo chmod 600 /etc/smbcredentials

# ストレージキーの再確認
$ az storage account keys list \
    --resource-group rg-files-test \
    --account-name mystgaccountlinux01 \
    --query "[0].value" -o tsv

# 許可済みネットワークの確認
$ az storage account show \
    --name mypremiumfiles01 \
    --resource-group rg-files-test \
    --query "networkRuleSet" -o table

Action    Bypass
--------  -------
Deny      AzureServices

# VM のサブネット情報を確認（VM 上で実行）
$ ip route show
default via 10.0.0.1 dev eth0 proto dhcp
10.0.0.0/24 dev eth0 proto kernel scope link src 10.0.0.4

# アンマウントして再マウント
$ sudo umount /mnt/azurefiles
$ sudo mount /mnt/azurefiles

# umount できない場合（プロセスが掴んでいる）
$ sudo lsof /mnt/azurefiles
# lsof 結果でプロセスを特定してから kill または fuser -k
$ sudo fuser -km /mnt/azurefiles