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 des volumes d' Block Storage for VPC s qui sont associés à une instance de serveur virtuel en cours d'exécution.

1. Cliquez sur l’icône menu de navigation > > Stockage > Instantanés d’ Block Storage.
2. Dans la liste des groupes de cohérence, initialement vide, cliquez sur Créer.
3. Saisissez les informations requises pour définir votre groupe de snapshots, puis sélectionnez l'instance de serveur virtuel contenant les volumes que vous souhaitez inclure dans votre groupe de cohérence des snapshots.

1. Cliquez sur Créer. Vous revenez à l'écran d'où vous êtes parti. Des messages s'affichent pendant la création des instantanés et du groupe de cohérence, ainsi que lorsque ceux-ci sont prêts. Les instantanés et le groupe de cohérence s'affichent sur la page Instantanés pour VPC d' Block Storage, dans leurs onglets respectifs. Pour plus d’informations, consultez la section Afficher les détails d’un 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 associés à l'instance que vous souhaitez inclure dans un groupe de cohérence de snapshots. Notez les identifiants de volume dans la sortie.

   ibmcloud is instance INSTANCE
   

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

   Si le volume source est chiffré user_managed, vous devez fournir le fichier --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, consultez ibmcloud is snapshot-consistency-group-create.

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

Avant de commencer, récupérez les informations relatives à l'instance de serveur virtuel que vous souhaitez inclure dans le groupe de cohérence des instantanés. Utilisez GET /instances/ {id} pour les instances de serveurs virtuels. Notez les CRN ou les identifiants des et volume_attachments, pour les instances de serveurs virtuels, les boot_volume_attachment.

Vous pouvez créer un groupe de cohérence par programmation en appelant la méthode /snapshot_consistency_groups dans l'API VPC, comme indiqué dans l'exemple de requête 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 est chiffré user_managed, vous devez fournir le fichier 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 l'interface CLI de Terraform et configurez le plug-in IBM Cloud® Provider. Pour plus d'informations, consultez la section Premiers pas avec Terraform.

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

Consultez l'exemple suivant pour savoir comment cibler une région autre que celle 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’attributs pour et boot_volume 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 cohérent d'instantanés, utilisez la ressource ibm_is_snapshot_consistency_group. L'exemple suivant crée un groupe de cohérence composé 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, consultez ibm_is_snapshot_consistency_group.