Block Storage for VPC-Volume anhängen

Binden Sie „ IBM Cloud “-Blockspeicher-Datenvolumes über die Konsole, die CLI, die API oder Terraform an virtuelle Serverinstanzen an, um zusätzliche Speicherkapazität zu erhalten.

Einschränkungen bei der Datenträgerzuordnung

Sie können jeweils nur ein Block Storage for VPC-Boot-Volume an eine virtuelle Serverinstanz anhängen, jedoch bis zu 12 Block Storage for VPC-Datenvolumes an eine einzelne Instanz.

Wenn Sie eine Instanz von „ Hyper Protect Virtual Servers “ für „ IBM Cloud® Virtual Private Cloud “ erstellen, kann derzeit nur ein Datenvolume hinzugefügt werden. Selbst wenn Sie weitere Datenträger zuordnen, werden diese nicht von der Instanz verwendet.

Block Storage for VPC-Volumes können nicht über die Benutzeroberfläche an Worker-Knoten eines IBM Cloud® Kubernetes Service-Clusters angehängt werden. Weitere Informationen zur Verwendung der CLI zum Anhängen von Volumes an Clusterknoten finden Sie unter Speichern von Daten auf Block Storage for VPC.

Ein Block Storage for VPC-Volume an eine virtuelle Serverinstanz anhängen

Sie können einen Datenträger über die Liste der Block Storage-Datenträger, die Seite mit den Datenträgerdetails oder über die Seite mit den Instanzdetails einer virtuellen Serverinstanz zuordnen.

Datenträger aus der Liste der Datenträger an eine Instanz anhängen

Befolgen Sie diese Schritte aus der Liste aller Block Storage for VPC-Bände.

  1. Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation Menü-Symbol > Infrastruktur VPC-Symbol > Speicher > Block Storage Volumen.
  2. Geben Sie in der Liste der Datenträger einen verfügbaren, nicht angehängten Datenträger an und klicken Sie auf das Symbol Aktionen Aktionssymbol am Ende einer Zeile.
  3. Wählen Sie Zu Instanz zuordnen aus.
  4. Wählen Sie eine virtuelle Serverinstanz aus der Liste der verfügbaren Instanzen aus und klicken Sie anschließend auf Speichern. Wenn in der Liste keine virtuellen Serverinstanzen angezeigt werden, klicken Sie auf Server erstellen, um die Seite Instanzbereitstellung aufzurufen.
  5. Auf der Seite mit den Datenträgerdetails werden Nachrichten angezeigt, in denen Sie darüber informiert werden, dass der Datenträger dem Image zugeordnet wird. Nach Abschluss dieses Vorgangs wird unter Zugeordnete Instanzen der Name des Images angezeigt.

Wenn Sie eine „ Hyper Protect Virtual Servers “-Instanz erstellen und der Vertrag Datenträger vorsieht, haben Sie nach der Erstellung der Instanz 15 Minuten Zeit, um einen Datenträger anzuschließen. Ist dies nicht der Fall, wird die Instanz nach dem 15 -minütigen Fenster in den Status 'Herunterfahren' versetzt.

Datenträger über die Seite 'Datenträgerdetails' einer Instanz zuordnen

Führen Sie auf der Seite mit den Datenträgerdetails die folgenden Schritte aus:

  1. Wählen Sie einen nicht zugeordneten Datenträger in der Liste der Block Storage datenträger aus.
  2. Klicken Sie auf der Seite 'Datenträgerdetails' auf der Kachel Virtuelle Serverinstanzen auf Zuordnen.
  3. Wählen Sie in der seitlichen Anzeige eine virtuelle Serverinstanz aus und klicken Sie auf Speichern. Wenn in der Liste keine virtuellen Serverinstanzen angezeigt werden, klicken Sie auf Server erstellen, um die Seite Instanzbereitstellung aufzurufen. Der Boot-oder Datendatenträger wird auf der Instanzbereitstellungsseite in den entsprechenden Feldern angezeigt.
  4. Nachrichten zeigen an, dass der Datenträger an das Image angehängt wird. Nach Abschluss dieses Vorgangs wird unter Zugeordnete Instanzen der Name des Images angezeigt.

Datenträger über die Seite 'Instanzdetails' einer Instanz zuordnen

Hängen Sie einen Block Storage for VPC-Datenträger über die Detailseite der virtuellen Serverinstanz an.

  1. Klicken Sie im Feld IBM Cloud Konsole auf das Symbol Menü Navigation Menü-Symbol > Infrastruktur VPC-Symbol > Rechenleistung > Virtuelle Serverinstanzen.
  2. Wählen Sie in der Liste aller Virtual Server-Instanzen die gewünschte Instanz aus. Wenn Block Storage for VPC-Datenträger zugeordnet sind, werden sie unter Speicherdatenträger aufgeführt.
  3. Wählen Sie Datenträger zuordnen aus.
  4. Wählen Sie in der Liste der verfügbaren Ressourcen den gewünschten Datenträger aus und klicken Sie dann auf Zuordnen. Auf der Seite mit den Instanzdetails werden Nachrichten angezeigt, in denen Sie darüber informiert werden, dass der Datenträger zugeordnet wird. Nach Abschluss des Vorgangs wird die Liste der Speichervolumes aktualisiert und um das neue Volume erweitert.

Anbinden eines Block Storage for VPC-Volumes an eine virtuelle Serverinstanz über die Befehlszeilenschnittstelle (CLI)

Befolgen Sie diese Anweisungen, um mithilfe der CLI ein Block Storage for VPC-Volume an eine virtuelle Serverinstanz anzuhängen. Jede Instanz kann über mehrere Datenträgerzuordnungen verfügen, eine einzelne Datenträgerzuordnung stellt aber eine Verbindung zwischen einem Datenträger und einer Instanz her.

Vorbereitende Schritte

Bevor Sie die Befehlszeilenschnittstelle (CLI) verwenden können, müssen Sie die IBM Cloud-CLI und das VPC-CLI-Plug-in installieren. Weitere Informationen finden Sie unter CLI-Voraussetzungen.

Melden Sie sich bei IBM Cloud an.

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

Mit diesem Befehl wird eine URL zurückgegeben und die Eingabe eines Kenncodes angefordert. Rufen Sie diese URL im Browser auf und melden Sie sich an. Wenn dieser Vorgang erfolgreich ausgeführt werden kann, dann erhalten Sie einen Einmalkenncode. Kopieren Sie diesen Kenncode und fügen Sie ihn als Antwort auf die Eingabeaufforderung ein. Nach erfolgreicher Authentifizierung werden Sie aufgefordert, Ihren Account auszuwählen. Wenn Sie Zugriff auf mehrere Konten haben, wählen Sie das Konto aus, mit dem Sie sich anmelden möchten. Antworten Sie auf alle verbleibenden Eingabeaufforderungen, um die Anmeldung abzuschließen.

Ein Block Storage for VPC-Volume über die CLI einbinden

Um einen Datenträger einer Virtual Server-Instanz in der aktuellen Ressourcengruppe zuzuordnen, müssen Sie den folgenden Befehl ausführen.

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

NAME ist der Name, den Sie für die Datenträgerzuordnung angegeben haben. INSTANCE_ID ist die ID der virtuellen Serverinstanz. In VOLUME_ID wird der Datenträger angegeben, den Sie zuordnen. Soll der Datenträger automatisch gelöscht werden, wenn die virtuelle Serverinstanz gelöscht wird, geben Sie --auto-delete true an.

Um eine Liste der verfügbaren virtuellen Serverinstanzen anzuzeigen, führen Sie den ibmcloud is instances Befehl aus. Sehen Sie sich das folgende Beispiel an.

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

Wählen Sie anschließend die virtuelle Serverinstanz aus, die sich in derselben Zone wie der Datenträger befindet, den Sie zuordnen wollen.

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

Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter ibmcloud is instance-volume-attachment-add.

Details eines Datenträgers anzeigen, der einer Virtual Server-Instanz zugeordnet ist

Nachdem Sie ein Volume angehängt haben, können Sie Details anzeigen, indem Sie die Instanz-ID oder den Instanznamen sowie die Volume-Anhang-ID oder den Volume-Anhangnamen im Befehl instance-volume-attachment angeben.

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

Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter ibmcloud is instance-volume-attachment.

Alle Datenträgerzuordnungen einer Serverinstanz auflisten

Verwenden Sie den Befehl instance-volume-attachments und geben Sie die Instanz-ID oder den Namen an, um alle Volume-Zuordnungen für eine Instanz anzuzeigen.

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

Beispiel:

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

Weitere Informationen zu verfügbaren Befehlsoptionen finden Sie unter ibmcloud is instance-volume-attachments.

JSON-Datei für Datenträgerzuordnung erstellen

Wenn Sie eine virtuelle Serverinstanz über die CLI bereitstellen und im Rahmen dieses Vorgangs ein Block Storage for VPC-Volume erstellen, können Sie eine JSON-Datei für die Volume-Zuordnung angeben. Die JSON-Datei zur Volume-Anbindung, die im Befehl oder als Datei angegeben wird, enthält die Volume-Parameter.

Im CLI-Befehl, mit dem Sie eine Instanz erstellen, geben Sie die Option --volume-attach und die JSON-Datei des Datenträgers an. Zum Beispiel --volume-attach @/Users/myname/myvolume-attachment_create.json.

Das folgende Beispiel zeigt den Inhalt einer JSON-Datei für Datenträgeranhänge, die einen angepassten Datenträger definiert und Benutzertags angibt.

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

Block Storage for VPC-Volume über die API an eine virtuelle Serverinstanz anhängen

Block Storage for VPC-Volume über die API an eine virtuelle Serverinstanz anhängen

Hängen Sie Block Storage for VPC-Volumes durch direkten Aufruf der REST-APIs an eine virtuelle Serverinstanz an.

Erstellen Sie eine Volume-Zuordnung für eine Instanz, um ein Block Storage for VPC-Volume zuzuordnen. Stellen Sie eine Anfrage POST /instances und geben Sie … an volume_attachments.

POST/instances/{instance_id}/volume_attachments

Im folgenden Beispiel wird eine Volume-Zuordnung erstellt und das Volume anhand seiner ID angegeben.

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

Eine Antwort für die erfolgreiche Ausführung gibt an, dass der Datenträger zugeordnet wurde.

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

Nächste Schritte

Erstellen Sie weitere Datenträger und verwalten Sie die bereits vorhandenen Datenträger. Siehe hierzu die folgenden Informationen.