Criação de um instantâneo do grupo de consistência no console

No console, é possível criar um instantâneo de grupo de consistência de volumes d Block Storage for VPC s que estejam conectados a uma instância de servidor virtual em execução.

1. Clique no ícone “ Menu de navegação ” > Infraestrutura **> Armazenamento > Instantâneos do Block Storage **.
2. Na lista de grupos de consistência, que inicialmente está vazia, clique em “Criar ”.
3. Insira as informações necessárias para definir seu grupo de instantâneos e selecione a instância do servidor virtual que contém os volumes que você deseja incluir no seu grupo de consistência de instantâneos.

1. Clique em Criar. Você volta para a tela em que estava no início. São exibidas mensagens durante a criação dos instantâneos e do grupo de consistência, bem como quando eles estiverem prontos. Os instantâneos e o grupo de consistência são exibidos na página “Instantâneos da VPC” do Block Storage, em suas respectivas guias. Para obter mais informações, consulte “Exibir detalhes do snapshot” no console.

Criação de um instantâneo de grupo de consistência a partir da CLI

Para usar a CLI, deve-se instalar a CLI da IBM Cloud e o plug-in da CLI da VPC. Para obter mais informações, consulte os Pré-requisitos da CLI.

1. Efetue login no IBM Cloud®.

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

   Esse comando retorna uma URL e solicita uma senha. Acesse essa URL em seu navegador e efetue login. Se bem-sucedido, você receberá uma senha descartável. Copie essa senha e cole-a como uma resposta no prompt. Após a autenticação bem-sucedida, você será solicitado a escolher sua conta. Se você tiver acesso a várias contas, selecione a conta com a qual deseja fazer login. Responda a quaisquer prompts restantes para concluir o login.

2. Liste os volumes conectados à instância que você deseja incluir em um grupo de consistência de snapshot. Anote os IDs dos volumes na saída.

   ibmcloud is instance INSTANCE
   

3. Use o comando snapshot-consistency-group-create para criar um grupo de consistência. Forneça o nome do novo snapshot e o ID do volume de origem para cada snapshot que fará parte do grupo de consistência.

   Se o volume de origem tiver criptografi user_managed, você deverá fornecer a chave de criptografia ( --encryption_key). A propriedade --encryption_key não deve ser especificada de outra forma.

   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 obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is snapshot-consistency-group-create.

Criação de um instantâneo de grupo de consistência com a API

Antes de começar, obtenha os detalhes da instância do servidor virtual que você deseja incluir no grupo de consistência de instantâneos. Anote os CRNs ou IDs do volume_attachments e do boot_volume_attachment.

É possível criar um grupo de consistência programaticamente chamando o método /snapshot_consistency_groups na [API do VPC](/docs/apis/vpc/latest#create-snapshot-consistency-group){: external}, conforme mostrado na solicitação de exemplo a seguir.

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 o volume de origem tiver criptografi user_managed, você deverá fornecer a chave de criptografia ( encryption_key). A propriedade encryption_key não deve ser especificada de outra forma.

Uma resposta bem-sucedida se parece com o exemplo a seguir.

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

Criação de um snapshot de grupo de consistência com o Terraform

Para usar o Terraform, baixe a CLI do Terraform e configure o plug-in do provedor IBM Cloud®. Para obter mais informações, consulte “Introdução ao Terraform ”.

Os serviços de infraestrutura do VPC utilizam um endpoint regional específico, que, por padrão, está direcionado para us-south. Se sua VPC tiver sido criada em outra região, certifique-se de indicar a região correta no bloco do provedor no arquivo provider.tf .

Veja o exemplo a seguir de como definir como alvo uma região diferente da padrão us-south.

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

1. Importe os detalhes da instância do servidor virtual como uma fonte de dados somente leitura. Após a criação da fonte de dados, é possível acessar as referências de atributos em boot_volume e volume_attachments.

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

1. Para criar um grupo de consistência de instantâneos, use o recurso ibm_is_snapshot_consistency_group. O exemplo a seguir cria um grupo de consistência com dois 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"]
    ]
  }
}

Para obter mais informações sobre os argumentos e atributos, consulte ibm_is_snapshot_consistency_group.