Usar um recurso EFS

O Elastic File System (EFS) é o mecanismo subjacente da AWS para fornecer armazenamento (espaço em disco) ao cluster. Um PersistentVolume é um recurso de cluster que disponibiliza o armazenamento EFS para suas cargas de trabalho e garante que ele persista mesmo quando nenhuma carga de trabalho estiver conectada a ele. Neste tópico, descrevemos como uma carga de trabalho pode acessar um PersistentVolume com uma PersistentVolumeClaim.

O GKE na AWS dá suporte ao provisionamento estático de PersistentVolumes para todas as versões compatíveis do Kubernetes. Para clusters no Kubernetes 1.24 ou mais recente, o GKE na AWS também é compatível com o provisionamento dinâmico. Para usar o provisionamento dinâmico, o administrador do cluster precisa configurá-lo. Saiba como fazer isso em Configurar um PersistentVolume.

Criar um PersistentVolumeClaim

Escolha a guia apropriada abaixo, de acordo com sua preferência entre conectar a carga de trabalho a um volume permanente provisionado estaticamente ou dinamicamente.

Estática

Estas instruções presumem que o administrador do cluster já tenha provisionado pelo menos um PersistentVolume. Para acessar esse PersistentVolume e usar o EFS subjacente com suas cargas de trabalho, crie um PersistentVolumeClaim.

Para criar um PersistentVolumeClaim para um PersistentVolume provisionado estaticamente, copie o seguinte manifesto YAML em um arquivo chamado efs-claim.yaml.

apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: CLAIM_NAME
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: "" # Leave as empty string for static provisioning
  resources:
    requests:
      storage: 5Gi

Substitua:

  • CLAIM_NAME: um nome escolhido para a vinculação do PersistentVolumeClaim (por exemplo, efs-claim1). Deixe em branco para vincular à classe de armazenamento padrão
  1. Aplique o YAML ao cluster.

      kubectl apply -f efs-claim.yaml
    

    A saída confirma a criação do PersistentVolumeClaim.

    persistentvolumeclaim/CLAIM_NAME created
    

Dynamic

Estas instruções presumem que o administrador do cluster já tenha provisionado pelo menos um StorageClass para provisionamento dinâmico. Para criar um PersistentVolume provisionado dinamicamente com essa StorageClass e usar o ponto de acesso EFS subjacente com suas cargas de trabalho, crie uma PersistentVolumeClaim.

Para criar um PersistentVolumeClaim, siga estas etapas. O driver CSI do EFS usa essa PersistentVolumeClaim com a StorageClass indicada para provisionar dinamicamente um PersistentVolume.

  1. Copie o seguinte manifesto do YAML para um arquivo chamado efs-claim.yaml:
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: CLAIM_NAME
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: "EFS_STORAGE_CLASS_NAME"
  resources:
    requests:
      storage: 5Gi

Substitua:

  • CLAIM_NAME: um nome escolhido para a PersistentVolumeClaim, por exemplo, efs-claim1
  • EFS_STORAGE_CLASS_NAME: o nome da StorageClass para a vinculação da PersistentVolumeClaim. Deixe esse campo em branco para vincular à classe de armazenamento padrão.
  1. Aplique o YAML ao cluster.

      kubectl apply -f efs-claim.yaml
    

    A saída confirma a criação do PersistentVolumeClaim.

    persistentvolumeclaim/CLAIM_NAME created
    

Crie um StatefulSet

Depois de criar um PersistentVolumeClaim, você pode usá-lo em uma carga de trabalho. Nesta seção, criamos um exemplo de StatefulSet que usa uma PersistentVolumeClaim. Também é possível usar um PersistentVolumeClaim com outros tipos de carga de trabalho, como pods e implantações, fazendo referência à declaração em spec.volumes.

Para criar um StatefulSet que monte o recurso de EFS referenciado no PersistentVolumeClaim, execute as etapas a seguir.

  1. Copie o seguinte manifesto do YAML para um arquivo chamado efs-statefulset.yaml: Este manifesto de exemplo inicia um contêiner do Ubuntu Linux que monta seu recurso de EFS em /efs-data. O contêiner grava a cada cinco segundos em um arquivo no recurso EFS chamado out.txt.

    apiVersion: apps/v1
    kind: StatefulSet
    metadata:
      name: efs-shell
    spec:
      selector:
        matchLabels:
          app: test-efs
      serviceName: efs-app
      replicas: 1
      template:
        metadata:
          labels:
            app: test-efs
        spec:
          terminationGracePeriodSeconds: 10
          containers:
          - name: linux
            image: ubuntu:bionic
            command: ["/bin/sh"]
            args: ["-c", "while true; do echo $(date -u) >> /efs-data/out.txt; sleep 5; done"]
            volumeMounts:
            - name: efs-volume
              mountPath: /efs-data
          volumes:
          - name: efs-volume
            persistentVolumeClaim:
              claimName: CLAIM_NAME
    

    Substitua CLAIM_NAME pelo nome da PersistentVolumeClaim especificada anteriormente, por exemplo, efs-claim1.

  2. Aplique o YAML ao cluster.

     kubectl apply -f efs-statefulset.yaml
    

    A resposta confirma a criação do StatefulSet.

    statefulset.apps/efs-shell created
    

    O StatefulSet pode levar vários minutos para fazer o download e iniciar a imagem do contêiner.

  3. Confirme se o pod de StatefulSet está no status Running com kubectl get pods.

      kubectl get pods -l app=test-efs
    

    A resposta inclui o nome do pod e o status dele. Na resposta a seguir, o nome do pod é efs-shell-0.

    NAME          READY   STATUS    RESTARTS   AGE
    efs-shell-0   1/1     Running   0          1m
    
  4. Depois que o pod estiver no status "Em execução", use kubectl exec para se conectar ao pod que hospeda o StatefulSet.

      kubectl exec -it efs-shell-0 -- bash
    

    O comando kubectl inicia um shell no pod.

  5. Para confirmar se o recurso EFS está ativado, verifique o conteúdo do arquivo out.txt com o comando tail.

    tail /efs-data/out.txt
    

    A saída contém os horários recentes em UTC.

  6. Desconecte-se do pod com o comando exit.

      exit
    

    O shell retorna à máquina local.

Limpar

Para remover o StatefulSet, use kubectl delete.

  kubectl delete -f efs-statefulset.yaml

A seguir