Adjuntar un volumen de Block Storage for VPC

Conecta volúmenes de datos de almacenamiento en bloque de « IBM Cloud » a instancias de servidores virtuales para obtener capacidad de almacenamiento adicional mediante la consola, la CLI, la API o Terraform.

Límites de conexión de volúmenes

Solo se puede conectar un volumen de arranque de Block Storage for VPC a una instancia de servidor virtual a la vez, pero se pueden conectar hasta 12 volúmenes de datos de Block Storage for VPC a una misma instancia.

Al crear un « Hyper Protect Virtual Servers » para una instancia de « IBM Cloud® Virtual Private Cloud », actualmente solo se puede añadir un volumen de datos. Incluso si conecta más volúmenes, la instancia no los utiliza.

No es posible utilizar la interfaz de usuario para adjuntar volúmenes de Block Storage for VPC a los nodos de trabajo de un clúster de IBM Cloud® Kubernetes Service. Para obtener más información sobre cómo utilizar la CLI para conectar volúmenes a los nodos del clúster, consulta Almacenamiento de datos en Block Storage for VPC.

Cómo conectar un volumen de Block Storage for VPC a una instancia de servidor virtual

Puede conectar un volumen a una instancia de servidor virtual desde la lista de volúmenes Block Storage, la página de detalles del volumen o desde la página de detalles de la instancia.

Conexión de un volumen a una instancia desde la lista de volúmenes

En la lista de todos los volúmenes de Block Storage for VPC, sigue estos pasos.

  1. En la IBM Cloud consola, haga clic en el icono Menú de navegación icono del menú >Infraestructura icono VPC >Almacenamiento > Block Storage.
  2. En la lista de volúmenes, identifique un volumen disponible sin adjuntar y pulse el icono Acciones icono Acciones al final de una fila.
  3. Seleccione Conectar a instancia.
  4. Selecciona una instancia de servidor virtual de la lista de instancias disponibles y, a continuación, haz clic en Guardar. Si la lista no muestra ninguna instancia de servidor virtual, pulse Crear servidor para ir a la página suministro de instancias.
  5. Se muestran mensajes en la página de detalles del volumen que indican que el volumen se está conectando a la imagen. Cuando termina el proceso, el nombre de la imagen aparece bajo Instancias conectadas.

Cuando creas una instancia de « Hyper Protect Virtual Servers » y el contrato hace referencia a volúmenes, dispones de 15 minutos tras la creación de la instancia para asociar un volumen de datos. Si no lo hace, la instancia pasa a un estado de conclusión después de la ventana de 15 minutos.

Conexión de un volumen a una instancia desde la página de detalles de volumen

En la página de detalles de volumen, siga estos pasos:

  1. Seleccione un volumen no conectado en la lista de volúmenes de Block Storage.
  2. En la página de detalles de volumen, en el mosaico Instancias de servidor virtual, pulse Conectar.
  3. En el panel lateral, seleccione una instancia de servidor virtual y pulse Guardar. Si la lista no muestra ninguna instancia de servidor virtual, pulse Crear servidor para ir a la página suministro de instancias. El volumen de arranque o de datos se muestra en la página de suministro de instancias en sus campos respectivos.
  4. Los mensajes muestran que el volumen se está adjuntando a la imagen. Cuando termina el proceso, el nombre de la imagen aparece bajo Instancias conectadas.

Conexión de un volumen a una instancia desde la página de detalles de la instancia

Adjunte un volumen Block Storage for VPC desde la página de detalles de la instancia de servidor virtual.

  1. En la IBM Cloud consola, haga clic en el icono Menú de navegación icono del menú >Infraestructura icono VPC >Computación >Instancias de servidor virtual.
  2. Seleccione una instancia en la lista de todas las instancias de servidor virtual. Si hay algún volumen Block Storage for VPC conectado, se listan en Volúmenes de almacenamiento.
  3. Seleccione Conectar volumen.
  4. Seleccione un volumen en la lista de recursos disponibles y pulse Conectar. Se muestran mensajes en la página de detalles de la instancia que indican que el volumen se está conectando. Una vez finalizado el proceso, la lista de volúmenes de almacenamiento se actualiza para incluir el nuevo volumen.

Cómo conectar un volumen de Block Storage for VPC a una instancia de servidor virtual desde la CLI

Sigue estas instrucciones para utilizar la CLI y conectar un volumen de Block Storage for VPC a una instancia de servidor virtual. Cada instancia puede tener muchas conexiones de volúmenes, pero solo una conexión de volumen se conecta a una instancia.

Antes de empezar

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.

Inicie la 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. Después de una autenticación correcta, se le solicitará que elija su cuenta. Si tiene acceso a varias cuentas, seleccione la cuenta con la que desea iniciar sesión. Responda a cualquier solicitud restante para finalizar el inicio de sesión.

Conexión de un volumen de Block Storage for VPC desde la CLI

Para conectar un volumen a una instancia de servidor virtual en el grupo de recursos actual, ejecute este mandato.

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

NAME es el nombre que proporciona para la conexión de volumen e INSTANCE_ID es el ID de la instancia de servidor virtual. El valor de VOLUME_ID especifica el volumen que está conectando. Si desea que el volumen se suprima automáticamente cuando se suprima la instancia de servidor virtual, especifique --auto-delete true.

Para ver una lista de las instancias de servidor virtual disponibles, ejecuta el ibmcloud is instances comando. Echa un vistazo al siguiente ejemplo.

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

A continuación, seleccione la instancia de servidor virtual que está en la misma zona que el volumen que desea conectar.

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 obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is instance-volume-attachment-add.

Visualización de los detalles de un volumen que está conectado a una instancia de servidor virtual

Una vez que haya conectado un volumen, puede visualizar los detalles especificando el ID o el nombre de la instancia y el ID o el nombre de la conexión del volumen en el 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 obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is instance-volume-attachment.

Listar todos los adjuntos de volumen de una instancia de servidor

Utilice el comando instance-volume-attachments y especifique el ID o el nombre de la instancia para ver todos los volúmenes asociados a una instancia.

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

Vea el ejemplo siguiente.

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 obtener más información sobre las opciones de mandato disponibles, consulte ibmcloud is instance-volume-attachments.

Creación de un archivo JSON de conexión de volumen

Al aprovisionar una instancia de servidor virtual desde la CLI y crear un volumen de Block Storage for VPC como parte del proceso, puedes especificar un JSON de conexión de volumen. El archivo JSON de asignación de volumen, especificado en el comando o como un archivo, contiene los parámetros del volumen.

En el mandato de CLI que utiliza para crear una instancia, especifique la opción --volume-attach y el archivo JSON de volumen. Por ejemplo, --volume-attach @/Users/myname/myvolume-attachment_create.json.

El ejemplo siguiente muestra el contenido de un archivo JSON de adjunto de volumen que define un volumen personalizado y especifica etiquetas de usuario.

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

Cómo conectar un volumen de Block Storage for VPC a una instancia de servidor virtual mediante la API

Cómo conectar un volumen de Block Storage for VPC a una instancia de servidor virtual mediante la API

Adjunte volúmenes Block Storage for VPC a una instancia de servidor virtual llamando directamente a las API REST.

Crea una conexión de volumen para una instancia con el fin de conectar un volumen de Block Storage for VPC. Realice una solicitud POST /instances y especifique volume_attachments.

POST/instances/{instance_id}/volume_attachments

El siguiente ejemplo crea una conexión de volumen y especifica el volumen por su 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"}
    }'

Una respuesta satisfactoria indica que el volumen está conectado.

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

Próximos pasos

Cree más volúmenes y gestione los existentes. Consulte la siguiente información.