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 Locations, sélectionnez le site sur lequel 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, puis 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.0.0.

   ibmcloud sat storage config create --location LOCATION --name NAME --template-name local-storage --template-version 1.0.0 --param "install-local-storage-file=INSTALL-LOCAL-STORAGE-FILE"  --param "auto-discover-devices-file=AUTO-DISCOVER-DEVICES-FILE"  --param "file-nodes-label-key=FILE-NODES-LABEL-KEY"  --param "file-nodes-label-value=FILE-NODES-LABEL-VALUE"  --param "file-devicepath=FILE-DEVICEPATH"  --param "fstype=FSTYPE"  --param "install-local-storage-block=INSTALL-LOCAL-STORAGE-BLOCK"  --param "auto-discover-devices-block=AUTO-DISCOVER-DEVICES-BLOCK"  --param "block-nodes-label-key=BLOCK-NODES-LABEL-KEY"  --param "block-nodes-label-value=BLOCK-NODES-LABEL-VALUE"  --param "block-devicepath=BLOCK-DEVICEPATH"
   

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 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. 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.0.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\": \"local-storage\", \"storage-template-version\": \"1.0.0\", \"update-assignments\": true, \"user-config-parameters\": { \"entry.name\": \"INSTALL-LOCAL-STORAGE-FILE\", { \"entry.name\": \"AUTO-DISCOVER-DEVICES-FILE\", { \"entry.name\": \"FILE-NODES-LABEL-KEY\", { \"entry.name\": \"FILE-NODES-LABEL-VALUE\", { \"entry.name\": \"FILE-DEVICEPATH\", { \"entry.name\": \"FSTYPE\", { \"entry.name\": \"INSTALL-LOCAL-STORAGE-BLOCK\", { \"entry.name\": \"AUTO-DISCOVER-DEVICES-BLOCK\", { \"entry.name\": \"BLOCK-NODES-LABEL-KEY\", { \"entry.name\": \"BLOCK-NODES-LABEL-VALUE\", { \"entry.name\": \"BLOCK-DEVICEPATH\",\"user-secret-parameters\": }
   

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 d'une configuration de stockage depuis 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 du stockage local à partir de la ligne de commande

1. Répertoriez les ressources de l'espace de noms local-storage. Lorsque vous supprimez votre affectation de stockage, ces ressources sont supprimées.

   oc get all -n local-storage
   

   Exemple de sortie

   NAME                                         READY   STATUS    RESTARTS   AGE
   pod/local-disk-local-diskmaker-clvg6         1/1     Running   0          29h
   pod/local-disk-local-diskmaker-kqddq         1/1     Running   0          29h
   pod/local-disk-local-diskmaker-p6z9q         1/1     Running   0          29h
   pod/local-disk-local-provisioner-dw5g7       1/1     Running   0          29h
   pod/local-disk-local-provisioner-hxd9n       1/1     Running   0          29h
   pod/local-disk-local-provisioner-tfg95       1/1     Running   0          29h
   pod/local-storage-operator-df4994656-7826l   1/1     Running   0          29h
   NAME                             TYPE        CLUSTER-IP      EXTERNAL-IP   PORT(S)     AGE
   service/local-storage-operator   ClusterIP   172.21.147.17   <none>        60000/TCP   29h
   NAME                                          DESIRED   CURRENT   READY   UP-TO-DATE   AVAILABLE   NODE SELECTOR   AGE
   daemonset.apps/local-disk-local-diskmaker     3         3         3       3            3           <none>          29h
   daemonset.apps/local-disk-local-provisioner   3         3         3       3            3           <none>          29h
   NAME                                     READY   UP-TO-DATE   AVAILABLE   AGE
   deployment.apps/local-storage-operator   1/1     1            1           29h
   NAME                                               DESIRED   CURRENT   READY   AGE
   replicaset.apps/local-storage-operator-df4994656   1         1         1       29h
   

2. 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)
   

3. Supprimez l'affectation. Une fois que l'affectation a été supprimée, les pods du pilote de stockage local 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>
   

4. Répertoriez les ressources de l'espace de noms local-storage et vérifiez que les pods du pilote de stockage local ont été supprimés.

   oc get all -n local-storage
   

   Exemple de sortie

   No resources found in local-storage namespace.
   

5. Répertoriez les classes de stockage de votre cluster et vérifiez que les classes de stockage local ont été supprimées.

   oc get sc
   

6. Facultatif : supprimez la configuration de stockage.

   1. Répertoriez les configurations de stockage.

       ibmcloud sat storage config ls
       ```
   2. Supprimez la configuration de stockage.
   
   ```sh {: pre}
       ibmcloud sat storage config rm --config <config_name>
       ```
   

7. Répertoriez vos réservations de volume persistant et notez le nom de celle à supprimer.

   oc get pvc
   

8. Supprimez les pods qui montent actuellement la réservation de volume persistant.

   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
   
       ```sh {: screen}
       app    sat-local-block-gold
       ```
   
   2. Supprimez le pod utilisant la PVC. Si le pod fait partie d'un déploiement, retirez ce déploiement.
   
   ```sh {: pre}
       oc delete pod <pod_name>
       ```
       ```sh {: pre}
       oc delete deployment <deployment-name>
       ```
   3. Vérifiez que le pod ou le déploiement a été supprimé.
   
   ```sh {: pre}
       oc get pods
       ```
       ```sh {: pre}
       oc get deployments
       ```
   

9. Supprimez la réservation de volume persistant. Toutes les classes de stockage par blocs local fournies par IBM étant spécifiées avec une règle de réservation Retain, le volume persistant et la réservation de volume persistant ne sont pas supprimés automatiquement lorsque vous supprimez votre application ou déploiement.

   oc delete pvc <pvc-name>
   

10. Vérifiez que votre réservation de volume persistant a été supprimée.

    oc get pvc
    

11. Répertoriez vos volumes persistants et notez le nom de celui à supprimer.

    oc get pv
    

12. Supprimez les volumes persistants. Une fois que vos volumes persistants ont été supprimés, vos disques deviennent disponibles pour les autres charges de travail.

    oc delete pv <pv-name>
    

13. Vérifiez que votre volume persistant a été supprimé.

    oc get pv