Opérateur NetApp Trident

Configurer le stockage « NetApp Trident » pour les clusters « IBM Cloud Satellite® ». Vous pouvez utiliser des modèles de stockage Satellite pour créer des configurations de stockage. 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.

Vous devez déployer le modèle NetApp Trident sur vos clusters pour pouvoir créer des configurations avec les modèles NetApp ONTAP-NAS ou NetApp ONTAP-SAN.

Avant de pouvoir déployer des modèles de stockage sur les clusters de votre site, veillez à configurer « Satellite Config » en sélectionnant l'option « Activer l'accès administrateur au cluster pour Satellite Config » dans la console ou en incluant l'option « --enable-config-admin » lors de la création de votre cluster.

Il n'est pas possible de limiter la portée du service de stockage « Satellite » à des groupes de ressources. Toutefois, si vous affectez d'autres ressources (telles que des emplacements et des clusters) à des groupes de ressources, vous devez attribuer le rôle de lecteur « Satellite » et celui d'administrateur de liens à toutes les ressources du compte.

Prérequis pour NetApp Trident

  1. Créez un emplacement Satellite.

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

  1. Dans la console Locations, sélectionnez le site sur lequel vous souhaitez créer une configuration de stockage.
  2. Sélectionnez Stockage > Créer une configuration de stockage
  3. Entrez un nom pour votre configuration.
  4. Sélectionnez le type de stockage.
  5. Sélectionnez la version, puis cliquez sur Suivant
  6. Si le Type de stockage que vous avez sélectionné accepte des paramètres personnalisés, entrez-les dans l'onglet Paramètres.
  7. Si le Type de stockage que vous avez sélectionné requiert des secrets, entrez-les dans l'onglet Secrets.
  8. 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.
  9. Dans l'onglet Affecter au service, sélectionnez le service auquel vous souhaitez affecter votre configuration.
  10. Cliquez sur Terminé pour affecter votre configuration de stockage.

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

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

    ibmcloud login

  2. Répertoriez vos emplacements Satellite et notez la colonne Managed from.

    ibmcloud sat location ls

  3. 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

  4. Si vous utilisez un groupe de ressources autre que default, ciblez-le.

    ibmcloud target -g RESOURCE_GROUP

  5. 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 24.02.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 24.02

    Exemple de commande pour créer une configuration de la version 25.06.

    ibmcloud sat storage config create --location LOCATION --name NAME --template-name netapp-trident --template-version 25.06

  6. Personnalisez la commande en fonction des paramètres que vous souhaitez utiliser.

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

  8. Vérifiez que votre configuration a bien é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. 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 24.02.

    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\": \"netapp-trident\", \"storage-template-version\": \"24.02\", \"update-assignments\": true}

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

    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\": \"netapp-trident\", \"storage-template-version\": \"25.06\", \"update-assignments\": true}

Création d'une tâche dans l'interface de ligne de commande (CLI)

  1. Répertoriez vos configurations de stockage et notez celle que vous souhaitez attribuer à vos clusters.

    ibmcloud sat storage config ls

  2. Récupérez l'ID du cluster, du groupe de clusters ou du service auquel vous souhaitez attribuer un espace de 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, consultez la commandeibmcloud 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 à niveau vos configurations de stockage Satellite pour obtenir la dernière révision du modèle de stockage au sein de 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"

Suppression de l'affectation de stockage et de la configuration de stockage NetApp Trident à partir de la console

Utilisez la console pour supprimer une affectation de stockage et une configuration de stockage.

  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 l'affectation de stockage et de la configuration de stockage NetApp Trident à partir de l'interface de ligne de commande

Supprimez une affectation de stockage et une configuration de stockage à l'aide de l'interface de ligne de commande.

  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 NetApp Trident 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. Répertoriez les pods de l'espace de noms trident et vérifiez que les pods du pilote de stockage NetApp Trident ont été supprimés.

    oc get pods -n trident

  4. Vérifiez que l'espace de noms trident a été retiré.

    oc get ns

    Si l'espace de noms trident est bloqué au statut Terminating, suivez la procédure de suppression de l'espace de nom. Vous pouvez également suivre les instructions de la documentation « NetApp » pour désinstaller l'opérateur Trident.

  5. Facultatif : répertoriez vos configurations de stockage et supprimez votre configuration Trident.

    ibmcloud sat storage config ls

    ibmcloud sat storage config rm --config CONFIG_NAME

Aide et support pour NetApp Trident

Si vous rencontrez un problème avec l' NetApp Trident, vous pouvez consulter la page d'assistance de l' NetApp.