Implementare il driver FSx per Lustre

Crea un ruolo IAM e collega la policy gestita da AWS con il comando seguente. Sostituisci my-cluster con il nome del cluster che desideri utilizzare. Il comando implementa uno stack AWS CloudFormation che crea un ruolo IAM e vi collega la policy IAM.

eksctl create iamserviceaccount \
    --name fsx-csi-controller-sa \
    --namespace kube-system \
    --cluster my-cluster \
    --role-name AmazonEKS_FSx_CSI_DriverRole \
    --role-only \
    --attach-policy-arn arn:aws:iam::aws:policy/AmazonFSxFullAccess \
    --approve

Visualizzerai diverse righe di output quando l’account del servizio viene creato. Le ultime righe dell’output sono simili a quelle riportate di seguito.

[ℹ]  1 task: {
    2 sequential sub-tasks: {
        create IAM role for serviceaccount "kube-system/fsx-csi-controller-sa",
        create serviceaccount "kube-system/fsx-csi-controller-sa",
    } }
[ℹ]  building iamserviceaccount stack "eksctl-my-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa"
[ℹ]  deploying stack "eksctl-my-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa"
[ℹ]  waiting for CloudFormation stack "eksctl-my-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa"
[ℹ]  created serviceaccount "kube-system/fsx-csi-controller-sa"

Prendi nota del nome dello stack AWS CloudFormation che è stato distribuito. Nell’output di esempio precedente, lo stack è denominato eksctl-my-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa.

Annota il gruppo di sicurezza per il cluster. Puoi visualizzarlo nella sezione Reti della Console di gestione AWS o utilizzando il comando AWS CLI seguente. Sostituisci my-cluster con il nome del cluster che desideri utilizzare.

aws eks describe-cluster --name my-cluster --query cluster.resourcesVpcConfig.clusterSecurityGroupId

Crea un gruppo di sicurezza per il file system Amazon FSx in base ai criteri indicati nella sezione Gruppi di sicurezza Amazon VPC della Guida per l’utente di Amazon FSx per Lustre. Per il VPC, seleziona il VPC del cluster come mostrato nella sezione Reti. Per i "gruppi di sicurezza associati ai client Lustre", usa il gruppo di sicurezza del cluster. Non specificare alcun valore nelle regole in uscita per consentire Tutto il traffico.

Scarica il manifesto della classe di storage con il comando seguente.

curl -O https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/examples/kubernetes/dynamic_provisioning/specs/storageclass.yaml

Modifica la sezione dei parametri del file storageclass.yaml. Sostituisci ogni valore esemplificativo con i tuoi valori.

parameters:
  subnetId: subnet-0eabfaa81fb22bcaf
  securityGroupIds: sg-068000ccf82dfba88
  deploymentType: PERSISTENT_1
  automaticBackupRetentionDays: "1"
  dailyAutomaticBackupStartTime: "00:00"
  copyTagsToBackups: "true"
  perUnitStorageThroughput: "200"
  dataCompressionType: "NONE"
  weeklyMaintenanceStartTime: "7:09:00"
  fileSystemTypeVersion: "2.12"

Crea il manifesto della classe di storage.

kubectl apply -f storageclass.yaml

Di seguito viene riportato un output di esempio:

storageclass.storage.k8s.io/fsx-sc created

Scaricare il manifesto della dichiarazione di volume persistente.

curl -O https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/examples/kubernetes/dynamic_provisioning/specs/claim.yaml

(Facoltativo) Modificare il file claim.yaml. Cambia 1200Gi in uno dei valori di incremento riportati di seguito in base ai tuoi requisiti di archiviazione e al deploymentType selezionato in un passaggio precedente.

storage: 1200Gi

Creare la dichiarazione di volume persistente.

kubectl apply -f claim.yaml

Di seguito viene riportato un output di esempio:

persistentvolumeclaim/fsx-claim created

Verificare che il file system sia stato sottoposto a provisioning.

kubectl describe pvc

Di seguito viene riportato un output di esempio:

Name:          fsx-claim
Namespace:     default
StorageClass:  fsx-sc
Status:        Bound
[...]

Implementare un’applicazione di esempio.

kubectl apply -f https://raw.githubusercontent.com/kubernetes-sigs/aws-fsx-csi-driver/master/examples/kubernetes/dynamic_provisioning/specs/pod.yaml

Verificare che l’applicazione di esempio sia in esecuzione.

kubectl get pods

Di seguito viene riportato un output di esempio:

NAME      READY   STATUS              RESTARTS   AGE
fsx-app   1/1     Running             0          8s

Verifica che l’applicazione abbia montato correttamente il file system.

kubectl exec -ti fsx-app -- df -h

Di seguito viene riportato un output di esempio:

Filesystem                   Size  Used Avail Use% Mounted on
overlay                       80G  4.0G   77G   5% /
tmpfs                         64M     0   64M   0% /dev
tmpfs                        3.8G     0  3.8G   0% /sys/fs/cgroup
192.0.2.0@tcp:/abcdef01      1.1T  7.8M  1.1T   1% /data
/dev/nvme0n1p1                80G  4.0G   77G   5% /etc/hosts
shm                           64M     0   64M   0% /dev/shm
tmpfs                        6.9G   12K  6.9G   1% /run/secrets/kubernetes.io/serviceaccount
tmpfs                        3.8G     0  3.8G   0% /proc/acpi
tmpfs                        3.8G     0  3.8G   0% /sys/firmware

Verifica che i dati siano stati scritti nel file system FSx per Lustre dall’app di esempio.

kubectl exec -it fsx-app -- ls /data

Di seguito viene riportato un output di esempio:

out.txt

Questo output esemplificativo mostra che l’app di esempio ha eseguito correttamente la scrittura del file out.txt nel file system.