5.4. AWS Elastic File Service CSI Driver Operator

Procédure

1. Créez un fichier JSON de stratégie IAM avec le contenu suivant:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Action": [
           "elasticfilesystem:DescribeAccessPoints",
           "elasticfilesystem:DescribeFileSystems",
           "elasticfilesystem:DescribeMountTargets",
           "ec2:DescribeAvailabilityZones",
           "elasticfilesystem:TagResource"
         ],
         "Resource": "*"
       },
       {
         "Effect": "Allow",
         "Action": [
           "elasticfilesystem:CreateAccessPoint"
         ],
         "Resource": "*",
         "Condition": {
           "StringLike": {
             "aws:RequestTag/efs.csi.aws.com/cluster": "true"
           }
         }
       },
       {
         "Effect": "Allow",
         "Action": "elasticfilesystem:DeleteAccessPoint",
         "Resource": "*",
         "Condition": {
           "StringEquals": {
             "aws:ResourceTag/efs.csi.aws.com/cluster": "true"
           }
         }
       }
     ]
   }

   Copy to Clipboard Toggle word wrap

2. Créez un fichier JSON de confiance IAM avec le contenu suivant:

   {
     "Version": "2012-10-17",
     "Statement": [
       {
         "Effect": "Allow",
         "Principal": {
           "Federated": "arn:aws:iam::<your_aws_account_ID>:oidc-provider/<openshift_oidc_provider>"  

   1

   
         },
         "Action": "sts:AssumeRoleWithWebIdentity",
         "Condition": {
           "StringEquals": {
             "<openshift_oidc_provider>:sub": [  

   2

   
               "system:serviceaccount:openshift-cluster-csi-drivers:aws-efs-csi-driver-operator",
               "system:serviceaccount:openshift-cluster-csi-drivers:aws-efs-csi-driver-controller-sa"
             ]
           }
         }
       }
     ]
   }

   Copy to Clipboard Toggle word wrap

   1

   Indiquez votre identifiant de compte AWS et le point de terminaison du fournisseur OpenShift OIDC.

   Achetez votre identifiant de compte AWS en exécutant la commande suivante:

   $ aws sts get-caller-identity --query Account --output text

   Copy to Clipboard Toggle word wrap

   Obtenez le point de terminaison OpenShift OIDC en exécutant la commande suivante:

   $ rosa describe cluster \
     -c $(oc get clusterversion -o jsonpath='{.items[].spec.clusterID}{"\n"}') \
     -o yaml | awk '/oidc_endpoint_url/ {print $2}' | cut -d '/' -f 3,4

   Copy to Clipboard Toggle word wrap

   2

   Indiquez à nouveau le point de terminaison OpenShift OIDC.

3. Créer le rôle de l’IAM:

   ROLE_ARN=$(aws iam create-role \
     --role-name "<your_cluster_name>-aws-efs-csi-operator" \
     --assume-role-policy-document file://<your_trust_file_name>.json \
     --query "Role.Arn" --output text); echo $ROLE_ARN

   Copy to Clipboard Toggle word wrap

   Copiez le rôle ARN. Lors de l’installation de l’opérateur de pilotes AWS EFS CSI, vous en aurez besoin.

4. Créer la politique IAM:

   POLICY_ARN=$(aws iam create-policy \
     --policy-name "<your_cluster_name>-aws-efs-csi" \
     --policy-document file://<your_policy_file_name>.json \
     --query 'Policy.Arn' --output text); echo $POLICY_ARN

   Copy to Clipboard Toggle word wrap

5. Attacher la politique de l’IAM au rôle de l’IAM:

   $ aws iam attach-role-policy \
     --role-name "<your_cluster_name>-aws-efs-csi-operator" \
     --policy-arn $POLICY_ARN

   Copy to Clipboard Toggle word wrap

1. Connectez-vous à la console web.

2. Installez l’opérateur AWS EFS CSI:

   1. Cliquez sur Opérateurs OperatorHub.
   2. Localisez l’opérateur AWS EFS CSI en tapant AWS EFS CSI dans la zone de filtre.
   3. Cliquez sur le bouton AWS EFS CSI Driver Operator.
   Important

   Assurez-vous de sélectionner l’opérateur de conducteur AWS EFS CSI et non l’opérateur EFS AWS. L’opérateur AWS EFS est un opérateur communautaire et n’est pas pris en charge par Red Hat.

   1. Dans la page AWS EFS CSI Driver Operator, cliquez sur Installer.

   2. Dans la page Installer l’opérateur, assurez-vous que:

      • Lorsque vous utilisez AWS EFS avec AWS Secure Token Service (STS), dans le champ ARN du rôle, entrez le rôle ARN copié à partir de la dernière étape de la procédure d’obtention d’un rôle Amazon Resource Name for Security Token Service.
      • L’ensemble des espaces de noms du cluster (par défaut) est sélectionné.
      • Installé Namespace est réglé sur openshift-cluster-csi-drivers.

   3. Cliquez sur Install.

      Après la fin de l’installation, l’opérateur AWS EFS CSI est listé dans la section Opérateurs installés de la console Web.

Procédure

1. Cliquez sur Administration CustomResourceDefinitions ClusterCSIDriver.
2. Dans l’onglet Instances, cliquez sur Créer un clusterCSIDriver.

3. Consultez le fichier YAML suivant:

   apiVersion: operator.openshift.io/v1
   kind: ClusterCSIDriver
   metadata:
       name: efs.csi.aws.com
   spec:
     managementState: Managed

   Copy to Clipboard Toggle word wrap
4. Cliquez sur Create.

5. Attendez que les Conditions suivantes changent pour un statut « Vrai »:

   • AWSEFSDriverNodeServiceControllerAvailable
   • AWSEFSDriverControllerServiceControllerDisponible

1. Cliquez sur Administration > CustomResourceDefinitions.
2. Dans la page CustomResourceDefinitions à côté de la zone déroulante Nom, tapez clustercsidriver.
3. Cliquez sur CRD ClusterCSIDriver.
4. Cliquez sur l’onglet YAML.

5. Dans spec.aws.efsVolumeMetrics.state, définissez la valeur à RecursiveWalk.

   La RecursiveWalk indique que la collecte de mesures de volume dans le pilote AWS EFS CSI est effectuée en parcourant de manière récursive les fichiers dans le volume.

   Exemple ClusterCSIDriver efs.csi.aws.com fichier YAML

   spec:
       driverConfig:
           driverType: AWS
           aws:
               efsVolumeMetrics:
                 state: RecursiveWalk
                 recursiveWalk:
                   refreshPeriodMinutes: 100
                   fsRateLimit: 10

   Copy to Clipboard Toggle word wrap

6. Facultatif: Pour définir comment fonctionne la marche récursive, vous pouvez également définir les champs suivants:

   • rafraîchissementPeriodMinutes: Spécifie la fréquence de rafraîchissement des métriques de volume en quelques minutes. Lorsque ce champ est laissé vide, un défaut raisonnable est choisi, qui est susceptible de changer au fil du temps. La valeur par défaut actuelle est 240 minutes. La plage valide est de 1 à 43 200 minutes.
   • fsRateLimit: Définit la limite de taux pour le traitement des métriques de volume dans les goroutines par système de fichiers. Lorsque ce champ est laissé vide, un défaut raisonnable est choisi, qui est susceptible de changer au fil du temps. La valeur par défaut actuelle est 5 goroutines. La gamme valide est de 1 à 100 goroutines.
7. Cliquez sur Save.

1. Editez ClusterCSIDriver en exécutant la commande suivante:

   $ oc edit clustercsidriver efs.csi.aws.com

   Copy to Clipboard Toggle word wrap

2. Dans spec.aws.efsVolumeMetrics.state, définissez la valeur à RecursiveWalk.

   La RecursiveWalk indique que la collecte de mesures de volume dans le pilote AWS EFS CSI est effectuée en parcourant de manière récursive les fichiers dans le volume.

   Exemple ClusterCSIDriver efs.csi.aws.com fichier YAML

   spec:
       driverConfig:
           driverType: AWS
           aws:
               efsVolumeMetrics:
                 state: RecursiveWalk
                 recursiveWalk:
                   refreshPeriodMinutes: 100
                   fsRateLimit: 10

   Copy to Clipboard Toggle word wrap

3. Facultatif: Pour définir comment fonctionne la marche récursive, vous pouvez également définir les champs suivants:

   • rafraîchissementPeriodMinutes: Spécifie la fréquence de rafraîchissement des métriques de volume en quelques minutes. Lorsque ce champ est laissé vide, un défaut raisonnable est choisi, qui est susceptible de changer au fil du temps. La valeur par défaut actuelle est 240 minutes. La plage valide est de 1 à 43 200 minutes.
   • fsRateLimit: Définit la limite de taux pour le traitement des métriques de volume dans les goroutines par système de fichiers. Lorsque ce champ est laissé vide, un défaut raisonnable est choisi, qui est susceptible de changer au fil du temps. La valeur par défaut actuelle est 5 goroutines. La gamme valide est de 1 à 100 goroutines.
4. Enregistrez les modifications de l’objet efs.csi.aws.com.