Amazon EFSでEC2間の共有ストレージをマルチAZ構成で設計する方法｜aws efs create-file-systemコマンドの実践手順

この記事のポイント

・EFSはNFSv4を使い、複数EC2から同時に読み書きできる共有ストレージ
・マウントターゲットを複数AZに配置することでAZ障害時も継続してアクセスできる
・aws efs create-file-systemで作成し、各AZのサブネットにマウントターゲットを設ける
・パフォーマンスモードはGeneral Purpose、スループットはElasticを最初に選ぶのが現実解

# EFSマウントターゲット用SGを作成
aws ec2 create-security-group \
  --group-name sg-efs-mount \
  --description "EFS mount target SG" \
  --vpc-id vpc-0a1b2c3d4e5f67890

# 出力例
# { "GroupId": "sg-0efs00001" }

# EC2のSGからNFS(TCP 2049)を許可（インターネット直接開放は厳禁）
aws ec2 authorize-security-group-ingress \
  --group-id sg-0efs00001 \
  --protocol tcp \
  --port 2049 \
  --source-group sg-0ec20001

# 出力例（成功時）
# { "Return": true, "SecurityGroupRules": [...] }

aws efs create-file-system \
  --performance-mode generalPurpose \
  --throughput-mode elastic \
  --encrypted \
  --tags Key=Name,Value=efs-web-shared

# 出力例（一部）
# {
#   "FileSystemId": "fs-0a1b2c3d4e5f67890",
#   "PerformanceMode": "generalPurpose",
#   "ThroughputMode": "elastic",
#   "Encrypted": true,
#   "LifeCycleState": "creating",
#   "Tags": [{"Key": "Name", "Value": "efs-web-shared"}]
# }

# 作成完了まで待機（"available"になるまで30秒程度）
aws efs describe-file-systems \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --query "FileSystems[0].[FileSystemId,LifeCycleState]" \
  --output text

# 出力例
# fs-0a1b2c3d4e5f67890   available

# AZ-a（ap-northeast-1a）にマウントターゲットを作成
aws efs create-mount-target \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --subnet-id subnet-0priv0001 \
  --security-groups sg-0efs00001

# 出力例
# {
#   "MountTargetId": "fsmt-0a1b2c3d4e5f00001",
#   "FileSystemId": "fs-0a1b2c3d4e5f67890",
#   "SubnetId": "subnet-0priv0001",
#   "LifeCycleState": "creating",
#   "IpAddress": "10.0.1.XXX",
#   "AvailabilityZoneName": "ap-northeast-1a"
# }

# AZ-c（ap-northeast-1c）にも同様に作成
aws efs create-mount-target \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --subnet-id subnet-0priv0002 \
  --security-groups sg-0efs00001

# マウントターゲットの一覧確認
aws efs describe-mount-targets \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --query "MountTargets[*].[AvailabilityZoneName,LifeCycleState,IpAddress]" \
  --output table

# 出力例（両AZがavailableになったことを確認）
# -----------------------------------------------------------
# |              DescribeMountTargets                       |
# +--------------------+-------------+--------------------+ |
# |  ap-northeast-1a   |  available  |  10.0.1.155        | |
# |  ap-northeast-1c   |  available  |  10.0.3.202        | |
# +--------------------+-------------+--------------------+ |

# Amazon Linux 2023の場合
sudo dnf install -y amazon-efs-utils

# Ubuntu / Debianの場合
sudo apt-get install -y amazon-efs-utils

# Rocky Linux / RHELでnfs-utilsを直接使う場合
sudo dnf install -y nfs-utils

# マウントポイント作成
sudo mkdir -p /mnt/efs

# EFSマウントヘルパーを使ってTLS暗号化マウント
sudo mount -t efs -o tls fs-0a1b2c3d4e5f67890:/ /mnt/efs

# マウント確認
df -hT | grep efs

# 出力例（ap-northeast-1aのEC2から接続した場合）
# 127.0.0.1:/   nfs4   8.0E  0 8.0E   0% /mnt/efs

# ファイルの書き込みテスト
echo "$(hostname): $(date)" | sudo tee /mnt/efs/test.txt

# 別のAZ（ap-northeast-1c）にある別のEC2から確認
cat /mnt/efs/test.txt
# → ip-10-0-1-105.ap-northeast-1.compute.internal: Mon Aug 10 11:30:00 UTC 2026

# apacheユーザー（UID=48, GID=48）向けのアクセスポイントを作成
aws efs create-access-point \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --posix-user '{"Uid": 48, "Gid": 48}' \
  --root-directory '{"Path": "/web-content", "CreationInfo": {"OwnerUid": 48, "OwnerGid": 48, "Permissions": "755"}}' \
  --tags Key=Name,Value=ap-apache

# 出力例（一部）
# {
#   "AccessPointId": "fsap-0abc123def456789",
#   "FileSystemId": "fs-0a1b2c3d4e5f67890",
#   "PosixUser": {"Uid": 48, "Gid": 48},
#   "RootDirectory": {"Path": "/web-content"}
# }

# アクセスポイント経由でマウント（-o accesspoint=fsap-xxx）
sudo mount -t efs \
  -o tls,accesspoint=fsap-0abc123def456789 \
  fs-0a1b2c3d4e5f67890 /var/www/html

# マウント後の所有者確認
ls -la /var/www/
# drwxr-xr-x 2 apache apache 6144 Sep 10 11:45 html

# /etc/fstab に追加する行（通常マウントの場合）
fs-0a1b2c3d4e5f67890:/  /mnt/efs  efs  defaults,_netdev,tls,nofail  0  0

# アクセスポイント使用時の場合
fs-0a1b2c3d4e5f67890:/  /var/www/html  efs  defaults,_netdev,tls,accesspoint=fsap-0abc123def456789,nofail  0  0

# fstabの設定を確認（アンマウント→再マウントで検証）
sudo umount /mnt/efs
sudo mount -a
df -hT | grep efs

# スループットモードの変更（BurstingからElasticへ）
aws efs update-file-system \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --throughput-mode elastic

# 変更確認
aws efs describe-file-systems \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --query "FileSystems[0].[PerformanceMode,ThroughputMode]" \
  --output text

# 出力例
# generalPurpose    elastic

# 30日間アクセスがないファイルをEFS IAへ移動
aws efs put-lifecycle-configuration \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --lifecycle-policies '[{"TransitionToIA":"AFTER_30_DAYS"}]'

# 確認
aws efs describe-lifecycle-configuration \
  --file-system-id fs-0a1b2c3d4e5f67890

# 出力例
# {
#   "LifecyclePolicies": [
#     { "TransitionToIA": "AFTER_30_DAYS" }
#   ]
# }

# アクセス後は標準クラスへ戻す設定も追加できる（IA→標準への自動復帰）
aws efs put-lifecycle-configuration \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --lifecycle-policies '[{"TransitionToIA":"AFTER_30_DAYS"},{"TransitionToPrimaryStorageClass":"AFTER_1_ACCESS"}]'

# マウントターゲットのIPアドレスを取得
aws efs describe-mount-targets \
  --file-system-id fs-0a1b2c3d4e5f67890 \
  --query "MountTargets[?AvailabilityZoneName=='ap-northeast-1a'].IpAddress" \
  --output text

# 出力例
# 10.0.1.155

# EC2からTCP 2049への疎通確認
nc -zvw 3 10.0.1.155 2049

# 疎通OKの例: Connection to 10.0.1.155 2049 port [tcp/nfs] succeeded!
# タイムアウト: sg-efs-mountのインバウンドルールを確認すること

# VPCのDNS解決設定を確認
aws ec2 describe-vpc-attribute \
  --vpc-id vpc-0a1b2c3d4e5f67890 \
  --attribute enableDnsSupport

# 出力例（有効な場合）
# { "VpcId": "vpc-0a1b2c3d4e5f67890", "EnableDnsSupport": { "Value": true } }

aws ec2 describe-vpc-attribute \
  --vpc-id vpc-0a1b2c3d4e5f67890 \
  --attribute enableDnsHostnames

# 出力例（有効な場合）
# { "VpcId": "vpc-0a1b2c3d4e5f67890", "EnableDnsHostnames": { "Value": true } }

# いずれかがfalseの場合、以下で有効化する
aws ec2 modify-vpc-attribute \
  --vpc-id vpc-0a1b2c3d4e5f67890 \
  --enable-dns-support '{"Value": true}'

aws ec2 modify-vpc-attribute \
  --vpc-id vpc-0a1b2c3d4e5f67890 \
  --enable-dns-hostnames '{"Value": true}'

# DNS解決を手動確認（EC2から実行）
nslookup fs-0a1b2c3d4e5f67890.efs.ap-northeast-1.amazonaws.com
# 同一AZのマウントターゲットIPが返れば正常

# amazon-efs-utilsの状態確認
rpm -qa | grep amazon-efs-utils
# 出力なし → インストール必要

# Amazon Linux 2023でインストール
sudo dnf install -y amazon-efs-utils

# nfs-utilsを使って直接NFSv4でマウントする代替手順
# （マウントターゲットのDNS名を使う。EFSマウントヘルパーより低機能）
sudo mount -t nfs4 \
  -o nfsvers=4.1,rsize=1048576,wsize=1048576,hard,timeo=600,retrans=2 \
  fs-0a1b2c3d4e5f67890.efs.ap-northeast-1.amazonaws.com:/ \
  /mnt/efs

# マウントポイントの所有者をapacheユーザーに変更
sudo chown apache:apache /mnt/efs
sudo chmod 755 /mnt/efs

# 確認
ls -la /mnt/
# drwxr-xr-x 2 apache apache 6144 Aug 10 11:45 efs