Utilizzo dei file system EFS

I cluster Anthos su AWS 1.6 e versioni successive supportano il sistema Elastic File System (EFS) di AWS tramite il driver CSI EFS. Questo argomento spiega come montare un file system EFS esistente come PersistentVolume sui tuoi cluster utente.

Prima di iniziare

Per eseguire la procedura descritta in questo argomento, devi avere:

  • Un file system EFS esistente nello stesso VPC AWS dei cluster Anthos su AWS.
  • Almeno una destinazione di montaggio EFS nello stesso VPC AWS dei tuoi cluster Anthos su AWS.
  • Tutti i target di montaggio EFS devono appartenere a quanto segue:
    • Le subnet private per i cluster Anthos sull'installazione di AWS. Per impostazione predefinita, i cluster Anthos su AWS creano subnet denominate gke-CLUSTER_ID-private-AWS_ZONE, dove CLUSTER_ID è il tuo ID cluster utente e AWS_ZONE è la zona di disponibilità AWS.
    • Il gruppo di sicurezza del pool di nodi. Per impostazione predefinita, i cluster Anthos su AWS creano pool di nodi denominati gke-CLUSTER_ID-nodepool, dove CLUSTER_ID è l'ID cluster utente.
  • Dalla directory anthos-aws, utilizza anthos-gke per cambiare il contesto del cluster utente. 
    cd anthos-aws
env HTTPS_PROXY=http://localhost:8118 \
  anthos-gke aws clusters get-credentials CLUSTER_NAME
    Sostituisci CLUSTER_NAME con il tuo nome cluster utente.

Utilizzo di un volume permanente EFS

Per utilizzare un file system EFS come PersistentVolume con i tuoi cluster utente, devi prima creare un PersistentVolume e poi creare un PersistentVolumeClaim a cui fai riferimento nel carico di lavoro.

Creazione di un PersistentVolume

Per creare un PersistentVolume con il driver CSI EFS, segui questi passaggi.

  1. Dalla directory anthos-aws, utilizza anthos-gke per cambiare il contesto del cluster utente. 

    cd anthos-aws
env HTTPS_PROXY=http://localhost:8118 \
  anthos-gke aws clusters get-credentials CLUSTER_NAME
    Sostituisci CLUSTER_NAME con il tuo nome cluster utente.

  2. La configurazione di PersistentVolume da dipende da se ti connetti direttamente al file system Elastic o tramite un punto di accesso. Seleziona se ti connetti direttamente al file system elastico o tramite un punto di accesso.

    Collegati direttamente

    Copia il seguente file YAML in un file denominato efs-volume.yaml. Il file manifest fa riferimento alla classe di archiviazione EFS creata in precedenza.

    apiVersion: v1
kind: PersistentVolume
metadata:
  name: VOLUME_NAME
spec:
  capacity:
    # Note: storage capacity is not used by the EFS CSI driver.
    # It is required by the PersistentVolume spec.
    storage: 5Gi
  volumeMode: Filesystem
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  storageClassName: "" # storageClassName is not required, see note in the following section.
  claimRef:
    name: CLAIM_NAME
    namespace: default
  csi:
    driver: efs.csi.aws.com
    volumeHandle: EFS_FILE_SYSTEM_ID

    Sostituisci quanto segue:

    • VOLUME_NAME con un nome per il volume permanente.
    • CLAIM_NAME con il nome che vuoi utilizzare per PersistentPersistentClaim.
    • EFS_FILE_SYSTEM_ID con il tuo ID file system EFS. Ad esempio, fs-12345678a.

    Punto di accesso

    Copia il seguente file YAML in un file denominato efs-volume.yaml. Il file manifest fa riferimento alla classe di archiviazione EFS creata in precedenza.

    apiVersion: v1
kind: PersistentVolume
metadata:
  name: VOLUME_NAME
spec:
  capacity:
    # Note: storage capacity is not used by the EFS CSI driver.
    # It is required by the PersistentVolume spec.
    storage: 5Gi
  volumeMode: Filesystem
  accessModes:
    - ReadWriteMany
  persistentVolumeReclaimPolicy: Retain
  storageClassName: "" # storageClassName is not required, see note in the following section.
  claimRef:
    name: CLAIM_NAME
    namespace: default
  csi:
    driver: efs.csi.aws.com
    volumeHandle: EFS_FILE_SYSTEM_ID::ACCESS_POINT_ID

    Sostituisci quanto segue:

    • VOLUME_NAME con un nome per il volume permanente.
    • CLAIM_NAME con il nome che vuoi utilizzare per PersistentPersistentClaim.
    • EFS_FILE_SYSTEM_ID con il tuo ID file system EFS. Ad esempio, fs-12345678a.
    • ACCESS_POINT_ID con l'ID del tuo punto di accesso. Ad esempio, fsap-1234567890abcde.

  3. YAML applica il cluster utente.

    env HTTPS_PROXY=http://localhost:8118 \
  kubectl apply -f efs-volume.yaml

    L'output conferma la creazione del PersistentVolume.

    persistentvolume/VOLUME_NAME created

Creazione di una PersistentVolumeClaim

Per utilizzare il file system EFS con i tuoi carichi di lavoro, devi creare un PersistentVolumeClaim.

  1. Per creare la proprietà PersistentVolumeClaim, copia il seguente file YAML manifest in un file denominato efs-claim.yaml.

    apiVersion: v1
kind: PersistentVolumeClaim
metadata:
  name: CLAIM_NAME
spec:
  accessModes:
    - ReadWriteMany
  storageClassName: ""
  resources:
    requests:
      storage: 5Gi

    Sostituisci CLAIM_NAME con un nome per PersistentVolumeClaim. Ad esempio, efs-claim1.

  2. YAML applica il cluster utente.

    env HTTPS_PROXY=http://localhost:8118 \
  kubectl apply -f efs-claim.yaml

    L'output conferma la creazione di PersistentVolumeClaim.

    persistentvolumeclaim/CLAIM_NAME created

Crea un oggetto StatefulSet

Dopo aver creato PersistentVolumeClaim, puoi utilizzarlo in un carico di lavoro. I passaggi di questa sezione creano un esempio statefulSet con il file system EFS montato. Puoi anche utilizzare una PersistentVolumeClaim con altri tipi di carico di lavoro, come pod e deployment, facendo riferimento alla richiesta in spec.volumes.

Per creare uno StatefulSet che monta il file system EFS a cui si fa riferimento in PersistentVolumeClaim, esegui i seguenti passaggi.

  1. Copia il seguente file YAML in un file denominato efs-statefulset.yaml. Questo file manifest di esempio avvia un container Ubuntu Linux che monta il file system EFS su /efs-data. Il container scrive ogni cinque secondi in un file sul file system EFS denominato 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

    Sostituisci quanto segue:

    • CLAIM_NAME con il nome del PersistentVolumeClaim che hai specificato in precedenza. Ad esempio, efs-claim1.

  2. YAML applica il cluster utente.

    env HTTPS_PROXY=http://localhost:8118 \
 kubectl apply -f efs-statefulset.yaml

    L'output conferma la creazione di StatefulSet's.

    statefulset.apps/efs-shell created

    Potrebbero essere necessari diversi minuti per scaricare l'immagine del container e avviarla.

  3. Il pod di StatefulSet's è in stato Running con kubectl get pods.

    env HTTPS_PROXY=http://localhost:8118 \
  kubectl get pods -l app=test-efs

    L'output include il nome del pod e il relativo stato. Nella seguente risposta, il nome del pod è efs-shell-0.

    NAME          READY   STATUS    RESTARTS   AGE
efs-shell-0   1/1     Running   0          1m

  4. Quando il pod è in stato di esecuzione, utilizza kubectl exec per connetterti al pod che ospita lo statefulSet.

    env HTTPS_PROXY=http://localhost:8118 \
  kubectl exec -it efs-shell-0 -- bash

    Il comando kubectl avvia una shell sul pod.

  5. Per verificare che il file system EFS sia montato, controlla i contenuti del file out.txt con il comando tail.

    tail /efs-data/out.txt

    L'output contiene gli orari recenti in UTC.

  6. Disconnettiti dal pod con il comando exit.

    exit

    La shell torna alla macchina locale.

  7. Per rimuovere il set statefulSet, utilizza kubectl delete.

    env HTTPS_PROXY=http://localhost:8118 \
  kubectl delete -f efs-statefulset.yaml

Pulizia

Per rimuovere le risorse create nelle sezioni precedenti, esegui i comandi seguenti:

env HTTPS_PROXY=http://localhost:8118 \
  kubectl delete -f efs-statefulset.yaml
env HTTPS_PROXY=http://localhost:8118 \
  kubectl delete -f efs-claim.yaml
env HTTPS_PROXY=http://localhost:8118 \
  kubectl delete -f efs-volume.yaml

Passaggi successivi