Création et gestion de volumes dupliqués

Créer une copie d'un volume d' Block Storage for Classic à partir d'un instantané, avec des paramètres de capacité et de performances hérités ou personnalisés, sous forme de copie dépendante ou indépendante.

Le volume dupliqué hérite par défaut de la capacité et des options de performance du volume d'origine, mais vous pouvez personnaliser ces deux attributs lors de la création. Le duplicata contient une copie des données de l'instantané qui a été utilisé pour le créer.

Si vous êtes un utilisateur de compte Dedicated d'IBM Cloud® Kubernetes Service, consultez vos options de duplication d'un volume dans la IBM Cloud Kubernetes Servicedocumentation .

Etant donné que le volume dupliqué est basé sur les données d'une image instantanée de point de cohérence, vous devez disposer d'un espace d'image instantanée sur le volume d'origine avant de créer un doublon. Pour plus d'informations sur les images instantanées et la commande d'espace d'image instantanée, voir la documentation relative aux images instantanées.

Types de volumes en double

Doublon indépendant

Vous pouvez créer des doublons indépendants à partir de volumes principaux et de volumes de réplique. La copie est créée dans le même centre de données que le volume d'origine. Si vous créez un double à partir d'un volume répliqué, le volume dupliqué est créé dans le même centre de données que le volume répliqué.

Utilisations courantes pour un volume dupliqué indépendant

Copie Gold. Utilisez un volume de stockage comme copie de référence à partir de laquelle vous pouvez créer plusieurs instances destinées à divers usages.
Actualisation des données. Créez une copie de vos données de production afin de la monter dans votre environnement de test.
Développement et tests. Créez jusqu'à quatre doublons simultanés d'un volume en même temps pour créer des données dupliquées à des fins de développement et de test.

Doublon dépendant

Les volumes en double dépendants sont créés à l'aide d'une image instantanée du volume principal. Les volumes de réplication ne peuvent pas être utilisés pour créer ou mettre à jour des doublons dépendants.

Utilisations courantes pour un volume dupliqué dépendant

Test de reprise après incident. Créez un doublon de votre volume source et comparez-le à la réplique. En comparant le doublon à la réplique, vous pouvez vérifier que les données répliquées sont intactes et peuvent être utilisées en cas de sinistre, sans interrompre la réplication.
Restauration à partir d'une image instantanée. Restaurez les données sur le volume d'origine à l'aide de fichiers et de données spécifiques provenant d'une image instantanée sans écraser la totalité du volume d'origine avec la fonction de restauration d'image instantanée.
Actualisation des données. Créez une copie de vos données de production afin de la monter dans votre environnement de test.
Développement et tests. Créez jusqu'à quatre doublons simultanés d'un volume en même temps pour créer des données dupliquées à des fins de développement et de test.

Création d'un volume dupliqué dans la console

Vous pouvez créer un volume en double à partir de l'interface de ligne de commande et dans la consoleIBM Cloud de deux manières.

Création d'un double à partir de la liste de stockage dans la console

Accédez à votre liste de Block Storage for Classic dans la IBM Cloud en cliquant sur Infrastructure > Infrastructure classique > Storage > Block Storage for Classic.
Sélectionnez un volume dans la liste et cliquez sur les points de suspension > Dupliquer le volume.
Indiquez si le doublon doit être dépendant ou indépendant.
Sélectionnez l'option de snapshot à utiliser pour créer la copie. Vous pouvez choisir une image instantanée existante ou en prendre une nouvelle.
Les entrées d'emplacement restent les mêmes que pour le volume d'origine.
Facturation à l'heure ou au mois - vous pouvez choisir de mettre à disposition le volume dupliqué avec une facturation à l'heure ou au mois. Le type de facturation pour le volume d'origine est automatiquement sélectionné. Si vous voulez en choisir un autre pour votre stockage en double, vous pouvez le sélectionner ici.
Vous pouvez mettre à jour la taille du nouveau volume pour qu'elle soit supérieure à celle du volume d'origine. La taille du volume d'origine est définie par défaut.

Le redimensionnement de Block Storage for Classic est soumis à la limite de 10 fois la taille du volume d'origine.
Vous pouvez mettre à jour l'espace d'image instantanée pour le nouveau volume en ajoutant plus, moins ou pas du tout d'espace d'image instantanée.
Vous pouvez sélectionner un type de système d'exploitation différent de celui du volume d'origine ou conserver le même.
Vous pouvez, si vous le souhaitez, spécifier un niveau d'IOPS ou un niveau d'IOPS Tier pour le nouveau volume. Les IOPS du volume d'origine sont définies par défaut. Les combinaisons de performances et de taille disponibles sont affichées.
- Si le volume d'origine a un niveau Endurance avec 0,25 IOPS, vous ne pourrez pas effectuer de nouvelle sélection.
- Si le volume d'origine a un niveau Endurance avec 2, 4 ou 10 IOPS, vous pouvez indiquer n'importe lequel de ces niveaux pour le nouveau volume.
Sélectionnez la case à cocher si vous avez lu et acceptez les dispositions.
Cliquez sur Créer pour continuer.

Création d'un doublon depuis la page Détails du volume dans l'interface utilisateur

Accédez à votre liste de Block Storage for Classic.
Cliquez sur un volume dans la liste pour afficher la page des détails. (Il peut s'agir soit d'une réplique, soit d'un volume principal.)
Cliquez sur Actions > Dupliquer le volume.
Indiquez si le doublon doit être dépendant ou indépendant.
Sélectionnez l'option de snapshot à utiliser pour créer la copie. Vous pouvez choisir une image instantanée existante ou en prendre une nouvelle.
Les entrées d'emplacement restent les mêmes que pour le volume d'origine.
Facturation à l'heure ou au mois - vous pouvez choisir de mettre à disposition le volume dupliqué avec une facturation à l'heure ou au mois. Le type de facturation pour le volume d'origine est automatiquement sélectionné. Si vous voulez en choisir un autre pour votre stockage en double, vous pouvez le sélectionner ici.
Vous pouvez mettre à jour la taille du nouveau volume pour qu'elle soit supérieure à celle du volume d'origine. La taille du volume d'origine est définie par défaut.

Le redimensionnement de Block Storage for Classic est soumis à la limite de 10 fois la taille du volume d'origine.
Vous pouvez mettre à jour l'espace d'image instantanée pour le nouveau volume en ajoutant plus, moins ou pas du tout d'espace d'image instantanée.
Vous pouvez sélectionner un type de système d'exploitation différent de celui du volume d'origine ou conserver le même.
Vous pouvez, si vous le souhaitez, spécifier un niveau d'IOPS ou un niveau d'IOPS Tier pour le nouveau volume. Les IOPS du volume d'origine sont définies par défaut. Les combinaisons de performances et de taille disponibles sont affichées.
- Si le volume d'origine a un niveau Endurance avec 0,25 IOPS, vous ne pourrez pas effectuer de nouvelle sélection.
- Si le volume d'origine a un niveau Endurance avec 2, 4 ou 10 IOPS, vous pouvez indiquer n'importe lequel de ces niveaux pour le nouveau volume.
Sélectionnez la case à cocher si vous avez lu et acceptez les dispositions.
Cliquez sur Créer pour continuer.

Une fois que vous avez cliqué sur Créer, la fenêtre de confirmation de commande s'affiche. Lorsque vous fermez la fenêtre, vous revenez à la liste des ressources. Vous pouvez revenir à votre liste de volumes Block Storage for Classic pour cliquer sur le doublon nouvellement mis à disposition. La section des détails du volume affiche des informations telles que le type de doublon, un lien vers la page des détails du volume parent et le nom de l'instantané utilisé pour créer le doublon.

Création d'un doublon à partir de l'interface de ligne de commande (CLI)

Avant de commencer, choisissez le client d'interface de ligne de commande que vous souhaitez utiliser.

Vous pouvez installer l'interface de ligne de commandeIBM Cloud et installer le plug-in SL avec ibmcloud plugin install sl. Pour plus d'informations, voir Extension de l'interface de ligne de commande IBM Cloud avec des plug-in.
Vous pouvez également installer l'interface SLCLI.

Création d'un doublon à partir de l'interface de ligne de commande IBMCLOUD CLI

Vous pouvez utiliser la commande ibmcloud sl block volume-duplicate pour créer un doublon pour votre partage de blocs. L'exemple suivant crée un doublon indépendant du partage de blocs 560382016.

ibmcloud sl block volume-duplicate 560382016
This action will incur charges on your account. Continue?> y
OK
Order 110554892 was placed.
 > Storage as a Service
 > File Storage
 > 500 GBs
 > 4 IOPS per GB
 > 500 GB (Snapshot Space)
You may run 'ibmcloud sl block volume-list --order 110554892' to find this block volume after it is ready.

Si vous disposez d'un instantané spécifique contenant les données que vous souhaitez utiliser pour créer le volume dupliqué, indiquez l'ID de l'instantané à l'aide de l'option --origin-snapshot-id.

Votre nouveau doublon est prêt en quelques minutes.

$ ibmcloud sl block volume-list --order 110554892
id          username             datacenter   storage_type             capacity_gb   bytes_used   IOPs   ip_addr                                 lunId   active_transactions   rep_partner_count   notes
560391190   SL02SEV1414935_269   dal09        endurance_block_storage   500           -            -      fsf-dal0902b-fz.service.softlayer.com   -       1                     0                   -

Lorsque vous souhaitez créer un doublon dépendant de votre volume, utilisez la commande avec l'option --dependent-duplicate. Consultez l'exemple suivant.

$ ibmcloud sl block volume-duplicate 560391190 --dependent-duplicate
This action will incur charges on your account. Continue?> y
OK
Order 110553472 was placed.
 > Storage as a Service
 > File Storage
 > 500 GBs
 > 4 IOPS per GB
 > 500 GB (Snapshot Space)
You may run 'ibmcloud sl block volume-list --order 110553472' to find this block volume after it is ready.

Pour plus d'informations sur tous les paramètres disponibles pour cette commande, voir ibmcloud sl block volume-duplicate.

Création d'un doublon à partir de l'interface SLCLI

Pour créer un volume dupliqué indépendant Block Storage for Classic, vous pouvez utiliser la commande suivante.

$ slcli block volume-duplicate --help
Usage: slcli block volume-duplicate [OPTIONS] ORIGIN_VOLUME_ID
Options:
  -o, --origin-snapshot-id INTEGER
                                  ID of an origin volume snapshot to use for
                                  duplcation.
  -c, --duplicate-size INTEGER    Size of duplicate block volume in GB. ***If
                                  no size is specified, the size of the origin
                                  volume will be used.***
                                  Minimum: [the size
                                  of the origin volume]
  -i, --duplicate-iops INTEGER    Performance Storage IOPS, between 100 and
                                  6000 in multiples of 100 [only used for
                                  performance volumes] ***If no IOPS value is
                                  specified, the IOPS value of the origin
                                  volume will be used.***
                                  Requirements: [If
                                  IOPS/GB for the origin volume is less than
                                  0.3, IOPS/GB for the duplicate must also be
                                  less than 0.3. If IOPS/GB for the origin
                                  volume is greater than or equal to 0.3,
                                  IOPS/GB for the duplicate must also be
                                  greater than or equal to 0.3.]
  -t, --duplicate-tier [0.25|2|4|10]
                                  Endurance Storage Tier (IOPS per GB) [only
                                  used for endurance volumes] ***If no tier is
                                  specified, the tier of the origin volume
                                  will be used.***
                                  Requirements: [If IOPS/GB
                                  for the origin volume is 0.25, IOPS/GB for
                                  the duplicate must also be 0.25. If IOPS/GB
                                  for the origin volume is greater than 0.25,
                                  IOPS/GB for the duplicate must also be
                                  greater than 0.25.]
  -s, --duplicate-snapshot-size INTEGER
                                  The size of snapshot space to order for the
                                  duplicate. ***If no snapshot space size is
                                  specified, the snapshot space size of the
                                  origin block volume will be used.***
                                  Input
                                  "0" for this parameter to order a duplicate
                                  volume with no snapshot space.
  --billing [hourly|monthly]      Optional parameter for Billing rate (default
                                  to monthly)
  -h, --help                      Show this message and exit.

Les volumes en double dépendants peuvent également être commandés à partir de l'interface de ligne de commande, avec l'option --dependent-duplicate TRUE.

slcli block volume-duplicate --dependent-duplicate TRUE ORIGIN_VOLUME_ID

Pour plus d'informations sur les options de commande disponibles, voir block volume-duplicate.

Création d'un volume dupliqué avec l'API

Pour commander un volume indépendant dupliqué Block Storage for Classic avec l'API, vous pouvez faire un appel POST à l'API SL. L'exemple d'API REST suivant crée un double indépendant pour un volume Endurance (niveaux IOPS), qui est identifié par son ID de volume dans la duplicateOriginVolumeId propriété.

URL - https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder
Type-POST

Corps de la demande-

{
    "parameters":[{
    "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
    "packageId": 531,
    "duplicateOriginVolumeId":<PrimaryId>,
    "isDependentDuplicateFlag": 0,
    "prices": [{"id": 19497}, {"id": 16479}, {"id": 12931}, {"id": 15749}, {"id":10407}],
    "quantity": 1,
    "osFormatType":{
     "keyName": "LINUX"
    },
    "location": 2,
    "volumeSize":23
    }]
}

Si vous disposez d'un instantané spécifique contenant les données que vous souhaitez utiliser pour créer le volume dupliqué, indiquez l'ID de l'instantané dans la propriété duplicateOriginSnapshotId.

Pour commander un doublon dépendant pour un volume Performance (IOPS personnalisé), effectuez un appel POST /SoftLayer_Product_Order/placeOrder comme dans l'exemple d'API REST suivant.

URL - https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Product_Order/placeOrder
Type-POST

Corps de la demande-

{
    "parameters":[{
    "complexType": "SoftLayer_Container_Product_Order_Network_Storage_AsAService",
    "packageId": 531,
    "duplicateOriginVolumeId":1327277,
    "isDependentDuplicateFlag": 1,
    "prices": [{"id": 15751}, {"id": 19487}, {"id": 18983}, {"id": 15749}, {"id":10407}],
    "quantity": 1,
    "iops":454,
    "osFormatType":{
        "keyName": "LINUX"
    },
    "location": 2,
    "volumeSize":23
    }]
}

Pour plus d'informations sur l'API et les options, voir Référence d'API. Recherchez le type de données SoftLayer_Container_Product_Order_Network_Storage_AsAService type de données.

Gestion de votre volume dupliqué

Tous les volumes en double sont accessibles par un hôte pour les opérations de lecture et d'écriture dès que le volume est mis à disposition.

Toutefois, les images instantanées et la réplication des volumes en double indépendants ne sont pas autorisées tant que la copie des données de l'original vers le doublon n'est pas terminée et que le volume en double n'est pas totalement indépendant. Selon le volume des données, le processus de séparation peut prendre plusieurs heures. Une fois terminé, le double peut être géré et utilisé comme un volume indépendant.

Pendant la copie des données du volume d'origine vers la copie indépendante, vous pouvez constater que l'indicateur d'état sur la page de détails indique que la duplication est en cours. Pendant ce temps, vous pouvez associer le volume à un hôte, ainsi que lire et écrire sur celui-ci, mais vous ne pouvez pas créer de planifications de snapshots ni lancer d'actualisation. Une fois le processus de séparation terminé, le nouveau volume est indépendant de l'original et peut être géré normalement à l'aide de snapshots et de la réplication. Une fois la conversion terminée, le volume indépendant peut être actualisé manuellement à l'aide d'une image instantanée du volume parent.

Les doublons dépendants ne passent pas par le processus de séparation et peuvent être actualisés manuellement à tout moment. Le processus d'actualisation peut être lancé depuis la CLI, avec l'API et dans la console. Par la suite, si vous souhaitez convertir le doublon dépendant en volume indépendant, vous pouvez lancer ce processus à l'aide de l'interface utilisateur, de l'interface de ligne de commande ou de l'API.

Le volume dupliqué dépendant verrouille l'instantané d'origine de sorte que l'instantané ne peut pas être supprimé tant que le doublon dépendant existe.

Mise à jour des données sur le duplicata du volume parent dans la console

A mesure que le temps passe et que le volume principal change, le volume dupliqué peut être mis à jour pour refléter ces changements via l'action d'actualisation. La mise à jour consiste à créer un instantané du volume principal, puis à mettre à jour le volume dupliqué à l'aide des données de cet instantané.

Si le volume en double est indépendant, vous pouvez arrêter une opération d'actualisation en cours d'exécution et en démarrer une nouvelle.

Accédez à votre liste de Block Storage for Classic dans la IBM Cloud en cliquant sur Infrastructure > Infrastructure classique > Storage > Block Storage for Classic.
Localisez le volume en double et cliquez sur son nom pour afficher les détails du volume.
Cliquez sur Actions > Restaurer l'instantané parent.
Dans la liste des instantanés, sélectionnez l'instantané parent qui contient les données à restaurer sur le volume en double. Si le volume en double que vous actualisez est un volume indépendant, vous pouvez arrêter une opération en cours d'exécution et forcer le démarrage d'une nouvelle restauration. Si vous souhaitez forcer l'arrêt d'un processus d'actualisation en cours, cochez la case avant de continuer.

La restauration de données à partir d'un instantané entraîne la perte de toutes les données créées ou modifiées depuis la prise de l'instantané sélectionné. Au cours de la transaction de rafraîchissement, le volume dupliqué est désactivé et doit être remonté une fois le rafraîchissement terminé.
Cliquez sur Oui pour lancer l'actualisation. L'actualisation peut prendre un certain temps. La barre d'état affiche le pourcentage de données copiées sur le volume. Pour afficher le statut mis à jour, actualisez la page dans le navigateur.

Conversion d'un volume dépendant en un double indépendant dans la console

Accédez à votre liste de Block Storage for Classic dans la IBM Cloud en cliquant sur Infrastructure > Infrastructure classique > Storage > Block Storage for Classic.
Localisez le volume en double et cliquez sur son nom pour afficher les détails du volume.
Cliquez sur Actions > Convertir les doublons dépendants.
Cochez la case pour confirmer que vous souhaitez poursuivre la conversion.
Cliquez sur Oui.

Le processus de conversion peut prendre un certain temps. Plus le volume est grand, plus il faut de temps pour le convertir. Vous pouvez afficher le statut du processus sur la page des détails du volume sous l'en-tête Dupliquer le statut de conversion.

Mise à jour des données sur le doublon à partir du volume parent à partir de l'interface de ligne de commande

Les actualisations peuvent être lancées à l'aide de la commande suivante.

slcli block volume-refresh <duplicate-vol-id> <primary-snapshot-id>

Une actualisation n'entraîne pas de temps d'arrêt sur le volume principal. Cependant, pendant l'opération de rafraîchissement, le volume dupliqué est désactivé et doit être remonté une fois le rafraîchissement terminé.

Le processus d'actualisation peut prendre du temps. Si vous constatez que vous disposez de nouvelles données que vous souhaitez copier sur le volume dupliqué indépendant, vous pouvez exécuter la commande slcli block volume-refresh avec l'option --force-refresh pour arrêter toutes les transactions d'actualisation en cours et en attente et lancer une nouvelle actualisation.

Le processus d'actualisation forcée fonctionne uniquement sur les volumes indépendants.

Pour plus d'informations sur les options de commande disponibles, voir slcli block volume-refresh.

Conversion d'un volume dépendant en doublon indépendant à partir de l'interface de ligne de commande

Si vous souhaitez utiliser le volume dépendant en tant que volume autonome à l'avenir, vous pouvez le convertir en un volume IBM Cloud® Block Storage for Classic indépendant normal à l'aide de l'interface SLCLI. Utilisez la commande suivante :

slcli block volume-convert <dependent-vol-id>

Le processus de conversion peut prendre un certain temps. Plus le volume est grand, plus il faut de temps pour le convertir. Utilisez la commande suivante pour vérifier l'avancement.

slcli block duplicate-convert-status <dependent-vol-id>

L'exemple suivant illustre la sortie à laquelle vous pouvez vous attendre.

slcli block duplicate-convert-status 370597202
Username            Active Conversion Start Timestamp   Completed Percentage
SL02SEVC307608_74   2022-06-13 14:59:17                 90

Pour plus d'informations sur les options de commande disponibles, voir duplicate-convert-status.

Mise à jour des données sur le doublon à partir du volume parent à l'aide de l'API

Le processus d'actualisation peut prendre du temps. Pour ajouter de nouvelles données au duplicata avant la fin de l'actualisation en cours, faites un deuxième appel à refreshDuplicate avec le paramètre forceRefresh réglé sur true. Cette opération arrête toutes les transactions de rafraîchissement en cours et en attente et démarre un nouveau rafraîchissement. Si le paramètre vaut false ou n'est pas spécifié, l'appel échoue si un autre rafraîchissement est en cours.

Le processus d'actualisation forcée fonctionne uniquement sur les volumes indépendants.

Exemple d'API REST

URL - https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/duplicateVolumeId/refreshDuplicate
Type-POST

Corps de la demande-

{
 "parameters": [primaryVolumeSnapshotId, true OR false]
}

Exemple d'API SOAP

URL - https://api.softlayer.com/soap/v3.1/SoftLayer_Network_Storage
Type-POST

Corps de la demande-

<?xml version="1.0" encoding="UTF-8"?>
<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:ns1="http://api.service.softlayer.com/soap/v3.1/">
<SOAP-ENV:Header>
 <ns1:authenticate>
  <username>USERNAME</username>
  <apiKey>APIKEY</apiKey>
 </ns1:authenticate>
 <ns2:SoftLayer_Network_StorageInitParameters>
  <id>duplicate Volume Id</id>
 </ns2:SoftLayer_Network_StorageInitParameters>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
 <ns1:refreshDuplicate>
   <snapshotId xsi:type="int">primary Volume Snapshot Id</snapshotId>
   <forceRefresh xsi:type="boolean">true</forceRefresh> <-- (remove this tag for normal refresh)
 </ns1:refreshDuplicate>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>

Pour plus d'informations sur l'API et les options, voir API Reference et SoftLayer_Network_Storage::refreshDuplicate.

Conversion d'un volume dépendant en doublon indépendant à l'aide de l'API

Si vous souhaitez utiliser le volume dépendant comme un volume autonome à l'avenir, vous pouvez le convertir en un volume normal et indépendant d' IBM Cloud® Block Storage for Classic s à l'aide de l'API. Consultez l'exemple suivant qui utilise l'API REST.

URL - https://USERNAME:APIKEY@api.softlayer.com/rest/v3.1/SoftLayer_Network_Storage/<storageId>/convertCloneDependentToIndependent
Type-POST
Corps de la demande-vide

Pour plus d'informations sur l'API et les options, voir Référence d'API.

Annulation d'un volume de stockage avec un volume dupliqué dépendant

Pour supprimer un volume parent comportant des volumes dépendants actifs, il faut d'abord supprimer les volumes dépendants en double.