Le stockage

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:

   $ openshift_oidc_provider=`oc get authentication.config.openshift.io cluster \
     -o json | jq -r .spec.serviceAccountIssuer | sed -e "s/^https:\/\///"`; \
     echo $openshift_oidc_provider

   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.

1. Créez une revendication de volume persistante (PVC) qui utilise la classe de stockage hyperdisque spécifique à l’aide de l’exemple de fichier YAML suivant:

   Exemple de fichier PVC YAML

   apiVersion: v1
   kind: PersistentVolumeClaim
   metadata:
     name: my-pvc
   spec:
     storageClassName: hyperdisk-sc 

   1

   
     accessModes:
     - ReadWriteOnce
     resources:
       requests:
         storage: 2048Gi 

   2

   Copy to Clipboard Toggle word wrap

   1

   Le PVC fait référence à la classe de stockage spécifique à la piscine de stockage. Dans cet exemple, hyperdisk-sc.

   2

   Capacité de stockage cible du volume hyperdisque équilibré. Dans cet exemple, 2048Gi.

2. Créez un déploiement qui utilise le PVC que vous venez de créer. L’utilisation d’un déploiement permet de s’assurer que votre application a accès au stockage persistant même après le redémarrage et le rééchelonnement du pod:

   1. Assurez-vous qu’un pool de nœuds avec la série de machines spécifiée est opérationnel avant de créer le déploiement. Dans le cas contraire, la gousse ne parvient pas à planifier.

   2. À l’aide de l’exemple suivant fichier YAML pour créer le déploiement:

      Exemple de déploiement du fichier YAML

      apiVersion: apps/v1
      kind: Deployment
      metadata:
        name: postgres
      spec:
        selector:
          matchLabels:
            app: postgres
        template:
          metadata:
            labels:
              app: postgres
          spec:
            nodeSelector:
              cloud.google.com/machine-family: n4 

      1

      
            containers:
            - name: postgres
              image: postgres:14-alpine
              args: [ "sleep", "3600" ]
              volumeMounts:
              - name: sdk-volume
                mountPath: /usr/share/data/
            volumes:
            - name: sdk-volume
              persistentVolumeClaim:
                claimName: my-pvc 

      2

      Copy to Clipboard Toggle word wrap

      1

      Indique la famille de machines. Dans cet exemple, c’est n4.

      2

      Indique le nom du PVC créé à l’étape précédente. Dans cet exemple, c’est mon-pfc.

   3. Confirmez que le déploiement a été créé avec succès en exécutant la commande suivante:

      $ oc get deployment

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      NAME       READY   UP-TO-DATE   AVAILABLE   AGE
      postgres   0/1     1            0           42s

      Copy to Clipboard Toggle word wrap

      Il peut prendre quelques minutes pour que les instances d’hyperdisque complètent le provisionnement et affichent un statut READY.

   4. Confirmez que le PVC my-pvc a été lié avec succès à un volume persistant (PV) en exécutant la commande suivante:

      $ oc get pvc my-pvc

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      NAME          STATUS   VOLUME                                     CAPACITY   ACCESS MODES   STORAGECLASS       VOLUMEATTRIBUTESCLASS  AGE
      my-pvc        Bound    pvc-1ff52479-4c81-4481-aa1d-b21c8f8860c6   2Ti        RWO            hyperdisk-sc       <unset>                2m24s

      Copy to Clipboard Toggle word wrap

   5. Confirmez la configuration attendue de votre disque hyperdisque:

      $ gcloud compute disks list

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      NAME                                        LOCATION        LOCATION_SCOPE  SIZE_GB  TYPE                STATUS
      instance-20240914-173145-boot               us-central1-a   zone            150      pd-standard         READY
      instance-20240914-173145-data-workspace     us-central1-a   zone            100      pd-balanced         READY
      c4a-rhel-vm                                 us-central1-a   zone            50       hyperdisk-balanced  READY 

      1

      Copy to Clipboard Toggle word wrap

      1

      Disque hyperdisk-équilibré.

   6. En utilisant des pools de stockage, vérifiez que le volume est fourni comme spécifié dans votre classe de stockage et PVC en exécutant la commande suivante:

      $ gcloud compute storage-pools list-disks pool-us-east4-c --zone=us-east4-c

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      NAME                                      STATUS  PROVISIONED_IOPS  PROVISIONED_THROUGHPUT  SIZE_GB
      pvc-1ff52479-4c81-4481-aa1d-b21c8f8860c6  READY   3000              140                     2048

      Copy to Clipboard Toggle word wrap

1. Obtenir le numéro de projet:

   1. Demandez l’ID du projet en exécutant la commande suivante:

      $ export PROJECT_ID=$(oc get infrastructure/cluster -o jsonpath='{.status.platformStatus.gcp.projectID}')

      Copy to Clipboard Toggle word wrap

   2. Obtenir le numéro de projet, à l’aide de l’ID du projet, en exécutant la commande suivante:

      $ gcloud projects describe $PROJECT_ID --format="value(projectNumber)"

      Copy to Clipboard Toggle word wrap

2. Cherchez l’identifiant du pool d’identités et l’ID du fournisseur:

   Lors de l’installation du cluster, les noms de ces ressources sont fournis à l’utilitaire Cloud Credential Operator (ccoctl) avec le paramètre --name. Consultez « Créer des ressources GCP avec l’utilitaire Cloud Credential Operator ».

3. Créer des ressources d’identité de charge de travail pour l’opérateur GCP Filestore:

   1. Créez un fichier CredentialsRequest à l’aide de l’exemple suivant:

      Exemple d’identification Demandez le fichier YAML

      apiVersion: cloudcredential.openshift.io/v1
      kind: CredentialsRequest
      metadata:
        name: openshift-gcp-filestore-csi-driver-operator
        namespace: openshift-cloud-credential-operator
        annotations:
          include.release.openshift.io/self-managed-high-availability: "true"
          include.release.openshift.io/single-node-developer: "true"
      spec:
        serviceAccountNames:
        - gcp-filestore-csi-driver-operator
        - gcp-filestore-csi-driver-controller-sa
        secretRef:
          name: gcp-filestore-cloud-credentials
          namespace: openshift-cluster-csi-drivers
        providerSpec:
          apiVersion: cloudcredential.openshift.io/v1
      	kind: GCPProviderSpec
          predefinedRoles:
          - roles/file.editor
          - roles/resourcemanager.tagUser
          skipServiceCheck: true

      Copy to Clipboard Toggle word wrap

   2. Le fichier CredentialsRequest permet de créer un compte de service GCP en exécutant la commande suivante:

      $ ./ccoctl gcp create-service-accounts --name=<filestore-service-account> \

      1

      
        --workload-identity-pool=<workload-identity-pool> \

      2

      
        --workload-identity-provider=<workload-identity-provider> \

      3

      
        --project=<project-id> \

      4

      
        --credentials-requests-dir=/tmp/credreq 

      5

      Copy to Clipboard Toggle word wrap

      1

      <Filestore-service-account> est un nom choisi par l’utilisateur.

      2

      <workload-identity-pool> vient de l’étape 2 ci-dessus.

      3

      <workload-identity-provider> vient de l’étape 2 ci-dessus.

      4

      <project-id> vient de l’étape 1.a ci-dessus.

      5

      Le nom du répertoire où réside le fichier CredentialsRequest.

      Exemple de sortie

      2025/02/10 17:47:39 Credentials loaded from gcloud CLI defaults
      2025/02/10 17:47:42 IAM service account filestore-service-account-openshift-gcp-filestore-csi-driver-operator created
      2025/02/10 17:47:44 Unable to add predefined roles to IAM service account, retrying...
      2025/02/10 17:47:59 Updated policy bindings for IAM service account filestore-service-account-openshift-gcp-filestore-csi-driver-operator
      2025/02/10 17:47:59 Saved credentials configuration to: /tmp/install-dir/ 

      1

      
      openshift-cluster-csi-drivers-gcp-filestore-cloud-credentials-credentials.yaml

      Copy to Clipboard Toggle word wrap

      1

      Le répertoire actuel.

   3. Cherchez l’e-mail du compte de service nouvellement créé en exécutant la commande suivante:

      $ cat /tmp/install-dir/manifests/openshift-cluster-csi-drivers-gcp-filestore-cloud-credentials-credentials.yaml | yq '.data["service_account.json"]' | base64 -d | jq '.service_account_impersonation_url'

      Copy to Clipboard Toggle word wrap

      Exemple de sortie

      https://iamcredentials.googleapis.com/v1/projects/-/serviceAccounts/filestore-se-openshift-g-ch8cm@openshift-gce-devel.iam.gserviceaccount.com:generateAccessToken

      Copy to Clipboard Toggle word wrap

      Dans cet exemple de sortie, l’e-mail du compte de service est filestore-se-openshift-g-ch8cm@openshift-gce-devel.iam.gserviceaccount.com.

1. Connectez-vous à OpenShift Cluster Manager.
2. Choisissez votre cluster.
3. Cliquez sur Ouvrir la console et connectez-vous avec vos informations d’identification.

4. Activer l’API Filestore dans le projet GCE en exécutant la commande suivante:

   $ gcloud services enable file.googleapis.com  --project <my_gce_project> 

   1

   Copy to Clipboard Toggle word wrap

   1

   <my_gce_project> par votre projet Google Cloud.

   Il est également possible de le faire à l’aide de la console Web Google Cloud.

5. Installez l’opérateur GCP Filestore CSI:

   1. Cliquez sur Opérateurs → OperatorHub.
   2. Localisez l’opérateur GCP Filestore CSI en tapant GCP Filestore dans la zone de filtre.
   3. Cliquez sur le bouton GCP Filestore CSI Driver Operator.
   4. Dans la page GCP Filestore CSI Driver Operator, cliquez sur Installer.

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

      • L’ensemble des espaces de noms du cluster (par défaut) est sélectionné.

      • Installé Namespace est réglé sur openshift-cluster-csi-drivers.

        Lorsque vous utilisez GCP Workload Identity, entrez les valeurs pour les champs suivants obtenus à partir de la procédure dans la section Préparation à l’installation de l’opérateur de pilotes CSI Filestore GCP avec l’identité de charge de travail:

      • GCP Numéro de projet
      • GCP Pool ID
      • Carte d’identité du fournisseur GCP
      • GCP Service Compte Email

   6. Cliquez sur Install.

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

6. Installez le pilote GCP Filestore CSI:

   1. Cliquez sur administration → CustomResourceDefinitions → ClusterCSIDriver.

   2. Dans l’onglet Instances, cliquez sur Créer un clusterCSIDriver.

      Consultez le fichier YAML suivant:

      apiVersion: operator.openshift.io/v1
      kind: ClusterCSIDriver
      metadata:
          name: filestore.csi.storage.gke.io
      spec:
        managementState: Managed

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

   4. Attendez que les Conditions suivantes changent à un statut « vrai »:

      • GCPFilestoreDriverCredentialsRequestControllerDisponible
      • GCPFilestoreDriverNodeServiceControllerAvailable
      • GCPFilestoreDriverControllerServiceControllerDisponible