Collegamento di un volume Block Storage for VPC

Collegare i volumi di dati di tipo block storage di IBM Cloud alle istanze dei server virtuali per ottenere capacità di archiviazione aggiuntiva utilizzando la console, la CLI, l'API o Terraform.

Limiti di collegamento del volume

Puoi collegare solo un volume di avvio Block Storage for VPC a un'istanza del server virtuale alla volta, ma puoi collegare fino a 12 volumi di dati Block Storage for VPC a una singola istanza.

Quando si crea un'istanza di Hyper Protect Virtual Servers per IBM Cloud® Virtual Private Cloud, al momento è possibile aggiungere un solo volume di dati. Anche se si collegano più volumi, questi non vengono utilizzati dall'istanza.

Non puoi utilizzare l'IU per collegare i volumi Block Storage for VPC ai nodi di lavoro del cluster IBM Cloud® Kubernetes Service. Per ulteriori informazioni sull'utilizzo della CLI per collegare i volumi ai nodi cluster, vedi Memorizzazione dei dati su Block Storage for VPC.

Collegamento di un volume di tipo “ Block Storage for VPC ” a un’istanza di server virtuale

Puoi collegare un volume a un'istanza del server virtuale dall'elenco di volumi Block Storage, dalla pagina dei dettagli del volume o dalla pagina dei dettagli dell'istanza.

Collegamento di un volume a un'istanza dall'elenco di volumi

Dall'elenco di tutti i volumi di " Block Storage for VPC ", segui questi passaggi.

  1. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC > Archiviazione > Block Storage volumi.
  2. Nell'elenco di volumi, identificare un volume disponibile non collegato e fare clic sull'icona Azioni icona Azioni alla fine di una riga.
  3. Seleziona Collega a istanza.
  4. Selezionare un'istanza di server virtuale dall'elenco delle istanze disponibili, quindi fare clic su Salva. Se l'elenco non mostra alcuna istanza del server virtuale, fare clic su Crea server per passare alla pagina provisioning dell'istanza.
  5. Vengono visualizzati dei messaggi nella pagina dei dettagli del volume per indicare che si sta collegando il volume all'immagine. Una volta completato, il nome dell'immagine viene visualizzato in Istanze collegate.

Quando si crea un'istanza di Hyper Protect Virtual Servers e il contratto fa riferimento ai volumi, si hanno 15 minuti di tempo dalla creazione dell'istanza per collegare un volume di dati. In caso contrario, l'istanza viene chiusa dopo una finestra di 15 minuti.

Collegamento di un volume a una istanza dalla pagina dei dettagli del volume

Dalla pagina dei dettagli del volume, seguire queste istruzioni:

  1. Seleziona un volume non collegato dall'elenco di volumi Block Storage.
  2. Dalla pagina dei dettagli del volume, nel tile Virtual server instances, fai clic su Attach.
  3. Dal pannello laterale, seleziona un'istanza del server virtuale e fai clic su Salva. Se l'elenco non mostra alcuna istanza del server virtuale, fare clic su Crea server per passare alla pagina provisioning dell'istanza. Il volume di avvio o di dati viene visualizzato nella pagina di provisioning dell'istanza nei rispettivi campi.
  4. I messaggi indicano che il volume è collegato all'immagine. Una volta completato, il nome dell'immagine viene visualizzato in Istanze collegate.

Collegamento di un volume a un'istanza dalla pagina dei dettagli dell'istanza

Collega un volume Block Storage for VPC dalla pagina dei dettagli dell'istanza del server virtuale.

  1. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC > Calcolo > Istanze server virtuali.
  2. Seleziona un'istanza dall'elenco di tutte le VSI (virtual server instance). Se sono collegati Block Storage for VPC volumi, vengono elencati in Volumi di archiviazione.
  3. Seleziona Collega volume.
  4. Seleziona un volume dall'elenco di risorse disponibili e fai clic su Collega. Vengono visualizzati dei messaggi nella pagina dei dettagli dell'istanza per indicare che si sta collegando il volume. Al termine dell'operazione, l'elenco dei volumi di archiviazione viene aggiornato per includere il nuovo volume.

Collegamento di un volume " Block Storage for VPC " a un'istanza di server virtuale tramite la CLI

Attieniti alle seguenti istruzioni per utilizzare la CLI per collegare un volume Block Storage for VPC a un'istanza del server virtuale. Ogni istanza può avere molti collegamenti di volumi, ma un singolo collegamento di volumi connette un volume a un'istanza.

Prima di iniziare

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

Accedi al sito 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. Dopo una corretta autenticazione, ti viene richiesto di scegliere il tuo account. Se hai accesso a più account, seleziona quello con cui desideri effettuare l'accesso. Rispondi alle richieste rimanenti per completare l'accesso.

Collegamento di un volume Block Storage for VPC dalla CLI

Per collegare un volume a una VSI (virtual server instance) nel gruppo di risorse corrente, esegui questo comando.

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

NAME è il nome che si assegna al volume collegato, mentre INSTANCE_ID è l'ID dell'istanza del server virtuale. Il VOLUME_IDspecifica il volume che stai collegando. Se si desidera che il volume venga eliminato automaticamente quando viene eliminata l'istanza del server virtuale, specificare --auto-delete true.

Per visualizzare l'elenco delle istanze di server virtuali disponibili, eseguire il comando ibmcloud is instances``. Controlla il seguente esempio.

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

Quindi, selezionare l'istanza del server virtuale nella stessa zona del volume che si desidera collegare.

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

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is instance-volume-attachment-add.

Mostra i dettagli di un volume collegato a una VSI (virtual server instance)

Dopo aver collegato un volume, è possibile visualizzarne i dettagli specificando l'ID o il nome dell'istanza e l'ID o il nome del collegamento del volume nel 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

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is instance-volume-attachment.

Elenca tutti i collegamenti di volumi di un'istanza del server

Utilizza il comando instance-volume-attachments e specifica l'ID o il nome dell'istanza per visualizzare tutti i volumi associati a un'istanza.

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

Vedi il seguente esempio.

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

Per ulteriori informazioni relative alle opzioni di comando disponibili, consultare ibmcloud is instance-volume-attachments.

Crea un JSON di collegamenti volumi

Quando si configura un'istanza di server virtuale tramite la CLI e, nell'ambito di tale processo, si crea un volume di tipo " Block Storage for VPC ", è possibile specificare un file JSON relativo al collegamento del volume. Il file JSON di configurazione del volume, specificato nel comando o come file, contiene i parametri del volume.

Nel comando della CLI che utilizzi per creare un'istanza, specifichi l'opzione --volume-attach e il file JSON del volume. Ad esempio, --volume-attach @/Users/myname/myvolume-attachment_create.json.

Il seguente esempio mostra il contenuto di un file JSON di collegamento del volume che definisce un volume personalizzato e specifica le tag utente.

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

Collegamento di un volume " Block Storage for VPC " a un'istanza di server virtuale tramite l'API

Collegamento di un volume " Block Storage for VPC " a un'istanza di server virtuale tramite l'API

Collegare i volumi " Block Storage for VPC " a un'istanza di server virtuale richiamando direttamente le API REST.

Crea un collegamento volume per un'istanza per collegare un volume Block Storage for VPC. Effettua una richiesta di tipo “ POST /instances ” e specifica volume_attachments.

POST/instances/{instance_id}/volume_attachments

Il seguente esempio crea un allegato di volume e specifica il volume in base all'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 risposta positiva indica che il volume è collegato.

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

Passi successivi

Crea più volumi e gestisci quelli esistenti. Vedi le seguenti informazioni.