Création d'un instantané de groupe de cohérence dans la console

Dans la console, vous pouvez créer un instantané de groupe de cohérence de volumes Block Storage for VPC connectés à une instance de serveur virtuel en cours d'exécution.

1. Cliquez sur l'icône de Navigation > Infrastructure > Stockage > Instantanés de Block Storage.
2. Dans la liste des groupes de cohérence initialement vides, cliquez sur Créer.
3. Entrez les informations requises pour définir votre groupe d'instantanés et sélectionnez l'instance de serveur virtuel comportant les volumes que vous souhaitez inclure dans votre groupe de cohérence d'instantanés.

1. Cliquez sur Créer. Vous revenez à l'écran à partir duquel vous avez commencé. Des messages s'affichent lors de la création des instantanés et du groupe de cohérence et lorsqu'ils sont prêts. Les instantanés et le groupe de cohérence sont affichés sur la page Block Storage pour VPC, dans leurs onglets respectifs. Pour plus d'informations, voir Afficher les détails de l'instantané dans la console.

Création d'un instantané de groupe de cohérence à partir de l'interface de ligne de commande (CLI)

Avant de pouvoir utiliser l'interface de ligne de commande, vous devez installer l'interface de ligne de commande d'IBM Cloud et le plug-in de l'interface de ligne de commande du VPC. Pour plus d'informations, reportez-vous à la rubrique Configuration requise pour l'interface de ligne de commande.

1. Connectez-vous à IBM Cloud®.

   ibmcloud login --sso -a cloud.ibm.com
   

   Cette commande renvoie une URL et des invites pour un code d'accès. Accédez à cette URL dans votre navigateur et connectez-vous. En cas de réussite, vous obtenez un code d'accès à usage unique. Copiez ce code et collez-le en réponse à l'invite. Une fois l'authentification réussie, vous êtes invité à choisir votre compte. Si vous avez accès à plusieurs comptes, sélectionnez celui avec lequel vous souhaitez vous connecter. Répondez à toutes les invites restantes pour terminer la connexion.

2. Répertoriez les volumes qui sont connectés à l'instance que vous souhaitez capturer dans un groupe de cohérence d'instantané. Notez les ID de volume dans la sortie.

   ibmcloud is instance INSTANCE
   

3. La commande snapshot-consistency-group-create permet de créer un groupe de cohérence. Indiquez le nom de la nouvelle image instantanée et l'ID du volume source pour chaque image instantanée qui fera partie du groupe de cohérence.

   Si le volume source possède un chiffrement user_managed, vous devez fournir le --encryption_key. La propriété --encryption_key ne doit pas être spécifiée autrement.

   ibmcloud is snapshot-consistency-group-create --snapshots '[{
        "name": "snapshot-no-1",
        "source_volume": {"id": "r106-bf595773-9922-4dd4-9a3c-998b10022e0c"},
        "user_tags": ["env:dev", "env:test"]
   }, {
        "name": "snapshot-no-2",
        "source_volume": {"id": "r106-aeb2bbe6-1d3c-4186-82ce-abddb03e243e"},
        "user_tags": ["env:dev", "env:test"]
   }]' --delete-snapshot-on-delete false --name multiple-snapshots-consistency-group-1
   Creating snapshot consistency group under account Test Account as user test.user@ibm.com...
   ID                          r006-4625d29b-3ac9-4bee-aca8-9366c4fd0c44
   Name                        multiple-snapshots-consistency-group-1
   CRN                         crn:v1:bluemix:public:is:us-south:a/a1234567::snapshot-consistency-group:r006-4625d29b-3ac9-4bee-aca8-9366c4fd0c44
   Href                        https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-4625d29b-3ac9-4bee-aca8-9366c4fd0c44
   Status                      pending
   Backup policy job           -
   Backup policy plan          -
   Delete snapshot on delete   false
   Source Snapshot             -
   Resource group              ID                                 Name
                               11caaa983d9c4beb82690daab08717e9   Default
   Created                     2023-12-05T17:32:53+05:30
   Service Tags                -
   

Pour plus d'informations sur les options de commande disponibles, voir ibmcloud is snapshot-consistency-group-create.

Création d'un instantané de groupe de cohérence à l'aide de l'API

Avant de commencer, extrayez les détails de l'instance de l'instance de serveur virtuel que vous souhaitez capturer dans le groupe de cohérence d'image instantanée. Notez les noms CRN ou les ID de volume_attachments et de boot_volume_attachment.

Vous pouvez créer un groupe de cohérence à l'aide d'un programme en appelant la méthode /snapshot_consistency_groups dans l'API VPC, comme illustré dans l'exemple de demande suivant.

curl -X POST \
"$vpc_api_endpoint/v1/snapshot_consistency_groups?version=2023-12-05&generation=2"\
 -H "Authorization: Bearer $iam_token" \
 -d '{
   "delete_snapshots_on_delete":true,
   "name": "my-snapshot-consistency-group",
   "resource_group":{"id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054"},
   "snapshots": {
    {
     "name": "my-snapshot-1",
     "source_volume": {"crn": "crn:[...]"},
     "encryption_key"; "crn:[...]"
    },
    {
     "name": "my-snapshot-2",
     "source_volume": {"crn": "crn:[...]"},
     "encryption_key"; "crn:[...]"
    },
   }"

Si le volume source possède un chiffrement user_managed, vous devez fournir le encryption_key. La propriété encryption_key ne doit pas être spécifiée autrement.

Une réponse réussie ressemble à celle de l'exemple ci-après.

{
  "created_at": "2023-12-05T20:18:18Z",
  "crn": "crn:[...]",
  "delete_snapshots_on_delete": true,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshot_consistency_groups/r006-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "id": "r006-f6bfa329-0e36-433f-a3bb-0df632e79263",
  "lifecycle_state": "pending",
  "name": "my-snapshot-consistency-group",
  "resource_group": {
    "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada913d32640909956",
    "id": "2d1bb5a8-40a8-447a-acf7-0eadc8aeb054",
    "name": "Default"
  },
  "resource_type": "snapshot_consistency_group",
  "service_tags": [],
  "snapshots": [
    {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
      "id": "r006-076191ba-49c2-4763-94fd-c70de73ee2e6",
      "name": "my-snapshot-1",
      "resource_type": "snapshot"
    },
    {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/snapshots/r006-07e34f34-49c2-4763-94fd-c70de73ae342",
      "id": "r006-07e34f34-49c2-4763-94fd-c70de73ae342",
      "name": "my-snapshot-2",
      "resource_type": "snapshot"
    }
  ]
}

Création d'un instantané de groupe de cohérence avec Terraform

Pour utiliser Terraform, téléchargez le CLI Terraform et configurez le plug-in IBM Cloud® Provider. Pour plus d'informations, voir Initiation à Terraform.

Les services d'infrastructure VPC utilisent un noeud final régional spécifique, qui cible us-south par défaut. Si votre VPC est créé dans une autre région, veillez à cibler la région appropriée dans le bloc fournisseur du fichier provider.tf.

Consultez l'exemple suivant de ciblage d'une région autre que la région par défaut us-south.

provider "ibm" {
   region = "eu-de"
}

1. Importez les détails de l'instance de serveur virtuel en tant que source de données en lecture seule. Une fois la source de données créée, vous pouvez accéder aux références d'attribut pour boot_volume et volume_attachments.

data "ibm_is_instance" "example" {
  name        = ibm_is_instance.example.name
  private_key = file("~/.ssh/id_rsa")
  passphrase  = ""
}

1. Pour créer un groupe de cohérence d'instantanés, utilisez la ressource ibm_is_snapshot_consistency_group. L'exemple suivant crée un groupe de cohérence de deux volumes.

resource "ibm_is_snapshot_consistency_group" "is_snapshot_consistency_group" {
  name = "my-data-consistency-group"
  snapshots {
    [
      name = "snapshot-1"
      source_volume = {id = "r016-0a74c6af-f9f5-4671-9025-c4efd41ac6da"}
      user_tags = ["my-tag"]
    ].
    [
      name = "snapshot-2"
      source_volume = {id = "r016-0a74c6af-f9f5-4671-9025-c4efd41ac6db"}
      user_tags = ["my-tag"]
    ]
  }
}

Pour plus d'informations sur les arguments et les attributs, voir ibm_is_snapshot_consistency_group.