Ir para o conteúdo

Como soluciono problemas com minhas montagens de volume do Amazon EFS no Amazon EKS?

7 minuto de leitura
0

Eu recebo uma mensagem de erro quando tento montar meus volumes do Amazon Elastic File System (Amazon EFS) no meu cluster do Amazon Elastic Kubernetes Service (Amazon EKS).

Resolução

Pré-requisitos:

  • Certifique-se de que seu sistema de arquivos do Amazon EFS tenha um destino de montagem em cada uma das sub-redes do nó de processamento da Zona de disponibilidade.
  • Confirme se você usa efs.csi.aws.com na definição da classe de armazenamento do Amazon EFS.
  • Verifique se você usa PersistentVolumeClaim e PersistentVolume.
    Observação: se você usa provisionamento dinâmico, não precisa usar PersistentVolumeClaim e PersistentVolume.
  • Certifique-se de ter instalado o complemento do driver CSI do Amazon EFS no cluster do EKS.

Verifique se você configurou corretamente a rede dos nós de processamento do EKS na API do Amazon EFS

Certifique-se de ter acesso à API do Amazon EFS a partir dos nós de processamento do EFS e dos pods do controlador do EFS.

Se você não configurar a rede para acessar a API do Amazon EFS, pode receber uma das seguintes mensagens de erro:

  • “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”

Se você usa um cluster privado sem acesso de saída à internet, deve incluir o endpoint de nuvem privada virtual (VPC) com.amazonaws.region.elasticfilesystem em sua VPC. Crie uma regra de entrada para o grupo de segurança do endpoint da VPC que permita que o tráfego para a porta 443 a partir de seus nós de processamento e sub-redes de pods. Certifique-se de que a política anexada ao endpoint da VPC tenha as permissões necessárias.

Verifique se você configurou corretamente os destinos de montagem do Amazon EFS

Certifique-se de ter criado os destinos de montagem do Amazon EFS em cada Zona de disponibilidade em que os nós do EKS são executados. Por exemplo, se você distribuiu seus nós de processamento entre us-east-1a e us-east-1b, crie destinos de montagem em ambas as Zonas de disponibilidade no sistema de arquivos do EFS que você deseja montar.

Se você não configurar corretamente os destinos de montagem, pode receber a seguinte mensagem de erro:

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

Verifique se o grupo de segurança associado ao seu sistema de arquivos do Amazon EFS e aos nós de processamento permite o tráfego do NFS

Se o grupo de segurança não permitir tráfego, você pode receber uma das seguintes mensagens de erro:

  • “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”

O grupo de segurança do sistema de arquivos do Amazon EFS deve ter uma regra de entrada que permita o tráfego do network file system (NFS) do Encaminhamento entre domínios sem classificação (CIDR) para a VPC do seu cluster. Permita a porta 2049 para tráfego de entrada.

O grupo de segurança associado aos nós de processamento nos quais os pods não conseguem montar o volume do EFS deve ter uma regra de saída. A regra de saída deve permitir o tráfego do NFS da porta 2049 para o sistema de arquivos do EFS.

Verifique se você criou o caminho do subdiretório em seu sistema de arquivos do Amazon EFS

Se você adicionar caminhos de subdiretório em volumes persistentes, o driver CSI do Amazon EFS não cria o caminho do subdiretório no sistema de arquivos. Você já deve ter o subdiretório no sistema de arquivos para que a operação de montagem seja bem-sucedida. Se o subdiretório não estiver no sistema de arquivos, você pode receber a seguinte mensagem de erro:

“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”

Para verificar se o subdiretório existe no sistema de arquivos do EFS, monte o sistema de arquivos do EFS em uma instância do EC2 e liste seu conteúdo. Se o subdiretório não existir, use o comando mkdir para criá-lo.

Confirme se a VPC do cluster usa o servidor DNS da Amazon

Ao montar o volume do EFS com o driver CSI do Amazon EFS, você deve usar o servidor DNS da Amazon na VPC.

Observação: somente o DNS fornecido pela Amazon pode resolver o DNS do sistema de arquivos do serviço do Amazon EFS.

Para verificar o servidor DNS, faça login no nó de processamento e execute o seguinte comando:

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

Observação: substitua region pela sua região da AWS. Substitua AMAZON_PROVIDED_DNS_IP pelo seu endereço IP DNS.

Se o servidor DNS personalizado não encaminhar as solicitações, você pode receber a seguinte mensagem de erro:

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

Se a VPC do cluster usar um servidor DNS personalizado, configure esse servidor DNS para encaminhar todas as solicitações *.amazonaws.com ao servidor DNS da Amazon.

Verifique se você tem opções de montagem do iam na definição de PersistentVolume ao usar uma política restritiva do sistema de arquivos

Se você não adicionar a opção de montagem do iam com uma política restritiva do sistema de arquivos, os pods falharão com uma mensagem de erro semelhante à seguinte:

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

Se você configurou o sistema de arquivos do Amazon EFS para restringir as permissões de montagem a perfis específicos do AWS Identity and Access Management (AWS IAM), use a montagem -o iam. Inclua a propriedade spec.mountOptions para permitir que o driver CSI adicione a opção de montagem do IAM.

Exemplo:

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

Verifique se você anotou a conta de serviço do controlador do driver CSI do Amazon EFS com o perfil do IAM correto que tem as permissões necessárias

Para verificar se a conta de serviço usada pelos pods de efs-csi-controller tem a anotação correta, execute o seguinte comando:

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

Exemplo de saída:

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

Para confirmar se a conta tem os perfis e permissões corretos do AWS Identity and Access Management (AWS IAM), verifique o provedor de OIDC do IAM do cluster. Verifique se o perfil do IAM associado à conta de serviço efs-csi-controller-sa tem as permissões necessárias para realizar chamadas de API do EFS. Em seguida, verifique se a política de confiança do perfil do IAM confia na conta de serviço efs-csi-controller-sa.

Exemplo de política de confiança do perfil do 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"  
        }  
      }  
    }  
  ]  
}

Verifique se os pods do driver CSI do EFS estão em execução

Para verificar se esses pods estão sendo ativos no seu cluster, execute o seguinte comando:

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

Verifique a operação de montagem do EFS a partir do nó de processamento do EC2 em que o pod está falhando ao montar o sistema de arquivos

Faça login no nó de processamento do Amazon EKS do pod. Em seguida, use o assistente de montagem do EFS para montar manualmente o sistema de arquivos do EFS no nó de processamento. Para testar a operação de montagem, execute o seguinte comando:

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

Se o nó de processamento puder montar o sistema de arquivos, analise os logs efs-plugin do controlador CSI e dos pods de nós CSI.

Verifique os logs de pod do driver CSI do EFS para identificar a causa das falhas de montagem

Se o volume não estiver sendo montado, analise os logs efs-plugin. Para recuperar os logs de contêiner efs-plugin, execute os seguintes comandos:

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 OFICIALAtualizada há um ano