Creación de una instantánea de grupo de coherencia en la consola

En la consola, puede crear una instantánea de grupo de consistencia de los volúmenes de Block Storage for VPC que están conectados a una instancia de servidor virtual en ejecución.

1. Haga clic en el menú de navegación > de infraestructura > Almacenamiento > Instantáneas Block Storage.
2. En la lista de grupos de coherencia, que inicialmente está vacía, haz clic en Crear.
3. Introduce la información necesaria para definir tu grupo de instantáneas y selecciona la instancia de servidor virtual que contenga los volúmenes que deseas incluir en tu grupo de consistencia de instantáneas.

1. Pulse Crear. Volverás a la pantalla desde la que has empezado. Se muestran mensajes mientras se crean las instantáneas y el grupo de consistencia, así como cuando están listas. Las instantáneas y el grupo de coherencia se muestran en la página Instantáneas de VPC de Block Storage, en sus respectivas pestañas. Para obtener más información, consulta Ver detalles de la instantánea en la consola.

Creación de una instantánea de grupo de consistencia desde la CLI

Para poder utilizar la CLI, debe instalar la CLI de IBM Cloud y el plugin de la CLI de VPC. Para obtener más información, consulte los Requisitos previos de la CLI.

1. Inicia sesión en IBM Cloud®.

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

   Este mandato devuelve un URL y solicita un código de acceso. Vaya a ese URL en el navegador e inicie la sesión. Si se ejecuta correctamente, recibe un código de acceso de un solo uso. Copie este código de acceso y péguelo como respuesta en la solicitud. Una vez completada con éxito la autenticación, se le pedirá que seleccione su cuenta. Si tienes acceso a varias cuentas, selecciona la cuenta con la que deseas iniciar sesión. Responda a cualquier solicitud restante para finalizar el inicio de sesión.

2. Enumera los volúmenes asociados a la instancia que deseas incluir en un grupo de consistencia de instantáneas. Fíjate en los ID de volumen que aparecen en la salida.

   ibmcloud is instance INSTANCE
   

3. Utilice el comando snapshot-consistency-group-create para crear un grupo de coherencia. Indique el nombre de la nueva instantánea y el ID del volumen de origen para cada instantánea que vaya a formar parte del grupo de consistencia.

   Si el volumen de origen está cifrado user_managed, debes proporcionar el --encryption_key. La propiedad --encryption_key no debe especificarse de otra manera.

   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                -
   

Para obtener más información sobre las opciones comando disponibles, consulta ibmcloud is snapshot-consistency-group-create.

Creación de una instantánea de grupo de coherencia con la API

Antes de empezar, obtenga los detalles de la instancia de servidor virtual que desea incluir en el grupo de consistencia de instantáneas. Utiliza GET /instances/ {id} para las instancias de servidor virtual. Anota los CRN o los ID de los volume_attachments y, en el caso de las instancias de servidor virtual, el boot_volume_attachment.

Se puede crear un grupo de consistencia mediante programación llamando al /snapshot_consistency_groups método de la API de VPC, tal y como se muestra en la siguiente solicitud de ejemplo.

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 el volumen de origen está cifrado user_managed, debes proporcionar el encryption_key. La propiedad encryption_key no debe especificarse de otra manera.

Una respuesta satisfactoria tiene un aspecto similar al del ejemplo siguiente.

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

Creación de una instantánea de grupo de consistencia con Terraform

Para utilizar Terraform, descarga la CLI de Terraform y configura el complemento del proveedor de IBM Cloud®. Para obtener más información, consulta Introducción a Terraform.

Los servicios de infraestructura de VPC utilizan un punto de conexión regional específico, que apunta a us-south de forma predeterminada. Si tu VPC se ha creado en otra región, asegúrate de indicar la región adecuada en el bloque del proveedor del archivo provider.tf.

Consulta el siguiente ejemplo sobre cómo seleccionar una región distinta de la predeterminada us-south.

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

1. Importa los detalles de la instancia del servidor virtual como una fuente de datos de solo lectura. Una vez creada la fuente de datos, puede acceder a las referencias de atributos para y boot_volume volume_attachments.

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

1. Para crear un grupo de instantáneas coherentes, utiliza el recurso ibm_is_snapshot_consistency_group. El siguiente ejemplo crea un grupo de consistencia de dos volúmenes.

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

Para obtener más información sobre los argumentos y los atributos, consulta ibm_is_snapshot_consistency_group.