Déployer le pilote FSx pour Lustre

Créez un rôle IAM et associez la politique gérée AWS à l’aide de la commande suivante. Remplacez my-cluster par le nom du cluster que vous souhaitez utiliser. La commande déploie une pile CloudFormation AWS qui crée un rôle IAM et y associe la politique 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

Vous verrez plusieurs lignes de sortie lorsque le compte de service sera créé. Les dernières lignes de sortie sont similaires à celle de l'exemple suivant.

[ℹ]  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"

Notez le nom de la pile AWS CloudFormation qui a été déployée. Dans l'exemple de sortie ci-dessus, la pile est nommée eksctl-my-cluster-addon-iamserviceaccount-kube-system-fsx-csi-controller-sa.

Notez le groupe de sécurité de votre cluster. Vous pouvez le voir dans la AWS Management Console sous la section Mise en réseau ou en utilisant la commande AWS CLI suivante. Remplacez my-cluster par le nom du cluster que vous souhaitez utiliser.

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

Créez un groupe de sécurité pour votre système de fichiers Amazon FSx en fonction des critères indiqués dans Groupes de sécurité Amazon VPC dans le Guide de l'utilisateur Amazon FSx pour Lustre. Pour le VPC, sélectionnez le VPC de votre cluster, comme indiqué dans la section Mise en réseau. Pour « les groupes de sécurité associés à vos clients Lustre », utilisez le groupe de sécurité de votre cluster. Vous pouvez juste laisser les règles sortantes pour autoriser Tout le trafic.

Téléchargez le manifeste de la classe de stockage à l'aide de la commande suivante.

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

Modifiez la section des paramètres du fichier storageclass.yaml. Remplacez chaque valeur d’exemple par vos propres valeurs.

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"

Créez le manifeste de la classe de stockage.

kubectl apply -f storageclass.yaml

L'exemple qui suit illustre un résultat.

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

Téléchargez le manifeste de revendication de volume persistant.

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

(Facultatif) Modifiez le fichier claim.yaml. Remplacez 1200Gi par l'une des valeurs d'incrément ci-dessous, en fonction de vos besoins de stockage et du deploymentType que vous avez sélectionné à l'étape précédente.

storage: 1200Gi

Créez la revendication de volume persistant.

kubectl apply -f claim.yaml

L'exemple qui suit illustre un résultat.

persistentvolumeclaim/fsx-claim created

Vérifiez que le système de fichiers est approvisionné.

kubectl describe pvc

L'exemple qui suit illustre un résultat.

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

Déployez un exemple d'application

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

Vérifiez que l'exemple d'application est en cours d'exécution.

kubectl get pods

L'exemple qui suit illustre un résultat.

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

Vérifiez que le système de fichiers est correctement monté par l'application.

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

L'exemple qui suit illustre un résultat.

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

Vérifiez que les données ont été écrites sur le système de fichiers FSx for Lustre par l'exemple d'application.

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

L'exemple qui suit illustre un résultat.

out.txt

Cet exemple de sortie signifie que l'exemple d'application a réussi à écrire le fichier out.txt dans le système de fichiers.