Anexando um volume a uma instância da lista de volumes

Na lista de todos os volumes do “ Block Storage for VPC ”, siga estas etapas.

1. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Storage > Block Storage volumes.
2. Na lista de volumes, identifique um volume disponível e não anexado e clique no ícone Ações no final de uma linha.
3. Selecione Anexar à instância.
4. Selecione uma instância de servidor virtual na lista de instâncias disponíveis e, em seguida, clique em Salvar. Se a lista não mostrar nenhuma instância de servidor virtual, clique em Criar servidor para acessar a página de fornecimento de instância
5. Mensagens são exibidas na página de detalhes do volume para indicar que ele está sendo conectado à imagem. Quando ele for concluído, o nome da imagem aparecerá em Instâncias anexadas.

Ao criar uma instância do Hyper Protect Virtual Servers e se o contrato mencionar volumes, você tem 15 minutos após a criação da instância para conectar um volume de dados. A falha em fazer isso faz a instância entrar em um estado de encerramento após a janela de 15 minutos.

Anexando um volume a uma instância na página de detalhes do volume

Na página de detalhes do volume, siga estas etapas:

1. Selecione um volume não conectado na lista de Block Storage.
2. Na página de detalhes do volume, no ladrilho Instâncias de servidor virtual e clique em Anexar
3. No painel lateral, selecione uma instância de servidor virtual, e clique em Salvar. Se a lista não mostrar nenhuma instância de servidor virtual, clique em Criar servidor para acessar a página de fornecimento de instância O volume de inicialização ou de dados é mostrado na página de fornecimento da instância em seus respectivos campos
4. Mensagens exibem que o volume está sendo conectado à imagem. Quando ele for concluído, o nome da imagem aparecerá em Instâncias anexadas.

Anexando um volume a uma instância a partir da página de detalhes da instância

Anexe um volume Block Storage for VPC na página de detalhes da instância de servidor virtual.

1. No IBM Cloud console, clique no ícone Navigation menu > Infrastructure > Compute > Virtual server instances.
2. Selecione uma instância na lista de todas as instâncias do servidor virtual. Se algum volume Block Storage for VPC estiver conectado, ele será listado em Volumes de armazenamento.
3. Selecione Anexar volume.
4. Selecione um volume na lista de recursos disponíveis e clique em Anexar. Mensagens são exibidas na página de detalhes da instância para indicar que o volume está sendo conectado. Quando o processo for concluído, a lista de volumes de armazenamento será atualizada para incluir o novo volume.

Antes de Iniciar

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.

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ê é solicitado a escolher a 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.

Montagem de um volume do Block Storage for VPC pela CLI

Para conectar um volume a uma instância de servidor virtual no grupo de recursos atual, execute este comando.

ibmcloud is instance-volume-attachment-add NAME INSTANCE_ID VOLUME_ID [--auto-delete true | false] [--json]

NAME é o nome que você fornece para o anexo de volume e INSTANCE_ID é o ID da instância de servidor virtual. O VOLUME_ID especifica o volume sendo conectado. Se você desejar que o volume seja excluído automaticamente quando a instância de servidor virtual for excluída, especifique --auto-delete true

Para visualizar uma lista das instâncias de servidor virtual disponíveis, execute o comando ibmcloud is instances``. Dê uma olhada no exemplo a seguir.

ibmcloud is instances

Listing instances in all resource groups and region us-east under account Test Account as user test.user@ibm.com...
ID                                          Name                 Status    Reserved IP   Floating IP      Profile    Image                                VPC                              Zone        Resource group
0757_506a787d-0672-4209-854b-3e280ec50b44    my-rhel-instance    running   10.241.0.4    169.63.96.188    bx2-2x8    ibm-redhat-9-0-minimal-amd64-2       test-pbalak1                     us-east-1   defaults
0757_4fc00b09-c967-46bf-9203-d17a08078d1d    my-rhel-instance2   running   10.241.0.5    150.239.86.22    bx2-2x8    ibm-redhat-9-0-minimal-amd64-2       test-pbalak1                     us-east-1   defaults
0757_11f5db7f-35a1-4678-bcbd-c85204e09507    my-test-ro          stopped   10.241.0.5    -                bx2d-2x8   ibm-ubuntu-18-04-5-minimal-amd64-1   test-vpc-blu-wdc                 us-east-1   defaults
0767_7ac6da13-c16a-4f58-9981-612d6e33ec53    my-ubuntu-vsi       running   10.241.64.4   -                bx2-2x8    ibm-centos-7-9-minimal-amd64-3       test-vpc-blu-wdc                 us-east-2   defaults
0757_ff64452f-7e81-4a48-b938-7fc601597dcd    my-new-ubuntu-vsi   running   10.241.14.4   52.116.121.167   mx2-2x16   ibm-ubuntu-20-04-6-minimal-amd64-1   test-vpc-do-not-delete-default   us-east-1   Default
0757_337977c1-f1f0-42ad-9de4-16fe0cda2ba9    my-virtual-server   running   10.241.4.4    52.116.124.193   mx2-2x16   ibm-ubuntu-20-04-6-minimal-amd64-1   test-vpc-do-not-delete-default   us-east-1   Default

Em seguida, selecione a instância de servidor virtual que está na mesma zona que o volume que você deseja anexar

ibmcloud is instance-volume-attachment-add otp1 0757_11f5db7f-35a1-4678-bcbd-c85204e09507 demo-volume-update --auto-delete true

Creating volume attachment otp1 for instance my-test-ro under account Test Account as user test.user@ibm.com...
ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c
Name              otp1
Volume            ID                                          Name
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update
Status            attaching
Bandwidth(Mbps)   393
Type              data
Device            -
Auto delete       true
Created           2023-06-29T18:14:57+00:00

Para obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is instance-volume-attachment-add

Mostrar detalhes de um volume conectado a uma instância de servidor virtual

Depois de conectar um volume, você pode exibir os detalhes especificando o ID ou o nome da instância e o ID ou o nome da conexão do volume no comando instance-volume-attachment .

ibmcloud is instance-volume-attachment INSTANCE VOLUME_ATTACHMENT [--json]

ibmcloud is instance-volume-attachment my-test-ro otp1

Getting volume attachment otp1 of instance my-test-ro under account Test Account as user test.user@ibm.com...
ID                0757-6757e676-0bf5-4b79-9a5b-29c24e17420c
Name              otp1
Volume            ID                                          Name
                  r014-dee9736d-08ee-4992-ba8d-3b64a4f0baac   demo-volume-update
Status            attached
Bandwidth(Mbps)   393
Type              data
Device            0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7
Auto delete       true
Created           2023-06-29T18:14:57+00:00

Para obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is instance-volume-attachment

Listar todos os anexos de volume de uma instância do servidor

Use o comando instance-volume-attachments e especifique o ID ou o nome da instância para visualizar todas as conexões de volume de uma instância.

ibmcloud is instance-volume-attachments INSTANCE [--json]

Consulte o exemplo a seguir.

ibmcloud is instance-volume-attachments my-test-ro

Listing volume attachments of instance my-test-ro under account Test Account as user test.user@ibm.com...
ID                                          Name                                 Volume                          Status     Type   Device                                            Auto delete
0757-6757e676-0bf5-4b79-9a5b-29c24e17420c   otp1                                 demo-volume-update              attached   data   0757-6757e676-0bf5-4b79-9a5b-29c24e17420c-bxsh7   true
0757-af470ade-9d5c-491e-97b2-f000ed4ee49b   scheming-tipper-shivering-decrease   my-test-ro-boot-1629867631000   attached   boot   0757-af470ade-9d5c-491e-97b2-f000ed4ee49b-fc4tl   true

Para obter mais informações sobre as opções de comando disponíveis, consulte ibmcloud is instance-volume-attachments

Criar um JSON de anexo de volume

Ao provisionar uma instância de servidor virtual pela CLI e criar um volume do tipo “ Block Storage for VPC ” como parte do processo, é possível especificar um JSON de conexão de volume. O JSON de conexão do volume, especificado no comando ou como um arquivo, contém os parâmetros do volume.

No comando da CLI usado para criar uma instância, você especifica a opção --volume-attach e o arquivo JSON do volume. Por exemplo, --volume-attach @/Users/myname/myvolume-attachment_create.json.

O exemplo a seguir mostra o conteúdo de um arquivo JSON de anexo de volume que define um volume customizado e especifica as tags do usuário:

[
    {
        "name": "myvolume-attachment",
        "delete_volume_on_instance_delete": true,
        "volume": {
            "name": "myvolume",
            "capacity": 100,
            "iops": 1000,
            "profile": {
                "name": "custom"
            },
            "user_tags": {
                "env:test"
            }
        }
    }
]

Como conectar um volume do Block Storage for VPC a uma instância de servidor virtual por meio da API

Conecte volumes d Block Storage for VPC s a uma instância de servidor virtual por meio de chamadas diretas às APIs REST.

Crie uma conexão de volume para uma instância a fim de conectar um volume do Block Storage for VPC. Faça uma solicitação do tipo “ POST /instances ” e especifique volume_attachments.

POST/instances/{instance_id}/volume_attachments

O exemplo a seguir cria uma conexão de volume e especifica o volume pelo ID.

curl -X POST "$vpc_api_endpoint/v1/instances/$instance_id/volume_attachments?version=2021-04-20&generation=2" \
-H "Authorization: Bearer $iam_token" \
-d '{
      "delete_volume_on_instance_delete": true,
      "name": "my-volume-attachment-data-5iops",
      "volume": {"id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945"}
    }'

Uma resposta bem-sucedida indica que o volume está anexado.

{
  "created_at": "2021-04-21T16:35:47.000Z",
  "delete_volume_on_instance_delete": true,
  "href": "https://us-south.iaas.cloud.ibm.com/v1/instances/8f06378c-ed0e-481e-b98c-9a6dfbee1ed5/volume_attachments/9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "id": "9f2a645e-19c1-4f8f-b062-46b9e0671999",
  "name": "my-volume-attachment-data-5iops",
  "status": "attached",
  "type": "data",
  "volume": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/volumes/d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "id": "d8b26921-1409-4c2f-9b46-39b5b6e0b945",
    "name": "my-volume-data-5iops"
  }
}