IBM Cloud Docs
AWS EBS

AWS EBS

Configurez Amazon Elastic Block Storage(EBS ) pour les clusters IBM Cloud Satellite® en créant une configuration de stockage sur votre site. Lorsque vous affectez une configuration de stockage à vos clusters, les pilotes de stockage du fournisseur de stockage sélectionné sont installés dans votre cluster.

Lorsque vous créez votre configuration de stockage AWS EBS, vous fournissez vos données d'identification AWS qui sont stockées sous forme de secret Kubernetes dans les clusters auxquels vous affectez votre configuration. Le secret est monté dans le pod du contrôleur CSI de sorte que lorsque vous créez une réservation de volume persistant à l'aide de l'une des classes de stockage fournies par IBM, vos données d'identification AWS sont utilisées pour mettre à disposition une instance EBS de manière dynamique.

Pour utiliser le stockage AWS EBS pour vos applications, les hôtes Satellite que vous utilisez pour les noeuds worker de votre cluster doivent résider dans AWS.

Avant de déployer des modèles de stockage sur des clusters dans votre emplacement, veillez à configurer Satellite en sélectionnant l'option Activer l'accès administrateur de cluster pour Satellite Config dans la console ou en incluant l'option --enable-config-admin lorsque vous créez votre cluster.

Vous ne pouvez pas personnaliser vos classes de stockage car la configuration Satellite écrase vos modifications.

Vous ne pouvez pas étendre le service de stockage Satellite à des groupes de ressources. Toutefois, si vous sectorise d'autres ressources telles que l'emplacement et le cluster à des groupes de ressources, vous devez ajouter le rôle de lecteur Satellite et d'administrateur de lien pour toutes les ressources du compte.

Prérequis pour l'utilisation d' AWS EBS

Pour utiliser le modèle de stockage AWS EBS, procédez comme suit :

  1. Créez un emplacement Satellite.

  2. Créez un Satellite cluster exécuté sur des hôtes de traitement dans AWS (Amazon Web Services). Veillez à sélectionner l'option Activer l'accès administrateur de cluster pour Satellite Config lorsque vous créez le cluster. Si vous n'activez pas l'accès administrateur (admin) pour la configuration Satellite lors de la création de votre cluster, vous devez recréer votre cluster et activer l'accès administrateur pour pouvoir déployer le stockage. Pour plus d'informations sur l'ajout d'hôtes AWS dans votre emplacement Satellite pour que vous puissiez les affecter à un cluster, voir Ajout d'hôtes AWS à Satellite.

  3. Créez une clé d'accès à AWS et une clé d'accès secrète pour vos identifiants de connexion à AWS. Ces données d'identification sont nécessaires pour mettre à disposition le stockage AWS EBS dans votre compte. Lorsque vous affectez la configuration de stockage à votre cluster, vos ID de clé d'accès AWS et clé d'accès secrète sont stockés dans un secret Kubernetes dans votre cluster.

  4. Examinez les paramètres de configuration du stockage AWS EBS.

  5. Passez en revue les classes de stockageAWS EBS. Le modèle de stockage AWS EBS ne prend pas en charge les classes de stockage personnalisées.

Création et affectation d'une configuration dans la console

  1. Reportez-vous aux informations de référence des paramètres.

  2. Dans la console Emplacements, sélectionnez l'emplacement où vous souhaitez créer une configuration de stockage.

  3. Sélectionnez Stockage > Créer une configuration de stockage

  4. Entrez un nom pour votre configuration.

  5. Sélectionnez le type de stockage.

  6. Sélectionnez la version et cliquez sur Suivant

  7. Si le Type de stockage que vous avez sélectionné accepte des paramètres personnalisés, entrez-les dans l'onglet Paramètres.

  8. Si le Type de stockage que vous avez sélectionné requiert des secrets, entrez-les dans l'onglet Secrets.

  9. Dans l'onglet Classes de stockage, consultez les classes de stockage déployées par la configuration ou créez une classe de stockage personnalisée.

  10. Dans l'onglet Affecter au service, sélectionnez le service auquel vous souhaitez affecter votre configuration.

  11. Cliquez sur Terminé pour affecter votre configuration de stockage.

Création d'une configuration dans l'interface de ligne de commande

  1. Passez en revue la référence de paramètre pour la version de modèle que vous souhaitez utiliser.

  2. Connectez-vous à l'interface de ligne de commande IBM Cloud.

    ibmcloud login
    
  3. Répertoriez vos emplacements Satellite et notez la colonne Managed from.

    ibmcloud sat location ls
    
  4. Ciblez la région Managed from de votre emplacement Satellite. Par exemple, pour wdc, ciblez us-east. Pour plus d'informations, voir Régions Satellite.

    ibmcloud target -r us-east
    
  5. Si vous utilisez un groupe de ressources autre que default, ciblez-le.

    ibmcloud target -g <resource-group>
    
  6. Copiez l'un des exemples de commande suivants pour la version de modèle que vous souhaitez utiliser. Pour plus d'informations sur la commande, voir ibmcloud sat storage config create dans la référence de commande.

    Exemple de commande permettant de créer une configuration de version 1.1.0.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name aws-ebs-csi-driver --template-version 1.1.0 --param "aws-access-key=AWS-ACCESS-KEY"  --param "aws-secret-access-key=AWS-SECRET-ACCESS-KEY"
    

    Exemple de commande permettant de créer une configuration de version 1.5.1.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name aws-ebs-csi-driver --template-version 1.5.1 --param "aws-access-key=AWS-ACCESS-KEY"  --param "aws-secret-access-key=AWS-SECRET-ACCESS-KEY"
    

    Exemple de commande permettant de créer une configuration de version 1.12.0.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name aws-ebs-csi-driver --template-version 1.12.0 --param "aws-access-key=AWS-ACCESS-KEY"  --param "aws-secret-access-key=AWS-SECRET-ACCESS-KEY"
    

    Exemple de commande permettant de créer une configuration de version 1.31.0.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name aws-ebs-csi-driver --template-version 1.31.0 --param "aws-access-key=AWS-ACCESS-KEY"  --param "aws-secret-access-key=AWS-SECRET-ACCESS-KEY"
    
  7. Personnalisez la commande en fonction des paramètres que vous souhaitez utiliser.

  8. Exécutez la commande pour créer une configuration.

  9. Vérifiez que votre configuration a été créée.

    ibmcloud sat storage config get --config CONFIG
    

Création d'une configuration dans l'API

  1. Générez une clé d'API, puis demandez un jeton d'actualisation. Pour plus d'informations, voir Génération d'un jeton IAM IBM Cloud à l'aide d'une clé d'API.

  2. Passez en revue la référence de paramètre pour la version de modèle que vous souhaitez utiliser.

  3. Copiez l'un des exemples de demande suivants et remplacez les variables que vous souhaitez utiliser.

    Exemple de demande de création d'une configuration de version 1.1.0.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"aws-ebs-csi-driver\", \"storage-template-version\": \"1.1.0\", \"update-assignments\": true, \"user-config-parameters\":\"user-secret-parameters\": { \"entry.name\": \"AWS-ACCESS-KEY\",{ \"entry.name\": \"AWS-SECRET-ACCESS-KEY\",}
    

    Exemple de demande de création d'une configuration de version 1.5.1.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"aws-ebs-csi-driver\", \"storage-template-version\": \"1.5.1\", \"update-assignments\": true, \"user-config-parameters\":\"user-secret-parameters\": { \"entry.name\": \"AWS-ACCESS-KEY\",{ \"entry.name\": \"AWS-SECRET-ACCESS-KEY\",}
    

    Exemple de demande de création d'une configuration de version 1.12.0.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"aws-ebs-csi-driver\", \"storage-template-version\": \"1.12.0\", \"update-assignments\": true, \"user-config-parameters\":\"user-secret-parameters\": { \"entry.name\": \"AWS-ACCESS-KEY\",{ \"entry.name\": \"AWS-SECRET-ACCESS-KEY\",}
    

    Exemple de demande de création d'une configuration de version 1.31.0.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createStorageConfigurationByController" -H "accept: application/json" -H "Authorization: TOKEN" -H "Content-Type: application/json" -d "{ \"config-name\": \"string\", \"controller\": \"string\", \"storage-class-parameters\": [ { \"additionalProp1\": \"string\", \"additionalProp2\": \"string\", \"additionalProp3\": \"string\" } ], \"storage-template-name\": \"aws-ebs-csi-driver\", \"storage-template-version\": \"1.31.0\", \"update-assignments\": true, \"user-config-parameters\":\"user-secret-parameters\": { \"entry.name\": \"AWS-ACCESS-KEY\",{ \"entry.name\": \"AWS-SECRET-ACCESS-KEY\",}
    

Création d'une affectation dans l'interface de programmation

  1. Dressez la liste de vos configurations de stockage et notez la configuration de stockage que vous souhaitez attribuer à vos clusters.

    ibmcloud sat storage config ls
    
  2. Obtenez l'ID du cluster, du groupe de clusters ou du service auquel vous souhaitez affecter le stockage.

    Pour vous assurer que votre cluster est enregistré dans Satellite Config ou pour créer des groupes, reportez-vous à la rubrique Configuration des clusters à utiliser avec Satellite Config.

    Exemple de commande permettant de répertorier les groupes de clusters.

    ibmcloud sat group ls
    

    Exemple de commande permettant de répertorier les clusters.

    ibmcloud oc cluster ls --provider satellite
    

    Exemple de commande permettant de répertorier les services Satellite.

    ibmcloud sat service ls --location <location>
    
  3. Affectez votre configuration de stockage au cluster, au groupe ou au service que vous avez extrait précédemment. Pour plus d'informations, voir la commande'ibmcloud sat storage assignment create

    Exemple de commande permettant d'affecter une configuration à un groupe de clusters.

    ibmcloud sat storage assignment create --group GROUP --config CONFIG --name NAME
    

    Exemple de commande permettant d'affecter une configuration à un cluster.

    ibmcloud sat storage assignment create --cluster CLUSTER --config CONFIG --name NAME
    

    Exemple de commande permettant d'affecter une configuration à un cluster de services.

    ibmcloud sat storage assignment create --service-cluster-id CLUSTER --config CONFIG --name NAME
    
  4. Vérifiez que votre affectation a été créée.

    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)
    

Création d'une affectation de stockage dans l'API

  1. Copiez l'un des exemples de demande suivants.

    Exemple de demande d'affectation d'une configuration à un cluster.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignmentByCluster" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"CLUSTER-ID\", \"controller\": \"LOCATION-ID\", \"name\": \"ASSIGNMENT-NAME\"}"
    

    Exemple de demande d' affectation de la configuration à un groupe de clusters.

    curl -X POST "https://containers.cloud.ibm.com/global/v2/storage/satellite/createAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"channelName\": \"CONFIGURATION-NAME\", \"cluster\": \"string\", \"groups\": [ \"CLUSTER-GROUP\" ], \"name\": \"ASSIGNMENT-NAME\"}"
    
  2. Remplacez les variables par vos détails et exécutez la demande.

  3. Vérifiez que l'affectation a été créée en répertoriant vos affectations.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignments" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

Mise à jour des affectations de stockage dans la console

Vous pouvez utiliser la consoleSatellite pour appliquer les dernières mises à jour de correctif à vos affectations.

  1. Dans la page Emplacements de la console Satellite, sélectionnez votre emplacement.

  2. Cliquez sur l'onglet Stockage pour afficher vos configurations.

  3. Cliquez sur la configuration que vous souhaitez mettre à jour.

  4. Cliquez sur l'icône Informations (i) pour appliquer la dernière révision ou le dernier correctif.

  5. Facultatif: activez les mises à jour de correctif automatiques pour votre affectation de stockage. L'activation des mises à jour de correctifs automatiques garantit que votre affectation dispose toujours des derniers correctifs de sécurité.

Si vous activez les mises à jour de correctifs automatiques, vous devez toujours appliquer les mises à jour majeures manuellement.

Mise à niveau manuelle des affectations dans l'interface de ligne de commande

Mettez à niveau une affectation pour utiliser la dernière révision de modèle de stockage.

  1. Répertoriez vos affectations de stockage Satellite, notez l'affectation Satellite que vous souhaitez mettre à niveau.

    ibmcloud sat storage assignment ls
    
  2. Répertoriez les modèles de stockage Satellite pour afficher les dernières versions disponibles.

    ibmcloud sat storage template ls
    
  3. Mettez à niveau l'affectation Satellite.

    Exemple de commande permettant de mettre à niveau une affectation.

    ibmcloud sat storage assignment upgrade --assignment ASSIGNMENT
    

Activation des mises à jour de correctifs automatiques pour les configurations et les affectations dans l'interface de ligne de commande

Vous pouvez utiliser l'interface de ligne de commande sat storage assignment autopatch enable pour activer les mises à jour de correctif automatiques pour vos affectations. L'activation des mises à jour de correctif automatiques applique automatiquement les dernières révisions de modèle de stockage (correctifs). Vous devez toujours appliquer les mises à jour majeures manuellement.

  1. Permet d'afficher la liste des configurations de stockage Satellite. Notez l'ID de configuration.

    ibmcloud sat storage assignment ls
    
  2. Exécutez l'un des exemples de commande suivants pour activer les mises à jour de correctifs automatiques pour votre configuration et les affectations qui lui sont associées. Saisissez l'ID de configuration que vous avez récupéré à l'étape précédente.

    Exemple de commande permettant d'activer les mises à jour de correctif automatiques pour une affectation.

    ibmcloud sat storage assignment autopatch enable --config CONFIG  (--all | --assignment ASSIGNMENT-ID [--assignment ASSIGNMENT-ID])
    

    Exemple de commande permettant d'activer les mises à jour de correctifs automatiques pour toutes les affectations de stockage dans une configuration donnée.

    ibmcloud sat storage assignment autopatch enable --config CONFIG --all
    

    Exemple de commande permettant de désactiver les mises à jour de correctifs automatiques pour toutes les affectations sous une configuration spécifique.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --all
    

    Exemple de commande permettant de désactiver les mises à jour de correctifs automatiques pour une affectation unique et une configuration spécifique.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID
    

    Exemple de commande permettant de désactiver les mises à jour de correctifs automatiques pour une affectation multiple et une configuration spécifique.

    ibmcloud sat storage assignment autopatch disable --config CONFIG --assignment ASSIGNMENT-ID --assignment ASSIGNMENT-ID
    

Mise à niveau manuelle des configurations dans l'interface de ligne de commande

Vous pouvez mettre à jour vos configurations de stockage Satellite pour obtenir la dernière révision du modèle de stockage dans la même version majeure.

  1. Répertoriez vos configurations de stockage Satellite, notez la configuration Satellite à mettre à niveau.

    ibmcloud sat storage config ls
    
  2. Mettez à niveau la configuration Satellite. Notez que seule la configuration est mise à jour. Si vous souhaitez mettre à niveau les affectations qui utilisent cette configuration, vous pouvez spécifier l'option --include-assignments ou mettre à jour manuellement chaque affectation à l'aide de la commande assignment update.

    Exemple de commande permettant de mettre à niveau une configuration vers la dernière révision.

    ibmcloud sat storage config upgrade --config CONFIG [--include-assignments]
    

    Exemple de commande permettant de mettre à niveau une configuration et les affectations associées à la dernière révision.

    ibmcloud sat storage config upgrade --config CONFIG --include-assignments
    

Mise à niveau d'une configuration et d'affectations dans l'API

Vous pouvez utiliser l'API /v2/storage/satellite/updateAssignment pour mettre à jour vos affectations avec de nouveaux clusters ou groupes de clusters. Définissez updateConfigVersion sur true pour appliquer la mise à jour de la révision.

  1. Copiez l'exemple de demande suivant et remplacez les variables pour les groupes de clusters et les affectations que vous souhaitez mettre à jour.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/updateAssignment" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d "{ \"groups\": [ \"CLUSTER-GROUPS\" ], \"name\": \"ASSIGNMENT-NAME\", \"updateConfigVersion\": true, \"uuid\": \"ASSIGNMENT-ID\"}"
    
  2. Exécutez la demande.

  3. Obtenez les détails de votre affectation pour vérifier la mise à jour.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

Activation des mises à jour de correctif automatiques pour les affectations dans l'API

Vous pouvez utiliser l'API /v2/storage/satellite/setAssignmentAutoupgrade pour activer les mises à jour de correctif automatiques pour vos affectations. L'activation des mises à jour de correctif automatiques applique automatiquement les dernières révisions de modèle de stockage (correctifs). Vous devez toujours appliquer les mises à jour majeures manuellement.

  1. Copiez l'exemple de demande suivant et remplacez les variables pour les groupes de clusters et les affectations que vous souhaitez mettre à jour.

    curl -X PATCH "https://containers.cloud.ibm.com/global/v2/storage/satellite/setAssignmentAutoupgrade" -H "accept: application/json" -H "Authorization: Bearer TOKEN" -H "Content-Type: application/json" -d { "config": "string", "controller": "string", "autopatch": boolean,"assignment" : { "all": boolean, "uuid": ["string", "string", ...], } }
    
  2. Exécutez la demande.

  3. Obtenez les détails de votre affectation pour vérifier la mise à niveau.

    curl -X GET "https://containers.cloud.ibm.com/global/v2/storage/satellite/getAssignment?uuid=ASSIGNMENT-ID" -H "accept: application/json" -H "Authorization: Bearer TOKEN"
    

Déploiement d'une application qui utilise un stockage AWS EBS

Vous pouvez utiliser ebs-csi-driver pour mettre à disposition un stockage AWS EBS de manière dynamique pour les applications de vos clusters.

  1. Répertoriez les classes de stockage disponibles et choisissez la classe de stockage à utiliser.

    oc get sc | grep ebs
    

    Pour afficher les détails d'une classe de stockage, utilisez la commande oc describe sc <sc-name> ou consultez le fichier Référence de classe de stockage.

  2. Créez une réservation de volume persistant qui met à disposition une instance de stockage AWS EBS avec les caractéristiques décrites dans la classe de stockage que vous avez sélectionnée. L'exemple ci-après utilise la classe de stockage sat-aws-block-bronze pour créer une instance de stockage AWS EBS sur un disque dur st1 d'une taille de 125 Go. Pour plus d'informations sur ce type de volume, voir Disques durs(HDD).

    apiVersion: v1
    kind: PersistentVolumeClaim
    metadata:
      name: sat-aws-block-bronze
    spec:
      accessModes:
      - ReadWriteOnce
      storageClassName: sat-aws-block-bronze
      resources:
        requests:
          storage: 125Gi
    
  3. Créez la PVC dans votre cluster.

    oc apply -f pvc.yaml
    
  4. Vérifiez que votre réservation de volume persistant a été créée. Toutes les classes de stockage fournies par IBM étant configurées avec WaitForFirstConsumer, le statut de votre réservation de volume persistant reste à l'état Pending jusqu'à ce que vous mettiez à disposition une application qui monte votre réservation de volume persistant.

    oc get pvc
    

    Exemple de sortie

    NAME                   STATUS    VOLUME   CAPACITY   ACCESS MODES   STORAGECLASS           AGE
    sat-aws-block-bronze   Pending                                      sat-aws-block-bronze   17s
    
  5. Créez un pod qui monte la réservation de volume persistant que vous avez créée. Lorsque vous créez ce pod, le pilote AWS EBS commence à remplir votre demande de stockage en créant de manière dynamique une instance AWS EBS dans votre compte AWS. L'exemple suivant crée un pod nginx qui écrit la date et l'heure actuelles dans un fichier test.txt sur le chemin de votre montage de volume AWS EBS.

    apiVersion: v1
    kind: Pod
    metadata:
      name: app
    spec:
      containers:
      - name: app
        image: nginx
        command: ["/bin/sh"]
        args: ["-c", "while true; do echo $(date -u) >> /test/test.txt; sleep 5; done"]
        volumeMounts:
          - name: persistent-storage
            mountPath: /test
      volumes:
      - name: persistent-storage
        persistentVolumeClaim:
            claimName: sat-aws-block-bronze
    
  6. Créez le pod dans votre cluster.

    oc apply -f pod.yaml
    
  7. Vérifiez que le pod est déployé. Il peut s'écouler quelques minutes avant que la demande de stockage ne soit satisfaite et que votre application passe à l'état Running.

    oc get pods
    

    Exemple de sortie

    NAME                                READY   STATUS    RESTARTS   AGE
    app                                 1/1     Running   0          2m58s
    
  8. Vérifiez que le statut de votre réservation de volume persistant est maintenant Bound.

    oc get pvc
    

    Exemple de sortie

    NAME                 STATUS  VOLUME                                   CAPACITY   ACCESS MODES   STORAGECLASS           AGE
    sat-aws-block-bronze Bound   pvc-86d2f9f4-78d4-4bb2-ab73-39726d144981 125Gi      RWO            sat-aws-block-bronze   33m
    

    Si votre circuit virtuel permanent (PVC) reste à l'état Pending, obtenez les détails de votre PVC en exécutant la commande oc describe pvc <pvc_name> pour afficher l'erreur survenue lors de la mise à disposition de votre instance de stockage EBS AWS.

  9. Vérifiez que l'application peut écrire dans votre instance AWS EBS.

    1. Connectez-vous à votre pod.
      oc exec <app_pod_name> -it bash
      
    2. Affichez le contenu du fichier test.txt pour confirmer que votre application peut écrire des données dans votre stockage de persistance.
      cat /test/test.txt
      
      Exemple de sortie
      Tue Mar 2 20:09:19 UTC 2021
      Tue Mar 2 20:09:25 UTC 2021
      Tue Mar 2 20:09:31 UTC 2021
      Tue Mar 2 20:09:36 UTC 2021
      Tue Mar 2 20:09:42 UTC 2021
      Tue Mar 2 20:09:47 UTC 2021
      
    3. Quittez le pod.
      exit
      
  10. Vérifiez que votre instance de stockage a été créée dans AWS.

  11. Affichez le volume persistant créé pour votre réservation de volume persistant.

    oc get pv
    
  12. Extrayez les détails de votre volume persistant et notez l'ID de votre instance AWS EBS créée dans la zone source.volumeHandle.

    oc describe pv <pv_name>
    
  13. Dans le tableau de bord AWS EC2, sélectionnez Elastic Block Store > Volumes.

  14. Recherchez votre volume AWS EBS à l'aide de l'ID extrait précédemment.

Suppression du stockage AWS EBS de vos applications

Si vous n'avez plus besoin de votre instance AWS EBS, vous pouvez supprimer votre réservation de volume persistant, votre volume persistant et l'instance AWS EBS de votre compte AWS.

La suppression définitive de votre instance AWS EBS supprime toutes les données stockées dans cette instance. Cette action ne peut pas être annulée. Veillez à sauvegarder vos données avant de supprimer l'instance AWS EBS.

  1. Répertoriez vos réservations de volume persistant et notez le nom de celle à supprimer.
    oc get pvc
    
  2. Supprimez les pods qui montent la PVC.
    1. Répertoriez tous les pods qui montent actuellement la réservation de volume persistant à supprimer. Si aucun pod n'est renvoyé, aucun pod n'utilise actuellement votre réservation de volume persistant.
      oc get pods --all-namespaces -o=jsonpath='{range .items[*]}{"\n"}{.metadata.name}{":\t"}{range .spec.volumes[*]}{.persistentVolumeClaim.claimName}{" "}{end}{end}' | grep "<pvc_name>"
      
      Exemple de sortie
      app    sat-aws-block-bronze
      
    2. Supprimez le pod utilisant la PVC. Si le pod fait partie d'un déploiement, retirez ce déploiement.
      oc delete pod <pod_name>
      
      oc delete deployment <deployment_name>
      
    3. Vérifiez que le pod ou le déploiement a été supprimé.
      oc get pods
      
      oc get deployments
      
  3. Supprimez la réservation de volume persistant. Toutes les classes de stockage AWS EBS fournies par IBM étant spécifiées avec une règle de réservation Delete, le volume persistant et l'instance AWS EBS de votre compte AWS sont supprimés automatiquement lorsque vous supprimez la réservation de volume persistant.
    oc delete pvc <pvc_name>
    
  4. Vérifiez que votre stockage a été supprimé.
    1. Vérifiez que votre volume persistant est supprimé automatiquement.
      oc get pv
      
    2. Dans le tableau de bord AWS EC2, sélectionnez Elastic Block Store > Volumes et vérifiez que votre instance AWS EBS est supprimée.

Suppression de la configuration de stockage AWS EBS de votre cluster

Si vous n'avez plus l'intention d'utiliser le stockage AWS EBS dans votre cluster, vous pouvez annuler l'affectation de votre cluster de la configuration de stockage.

Notez que vous devez supprimer vos affectations de stockage avant de pouvoir supprimer votre configuration de stockage.

Notez que si vous supprimez la configuration de stockage, le pilote est ensuite désinstallé de tous les clusters affectés. Vos réservations de volume persistant, vos volumes persistants et vos données ne sont pas supprimés. Cependant, il se peut que vous ne puissiez pas accéder à vos données tant que vous n'aurez pas réinstallé le pilote dans votre cluster.

Suppression d'une configuration de stockage à partir de la console

  1. Dans le tableau de bord de stockage Satellite; sélectionnez la configuration de stockage à supprimer.
  2. Sélectionnez Actions > Supprimer.
  3. Entrez le nom de votre configuration de stockage.
  4. Sélectionnez Supprimer.

Suppression de la configuration de stockage EBS AWS à partir de l'interface de ligne de commande

Utilisez l'interface de ligne de commande pour supprimer la configuration de stockage AWS EBS.

Notez que vous devez supprimer vos affectations de stockage avant de pouvoir supprimer votre configuration de stockage.

  1. Répertoriez vos affectations de stockage et recherchez celle que vous avez utilisée pour votre cluster.
    ibmcloud sat storage assignment ls (--cluster CLUSTER | --config CONFIG | --location LOCATION | --service-cluster-id CLUSTER)
    
  2. Supprimez l'affectation. Une fois que l'affectation a été supprimée, les pods du pilote AWS EBS et les classes de stockage sont supprimés de tous les clusters qui faisaient partie de l'affectation de stockage.
    ibmcloud sat storage assignment rm --assignment <assignment_ID>
    
  3. Vérifiez que le pilote AWS EBS a été supprimé de votre cluster.
    1. Répertoriez les classes de stockage de votre cluster et vérifiez que les classes de stockage AWS EBS ont été supprimées.
      oc get sc
      
    2. Répertoriez les pods de l'espace de noms kube-system et vérifiez que les pods du pilote de stockage AWS EBS ont été supprimés.
      oc get pods -n kube-system | grep ebs
      
    3. Répertoriez les secrets de l'espace de noms kube-system et vérifiez que le secret AWS qui stockait vos données d'identification AWS a été supprimé.
      oc get secrets -n kube-system | grep aws
      
  4. Facultatif : supprimez la configuration de stockage.
    1. Répertoriez les configurations de stockage.
      ibmcloud sat storage config ls
      
    2. Supprimez la configuration de stockage.
      ibmcloud sat storage config rm --config <config_name>
      

Référence de paramètre

Référence du paramètre 1.1.0

Tableau 1. 1.1.0 référence des paramètres
Nom d'affichage Option CLI Type Description Valeur par défaut
ID de clé d'accès AWS aws-access-key Secret ID de clé d'accès AWS. N/A
Clé d'accès secrète AWS aws-secret-access-key Secret Clé d'accès secrète AWS. N/A

Référence de paramètre 1.5.1

Tableau 2. 1.5.1 Référence des paramètres
Nom d'affichage Option CLI Type Description Valeur par défaut
ID de clé d'accès AWS aws-access-key Secret ID de clé d'accès AWS. N/A
Clé d'accès secrète AWS aws-secret-access-key Secret Clé d'accès secrète AWS. N/A

Référence de paramètre 1.12.0

Tableau 3. 1.12.0 Référence des paramètres
Nom d'affichage Option CLI Type Description Valeur par défaut
ID de clé d'accès AWS aws-access-key Secret ID de clé d'accès AWS. N/A
Clé d'accès secrète AWS aws-secret-access-key Secret Clé d'accès secrète AWS. N/A

Référence du paramètre 1.31.0

Tableau 4. 1.31.0 Référence des paramètres
Nom d'affichage Option CLI Type Description Valeur par défaut
ID de clé d'accès AWS aws-access-key Secret ID de clé d'accès AWS. N/A
Clé d'accès secrète AWS aws-secret-access-key Secret Clé d'accès secrète AWS. N/A

Référence de classe de stockage pour AWS EBS

Examinez les classes de stockage Satellite d'AWS EBS. Vous pouvez décrire des classes de stockage dans la ligne de commande à l'aide de la commande oc describe sc <storage-class-name>. Notez que les volumes de données sont automatiquement chiffrés par une clé par défaut gérée par AWS. Pour plus d'informations, voir Clé KMS par défaut pour le cryptage EBS. Pour plus d'informations sur le cryptage AWS EBS, voir Comment fonctionne le cryptage AWS EBS.

Référence de classe de stockage EBS AWS.
Nom de la classe de stockage Type de volume EBS Type de système de fichiers Fournisseur E-S par seconde par Go par défaut Plage de tailles Disque dur Chiffré ? Mode de liaison des volumes Stratégie de récupération Informations complémentaires
sat-aws-block-gold Par défaut io2 ext4 ebs.csi.aws.com 10 10 Go - 6,25 To SSD Oui WaitforFirstConsumer Supprimer Lien
sat-aws-block-silver gp3 ext4 ebs.csi.aws.com N/A 1 Go - 16 To SSD Oui WaitforFirstConsumer Supprimer Lien
sat-aws-block-bronze st1 ext4 ebs.csi.aws.com N/A 125 Go - 16 To HDD Oui WaitforFirstConsumer Supprimer Lien
sat-aws-block-bronze-metro st1 ext4 ebs.csi.aws.com N/A 125 Go - 16 To HDD Oui WaitforFirstConsumer Supprimer Lien
sat-aws-block-silver-metro gp3 ext4 ebs.csi.aws.com 1 Go - 16 To SSD Oui WaitforFirstConsumer Supprimer Lien
sat-aws-block-gold-metro io2 ext4 ebs.csi.aws.com 10 10 Go - 6,25 To SSD Oui WaitforFirstConsumer Supprimer Lien

Aide et support pour AWS EBS

Lorsque vous utilisez le stockage AWS EBS, essayez les ressources suivantes avant d'ouvrir un cas de support.

  1. Consultez la foire aux questions dans le Knowledge CenterAWS.
  2. Consultez la documentation relative au traitement des incidents pour identifier et résoudre les problèmes courants.
  3. Vérifiez l'état de la plateforme et des ressources IBM Cloud en vous rendant sur la page État.
  4. Consultez Stack Overflow pour voir si d'autres utilisateurs ont rencontré le même problème. Etiquetez les questions avec ibm-cloud et AWS-EBS.
  5. Le centre de supportAWS est une autre ressource disponible pour les clients AWS à la recherche d'options de support plus approfondies.