EFS ファイルシステム

インプロセスボリュームは、お客様が作成した EFS ファイルシステム上に配置されます。このボリュームは、チャートで自動プロビジョニングすることも、お客様が事前にプロビジョニングすることもできます。

	自動プロビジョニング (デフォルト)	事前プロビジョニング
お客様が作成するもの	ファイルシステム	ファイルシステム、アクセスポイント、PersistentVolume、クレーム
お客様が設定するもの	`storage.inProcess.efs.fileSystemId`	`storage.inProcess.existingClaim`
EFS CSI ドライバーの IAM	コントローラーに `AmazonEFSCSIDriverPolicy` を付与	不要

ファイルシステムを作成する

ファイルシステムには、ノードが稼働する各アベイラビリティーゾーンにマウントターゲットが必要です。各マウントターゲットには、ノードからの TCP 2049 のトラフィックを許可するセキュリティグループを設定してください。

FS_ID=$(aws efs create-file-system --region <region> \
  --encrypted --throughput-mode elastic \
  --tags Key=Name,Value=fineparser \
  --query FileSystemId --output text)

# アベイラビリティーゾーンごとに 1 回実行
aws efs create-mount-target --region <region> \
  --file-system-id $FS_ID --subnet-id <subnet-id> --security-groups <security-group-id>

エラスティックスループットは、ワーカープールの規模に応じてスケールします。

EFS CSI ドライバーをインストールする

自動プロビジョニングでは、ドライバーのコントローラーがアクセスポイントを作成するために AmazonEFSCSIDriverPolicy が必要です。

eksctl create iamserviceaccount \
  --cluster <cluster> --region <region> \
  --namespace kube-system --name efs-csi-controller-sa \
  --role-name AmazonEKS_EFS_CSI_DriverRole --role-only \
  --attach-policy-arn arn:aws:iam::aws:policy/service-role/AmazonEFSCSIDriverPolicy \
  --approve

aws eks create-addon --region <region> --cluster-name <cluster> \
  --addon-name aws-efs-csi-driver \
  --service-account-role-arn arn:aws:iam::<account>:role/AmazonEKS_EFS_CSI_DriverRole

事前にプロビジョニングされたボリュームを使用する場合、このロールは不要です。その他のインストール方法については、Amazon EKS ドキュメントの Amazon EFS を参照してください。

自動プロビジョニング

fineparser-values.yaml

storage:
  inProcess:
    efs:
      fileSystemId: fs-0123456789abcdef0

チャートは StorageClass <release>-in-process を作成し、それを使用してクレームを作成します。ドライバーは、このクレーム用に、ユーザー 65534 が所有するアクセスポイントを作成します。basePath などの追加の EFS CSI ドライバーのパラメーターは、storage.inProcess.storageClass.parameters の下に指定します。

事前プロビジョニング

UID 65534 が所有するアクセスポイントを作成する

aws efs create-access-point --region <region> --file-system-id $FS_ID \
  --posix-user Uid=65534,Gid=65534 \
  --root-directory 'Path=/fineparser,CreationInfo={OwnerUid=65534,OwnerGid=65534,Permissions=755}' \
  --query AccessPointId --output text

ファイルシステムのルートを直接マウントしないでください。ルートは root の所有であるため、FineParser から書き込むことはできません。

ボリュームとクレームを作成する

fineparser-in-process.yaml

apiVersion: v1
kind: PersistentVolume
metadata:
  name: fineparser-in-process
spec:
  capacity:
    storage: 10Gi
  accessModes: [ReadWriteMany]
  persistentVolumeReclaimPolicy: Retain
  storageClassName: ""
  csi:
    driver: efs.csi.aws.com
    volumeHandle: fs-0123456789abcdef0::fsap-0123456789abcdef0
---
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: fineparser-in-process
  namespace: fineparser
spec:
  accessModes: [ReadWriteMany]
  storageClassName: ""
  volumeName: fineparser-in-process
  resources:
    requests:
      storage: 10Gi

チャートでクレームを指定する

fineparser-values.yaml

storage:
  inProcess:
    existingClaim: fineparser-in-process

はじめに

基礎

概念

ベストプラクティス

AWS

リファレンス

ファイルシステムを作成する

EFS CSI ドライバーをインストールする

自動プロビジョニング

事前プロビジョニング

​ファイルシステムを作成する

​EFS CSI ドライバーをインストールする

​自動プロビジョニング

​事前プロビジョニング

ファイルシステムを作成する

EFS CSI ドライバーをインストールする

自動プロビジョニング

事前プロビジョニング