スキップしてコンテンツを表示

Amazon EKS において、Amazon EFS ボリュームのマウントに関する問題をトラブルシューティングする方法を教えてください。

所要時間3分
0

Amazon Elastic Kubernetes Service (Amazon EKS) クラスターに Amazon Elastic File System (Amazon EFS) ボリュームのマウントを試みると、エラーが発生します。

解決策

**前提条件: **

  • Amazon EFS ファイルシステムに、アベイラビリティーゾーンの各ワーカーノードサブネット内にマウントターゲットがあることを確認します。
  • Amazon EFS ストレージクラスの定義で efs.csi.aws.com を指定したことを確認します。
  • PersistentVolumeClaim と PersistentVolume を使用していることを確認します。
    **注: ** 動的プロビジョニングを使用する場合は、PersistentVolumeClaim および PersistentVolume を使用する必要はありません。
  • EKS クラスターに Amazon EFS CSI ドライバーアドオンをインストールしていることを確認します。

EKS ワーカーノードから Amazon EFS API へのネットワークが正しく構成されていることを確認する

EFS ワーカーノードおよび EFS コントローラーポッドから Amazon EFS API にアクセスできることを確認します。

Amazon EFS API に到達するようにネットワークを構成していない場合は、次のいずれかのエラーメッセージが表示されることがあります。

  • "failed to provision volume with StorageClass "xxxx": rpc error: code = DeadlineExceeded desc = context deadline exceeded"
  • "Could not start amazon-efs-mount-watchdog, unrecognized init system "bash" Mount attempt x/3 failed due to timeout after 15 sec"
  • "Unable to attach or mount volumes: timed out waiting for the condition"

アウトバウンドインターネットアクセスのないプライベートクラスターを使用する場合は、VPC に com.amazonaws.region.elasticfilesystem 仮想プライベートクラウド (VPC) エンドポイントを含める必要があります。ワーカーノードおよびポッドのサブネットからポート 443 へのトラフィックを許可する、VPC エンドポイントのセキュリティグループのインバウンドルールを作成します。VPC エンドポイントにアタッチされているポリシーに必要なアクセス許可があることを確認します。

Amazon EFS マウントターゲットが正しく構成されていることを確認する

EKS ノードが実行される各アベイラビリティーゾーンに Amazon EFS マウントターゲットを作成していることを確認します。例えば、ワーカーノードを us-east-1a と us-east-1b に分散させた場合は、マウントする EFS ファイルシステムのマウントターゲットを両方のアベイラビリティーゾーンに作成します。

マウントターゲットを正しく構成していない場合は、次のエラーメッセージが表示されることがあります。

"Output: Failed to resolve "fs-xxxxxx.efs.us-east-1.amazonaws.com" - The file system mount target ip address cannot be found"

Amazon EFS ファイルシステムとワーカーノードに関連付けられたセキュリティグループが NFS トラフィックを許可していることを確認する

セキュリティグループがトラフィックを許可していない場合は、次のいずれかのエラーメッセージが表示されることがあります。

  • "Could not start amazon-efs-mount-watchdog, unrecognized init system "bash" Mount attempt x/3 failed due to timeout after 15 sec"
  • "failed to provision volume with StorageClass "xxxx": rpc error: code = DeadlineExceeded desc = context deadline exceeded"
  • "Unable to attach or mount volumes: timed out waiting for the condition"

Amazon EFS ファイルシステムのセキュリティグループには、クラスターの VPC の Classless Inter-Domain Routing (CIDR) からのネットワークファイルシステム (NFS) トラフィックを許可するインバウンドルールが必要です。ポート 2049 でのインバウンドトラフィックを許可します。

ポッドが EFS ボリュームのマウントに失敗するワーカーノードに関連付けられているセキュリティグループには、アウトバウンドルールが必要です。アウトバウンドルールは、ポート 2049 から EFS ファイルシステムへの NFS トラフィックを許可する必要があります。

Amazon EFS ファイルシステムにサブディレクトリパスを作成したことを確認する

サブディレクトリのパスを永続ボリュームに追加する場合、Amazon EFS CSI ドライバーはファイルシステム内にサブディレクトリのパスを作成しません。マウント操作を成功させるには、ファイルシステムにサブディレクトリが既に存在している必要があります。サブディレクトリがファイルシステムにない場合は、次のエラーメッセージが表示されることがあります。

"Output: mount.nfs4: mounting fs-18xxxxxx.efs.us-east-1.amazonaws.com:/path-in-dir:/ failed, reason given by server: No such file or directory"

EFS ファイルシステムにサブディレクトリが存在するかどうかを確認するには、EC2 インスタンスに EFS ファイルシステムをマウントし、その内容を一覧表示します。サブディレクトリが存在しない場合は、mkdir コマンドで作成します。

クラスターの VPC が Amazon DNS サーバーを使用していることを確認する

Amazon EFS CSI ドライバーで EFS ボリュームをマウントする場合は、VPC に Amazon DNS サーバーを使用する必要があります。

**注: ** Amazon が提供する DNS のみが、Amazon EFS サービスのファイルシステム DNS を解決できます。

DNS サーバーを確認するには、ワーカーノードにログインし、次のコマンドを実行してください。

nslookup fs-4fxxxxxx.efs.region.amazonaws.com AMAZON_PROVIDED_DNS_IP

**注: ** region を AWS リージョンに置き換えてください。AMAZON_PROVIDED_DNS_IP を DNS の IP アドレスに置き換えてください。

カスタム DNS サーバーがリクエストを転送しない場合は、次のエラーメッセージが表示されることがあります。

"Output: Failed to resolve "fs-xxxxxx.efs.us-west-2.amazonaws.com" - The file system mount target ip address cannot be found"

クラスター VPC でカスタム DNS サーバーを使用する場合は、この DNS サーバーにおいて、*.amazonaws.com に一致するすべてのリクエストを Amazon DNS サーバーに転送するように設定します。

制限付きファイルシステムポリシーを使用する場合は、PersistentVolume 定義に iam マウントオプションがあることを確認する

制限的なファイルポリシーに iam マウントオプションが追加されていない場合、ポッドで障害が発生し、次のエラーメッセージが表示されます。

"mount.nfs4: access denied by server while mounting 127.0.0.1:/"

Amazon EFS ファイルシステムにおいて、マウント権限を特定の AWS Identity and Access Management (IAM) ロールのみに制限する設定を行った場合は、-o iam マウントオプションを指定します。CSI ドライバーに IAM マウントオプションの追加を許可するには、spec.mountOptions プロパティを含めてください。

例:

apiVersion: v1  
kind: PersistentVolume  
metadata:  
  name: efs-pv1  
spec:  
  mountOptions:  
    - iam

必要なアクセス許可を持つ正しい IAM ロールで、Amazon EFS CSI ドライバーコントローラーのサービスアカウントにアノテーションが付与されていることを確認する

efs-csi-controller ポッドが使用するサービスアカウントに適切なアノテーションが付与されていることを確認するには、次のコマンドを実行します。

kubectl describe sa efs-csi-controller-sa -n kube-system

出力例:

eks.amazonaws.com/role-arn: arn:aws:iam::111122223333:role/AmazonEKS_EFS_CSI_DriverRole

アカウントに適切な AWS Identity and Access Management (IAM) ロールとアクセス許可が存在することを確認するには、クラスターの IAM OIDC プロバイダーを検証します。efs-csi-controller-sa サービスアカウントに関連付けられた IAM ロールには、EFS API コールの実行に必要なアクセス許可が含まれることを確認します。次に、IAM ロールの信頼ポリシーは、サービスアカウント efs-csi-controller-sa を信頼していることを確認します。

IAM ロールの信頼ポリシー例:

{  
  "Version": "2012-10-17",  
  "Statement": [  
    {  
      "Effect": "Allow",  
      "Principal": {  
        "Federated": "arn:aws:iam::111122223333:oidc-provider/oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE"  
      },  
      "Action": "sts:AssumeRoleWithWebIdentity",  
      "Condition": {  
        "StringLike": {  
          "oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:sub": "system:serviceaccount:kube-system:efs-csi-*",  
          "oidc.eks.region-code.amazonaws.com/id/EXAMPLED539D4633E53DE1B71EXAMPLE:aud": "sts.amazonaws.com"  
        }  
      }  
    }  
  ]  
}

EFS CSI ドライバーポッドが実行中であることを確認する

これらのポッドがクラスターにおいてアクティブであることを確認するには、次のコマンドを実行してください。

kubectl get all -l app.kubernetes.io/name=aws-efs-csi-driver -n kube-system

ポッドがファイルシステムをマウントできない EC2 ワーカーノードから行われる EFS マウント操作を確認する

ポッドの Amazon EKS ワーカーノードにログインします。次に、EFS マウントヘルパーを使用して、EFS ファイルシステムをワーカーノードに手動でマウントします。マウント操作をテストするには、次のコマンドを実行してください。

sudo mount -t efs -o tls file-system-dns-name efs-mount-point/

ワーカーノードがファイルシステムをマウントできる場合は、CSI コントローラーと CSI ノードポッドの efs-plugin ログを確認します。

EFS CSI ドライバーポッドのログを参照し、マウントできない原因を判断する

ボリュームをマウントできない場合は、efs-plugin ログを参照します。efs-plugin コンテナログを取得するには、次のコマンドを実行してください。

kubectl logs deployment/efs-csi-controller -n kube-system -c efs-plugin  
kubectl logs daemonset/efs-csi-node -n kube-system -c efs-plugin
AWS公式更新しました 1年前
コメントはありません

関連するコンテンツ