5.9. AWS Elastic File Service CSI ドライバー Operator

• AWS EFS CSI ドライバー Operatorをインストールしても、永続ボリューム要求 (PVC) の作成に使用するストレージクラスがデフォルトで作成されません。ただし、AWS EFS StorageClass を手動で作成することは可能です。AWS EFS CSI ドライバー Operator は、ストレージボリュームをオンデマンドで作成できるようにし、クラスター管理者がストレージを事前にプロビジョニングする必要がなくすことで、動的ボリュームのプロビジョニングをサポートします。
• AWS EFS CSI ドライバー を使用すると、AWS EFS PV を作成し、マウントできます。

前提条件

• OpenShift Container Platform Web コンソールにアクセスできる。

前提条件

• AWS アカウントの認証情報

前提条件

• AWS アカウントの認証情報

前提条件

• AWS EFS ボリュームを作成している。
• AWS EFS ストレージクラスを作成している。

• 上記で作成した StorageClass を参照して、通常通り PVC(または StatefulSet や Template) を作成します。

  apiVersion: v1
  kind: PersistentVolumeClaim
  metadata:
    name: test
  spec:
    storageClassName: efs-sc
    accessModes:
      - ReadWriteMany
    resources:
      requests:
        storage: 5Gi

前提条件

• 作成済みの AWS EFS ボリューム

手順

• 以下の YAML ファイルで PV を作成します。

  apiVersion: v1
  kind: PersistentVolume
  metadata:
    name: efs-pv
  spec:
    capacity: 1
      storage: 5Gi
    volumeMode: Filesystem
    accessModes:
      - ReadWriteMany
      - ReadWriteOnce
    persistentVolumeReclaimPolicy: Retain
    csi:
      driver: efs.csi.aws.com
      volumeHandle: fs-ae66151a 2
      volumeAttributes:
        encryptInTransit: "false" 3

  1

  spec.capacity には意味がなく、CSI ドライバーでは無視されます。PVC へのバインディング時にのみ使用されます。アプリケーションは、ボリュームに任意の量のデータを保存することができます。

  2

  volumeHandle は、AWS で作成した EFS ボリュームと同じ ID である必要があります。独自のアクセスポイントを提供する場合、volumeHandle は <EFS volume ID>::<access point ID> とします。例:fs-6e633ada::fsap-081a1d293f0004630

  3

  必要に応じて、転送中の暗号化を無効にすることができます。デフォルトでは、暗号化が有効になっています。

• AWS EFS Operator と CSI ドライバーは、namespace openshift-cluster-csi-drivers で実行されます。

• AWS EFS Operator と CSI ドライバーのログ収集を開始するには、以下のコマンドを実行します。

  $ oc adm must-gather
  [must-gather      ] OUT Using must-gather plugin-in image: quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:125f183d13601537ff15b3239df95d47f0a604da2847b561151fedd699f5e3a5
  [must-gather      ] OUT namespace/openshift-must-gather-xm4wq created
  [must-gather      ] OUT clusterrolebinding.rbac.authorization.k8s.io/must-gather-2bd8x created
  [must-gather      ] OUT pod for plug-in image quay.io/openshift-release-dev/ocp-v4.0-art-dev@sha256:125f183d13601537ff15b3239df95d47f0a604da2847b561151fedd699f5e3a5 created

• AWS EFS Operator のエラーを表示するには、ClusterCSIDriver のステータスを表示します。

  $ oc get clustercsidriver efs.csi.aws.com -o yaml

• Pod にボリュームをマウントできない場合 (以下のコマンドの出力に示す):

  $ oc describe pod
  ...
    Type     Reason       Age    From               Message
    ----     ------       ----   ----               -------
    Normal   Scheduled    2m13s  default-scheduler  Successfully assigned default/efs-app to ip-10-0-135-94.ec2.internal
    Warning  FailedMount  13s    kubelet            MountVolume.SetUp failed for volume "pvc-d7c097e6-67ec-4fae-b968-7e7056796449" : rpc error: code = DeadlineExceeded desc = context deadline exceeded 1
    Warning  FailedMount  10s    kubelet            Unable to attach or mount volumes: unmounted volumes=[persistent-storage], unattached volumes=[persistent-storage kube-api-access-9j477]: timed out waiting for the condition

  1

  ボリュームがマウントされていないことを示す警告メッセージ。

  このエラーは、OpenShift Container Platform ノードと AWS EFS 間のパケットを AWS がドロップすることで頻繁に発生します。

  以下の内容が正しいことを確認してください (AWS における EFS ボリュームへのアクセスの作成と設定 を参照)。

  • AWS のファイアウォールとセキュリティーグループ
  • ネットワーク: ポート番号と IP アドレス

前提条件

• OpenShift Container Platform Web コンソールにアクセスできる。