Esta documentação é referente à versão atual do GKE na AWS, lançada em novembro de 2021. Consulte as Notas de lançamento para mais informações.

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

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.

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.

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.

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.

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.
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
```
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.
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.
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

Saiba como configurar um recurso EFS
Saiba como usar o StorageClasses com suas cargas de trabalho.