挂载 Block Storage for VPC 卷

使用控制台、CLI、API 或 Terraform，将 IBM Cloud 块存储数据卷挂载到虚拟服务器实例上，以获得额外的存储容量。

卷连接限制

一次只能将一个 Block Storage for VPC 引导卷连接到虚拟服务器实例，但最多可以将 12 个 Block Storage for VPC 数据卷连接到单个实例。

当您为 IBM Cloud® Virtual Private Cloud 实例创建一个 Hyper Protect Virtual Servers 时，目前只能添加一个数据卷。 即使附加了更多卷，实例也不会使用这些卷。

无法使用 UI 将 Block Storage for VPC 卷连接到 IBM Cloud® Kubernetes Service 集群工作程序节点。 有关使用 CLI 将卷连接到集群节点的更多信息，请参阅 Storing data on Block Storage for VPC。

将 Block Storage for VPC 卷连接到虚拟服务器实例

可以从 Block Storage 卷列表，卷详细信息页面或实例详细信息页面将卷连接到虚拟服务器实例。

从卷列表将卷连接到实例

在所有 Block Storage for VPC 卷的列表中，请按照以下步骤操作。

  1. 在 IBM Cloud 控制台，单击 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 存储 > Block Storage 卷。
  2. 在卷列表中，标识可用的未连接卷，然后单击行尾的 操作 图标 "操作" 图标。
  3. 选择连接到实例。
  4. 从可用实例列表中选择一个虚拟服务器实例，然后单击 “保存”。 如果列表未显示任何虚拟服务器实例，请单击 创建服务器 以转至“实例供应”页面。
  5. 这将在卷详细信息页面上显示消息，指示卷正在连接到映像。 完成后，映像名称将显示在连接的实例下。

当您创建一个 Hyper Protect Virtual Servers 实例且合约中提及卷时，您必须在实例创建后的15分钟内挂载数据卷。 未能执行此操作将导致实例在 15 分钟窗口后进入关闭状态。

从卷详细信息页面将卷连接到实例

从“卷详细信息”页面中，执行以下步骤:

  1. 从 Block Storage 卷列表 中选择未连接的卷。
  2. 在“卷详细信息”页面的“虚拟服务器实例”磁贴中，单击 连接。
  3. 在侧面板上，选择虚拟服务器实例，然后单击 保存。 如果列表未显示任何虚拟服务器实例，请单击 创建服务器 以转至“实例供应”页面。 引导或数据卷显示在实例供应页面上的各自字段中。
  4. 消息显示卷正在连接到映像。 完成后，映像名称将显示在连接的实例下。

从实例详细信息页面将卷附加到实例

从虚拟服务器实例详细信息页面附加 Block Storage for VPC 卷。

  1. 在 IBM Cloud 控制台，单击 导航菜单 图标 菜单图标 > 基础架构 VPC 图标 > 计算 > 虚拟服务器实例。
  2. 从所有虚拟服务器实例的列表中选择实例。 如果连接了任何 Block Storage for VPC 卷，那么会在 存储卷下列出这些卷。
  3. 选择连接卷。
  4. 从可用资源列表中选择卷，然后单击连接。 这将在实例详细信息页面上显示消息，指示正在连接卷。 完成后 ，“存储卷”列表将更新，并包含该新卷。

通过命令行界面（CLI）将 Block Storage for VPC 卷挂载到虚拟服务器实例上

遵循以下指示信息以使用 CLI 将 Block Storage for VPC 卷连接到虚拟服务器实例。 每个实例可以具有多个卷连接，但单个卷连接只能将一个卷连接到一个实例。

准备工作

在使用 CLI 之前，您必须先安装 IBM Cloud CLI 以及 VPC CLI 插件。 有关更多信息，请参阅 CLI 先决条件。

登录 IBM Cloud。

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

此命令会返回 URL 并提示输入密码。 在浏览器中转至该 URL 并登录。 如果成功，您将获得一次性密码。 复制此密码并将其作为响应粘贴到提示上。 成功认证后，系统会提示您选择帐户。 如果您拥有多个账户，请选择您要登录的账户。 响应任何剩余提示以完成登录。

从 CLI 连接 Block Storage for VPC 卷

要将卷连接到当前资源组中的虚拟服务器实例，请运行以下命令。

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

NAME 是您为卷挂载指定的名称，而 INSTANCE_ID 是虚拟服务器实例的 ID。 VOLUME_ID 指定要连接的卷。 如果要在删除虚拟服务器实例时自动删除卷，请指定 --auto-delete true。

要查看可用的虚拟服务器实例列表，请运行 ibmcloud is instances 命令。 请查看以下示例。

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

然后，选择与要连接的卷位于同一区域中的虚拟服务器实例。

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

有关可用命令选项的更多信息，请参阅 ibmcloud is instance-volume-attachment-add。

显示连接到虚拟服务器实例的卷的详细信息

挂载卷后，您可以在 instance-volume-attachment 命令中指定实例ID或名称以及卷挂载ID或名称，以查看详细信息。

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

有关可用命令选项的更多信息，请参阅 ibmcloud is instance-volume-attachment。

列出服务器实例的所有卷连接

使用 instance-volume-attachments 命令并指定实例ID或名称，即可查看该实例的所有卷关联信息。

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

请参阅以下示例。

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

有关可用命令选项的更多信息，请参阅 ibmcloud is instance-volume-attachments。

创建卷连接 JSON

当您通过命令行界面（CLI）配置虚拟服务器实例，并在该过程中创建 Block Storage for VPC 卷时，可以指定卷挂载的JSON配置。 在命令中指定或作为文件提供的卷附加 JSON 文件包含卷参数。

在用于 创建实例 的 CLI 命令中，指定 --volume-attach 选项和卷 JSON 文件。 例如，--volume-attach @/Users/myname/myvolume-attachment_create.json。

以下示例显示定义定制卷并指定用户标记的卷附件 JSON 文件的内容。

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

使用 API 将 Block Storage for VPC 卷挂载到虚拟服务器实例上

使用 API 将 Block Storage for VPC 卷挂载到虚拟服务器实例上

通过直接调用 REST API，将 Block Storage for VPC 卷挂载到虚拟服务器实例上。

为实例创建卷连接以连接 Block Storage for VPC 卷。 发送一个 POST /instances 请求，并指定 volume_attachments。

POST/instances/{instance_id}/volume_attachments

以下示例创建卷连接并按标识指定卷。

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

成功响应指示卷已连接。

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

后续步骤

创建更多卷并管理现有卷。 请参阅以下信息。