Creazione di un’istantanea del gruppo di coerenza nella console

Nella console è possibile creare uno snapshot del gruppo di coerenza dei volumi di tipo “ Block Storage for VPC ” collegati a un'istanza di server virtuale in esecuzione.

1. Fai clic sull'icona " Menu di navigazione " > Infrastrutture **> Archiviazione > Istantanee di Block Storage **.
2. Dall'elenco dei gruppi di coerenza, inizialmente vuoto, fare clic su Crea.
3. Inserisci le informazioni richieste per definire il tuo gruppo di snapshot e seleziona l'istanza del server virtuale che contiene i volumi che desideri includere nel tuo gruppo di coerenza degli snapshot.

1. Fai clic su Crea. Si torna alla schermata da cui si è partiti. Vengono visualizzati dei messaggi durante la creazione delle istantanee e del gruppo di coerenza, nonché quando questi sono pronti. Gli snapshot e il gruppo di coerenza vengono visualizzati nella pagina " Block Storage: snapshot per VPC", nelle rispettive schede. Per ulteriori informazioni, consultare la sezione " Visualizza i dettagli dell'istantanea" nella console.

Creazione di un’istantanea del gruppo di coerenza dalla CLI

Prima di poter utilizzare la CLI, è necessario installare la CLI di IBM Cloud e il plug-in CLI per VPC. Per ulteriori informazioni, consultare i prerequisiti della CLI.

1. Accedi a IBM Cloud®.

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

   Questo comando restituisce un URL e richiede un passcode. Vai a tale URL nel tuo browser e accedi. Se l'operazione ha esito positivo, ricevi un passcode monouso. Copia questo passcode e incollalo come risposta al prompt. Una volta completata con successo l'autenticazione, ti verrà chiesto di scegliere il tuo account. Se disponi di più account, seleziona quello con cui desideri effettuare l'accesso. Rispondi alle richieste rimanenti per completare l'accesso.

2. Elenca i volumi associati all'istanza che desideri includere in un gruppo di coerenza degli snapshot. Prendere nota degli ID dei volumi presenti nell'output.

   ibmcloud is instance INSTANCE
   

3. Utilizzare il comando snapshot-consistency-group-create per creare un gruppo di coerenza. Specificare il nome della nuova istantanea e l'ID del volume di origine per ciascuna istantanea che farà parte del gruppo di coerenza.

   Se il volume di origine è protetto con crittografi user_managed, è necessario specificare il file di crittografia " --encryption_key". La proprietà --encryption_key non deve essere specificata in altro modo.

   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                -
   

Per ulteriori informazioni sulle opzioni di comando disponibili, consultare ibmcloud is snapshot-consistency-group-create.

Creazione di un’istantanea del gruppo di coerenza tramite l’API

Prima di iniziare, recupera i dettagli dell'istanza del server virtuale che desideri includere nel gruppo di coerenza degli snapshot. Per le istanze di server virtuali, utilizzare GET /instances/ {id}. Prendere nota dei CRN o degli ID delle istanze di server di supporto ( volume_attachments ) e, nel caso delle istanze di server virtuali, degli ID delle istanze di server di supporto ( boot_volume_attachment).

È possibile creare un gruppo di coerenza a livello di programmazione richiamando il metodo /snapshot_consistency_groups nell'API VPC, come illustrato nella seguente richiesta di esempio.

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:[...]"
    },
   }"

Se il volume di origine è protetto con crittografi user_managed, è necessario specificare il file di crittografia " encryption_key". La proprietà encryption_key non deve essere specificata in altro modo.

Una risposta corretta è simile all'esempio riportato di seguito.

{
  "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"
    }
  ]
}

Creazione di uno snapshot del gruppo di coerenza con Terraform

Per utilizzare Terraform, scarica la CLI di Terraform e configura il plug-in del provider IBM Cloud®. Per ulteriori informazioni, consultare il sito Introduzione a Terraform.

I servizi di infrastruttura VPC utilizzano un endpoint regionale specifico, che per impostazione predefinita punta a us-south. Se la tua VPC è stata creata in un’altra regione, assicurati di specificare la regione corretta nel blocco “provider” del file provider.tf.

Si veda il seguente esempio di impostazione di una regione diversa da quella predefinita us-south.

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

1. Importa i dettagli dell'istanza del server virtuale come origine dati di sola lettura. Una volta creata la fonte dati, è possibile accedere ai riferimenti agli attributi per boot_volume e volume_attachments.

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

1. Per creare un gruppo di snapshot coerente, utilizzare la risorsa ibm_is_snapshot_consistency_group. L'esempio seguente crea un gruppo di coerenza composto da due volumi.

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"]
    ]
  }
}

Per ulteriori informazioni sugli argomenti e sugli attributi, consultare ibm_is_snapshot_consistency_group.