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를 사용하여 클러스터 노드에 볼륨을 연결하는 방법에 대한 자세한 내용은 “ Block Storage for VPC 에 데이터 저장”을 참조하십시오.
Block Storage for VPC 볼륨을 가상 서버 인스턴스에 연결하기
Block Storage 볼륨 목록, 볼륨 세부사항 페이지 또는 인스턴스 세부사항 페이지에서 가상 서버 인스턴스에 볼륨을 첨부할 수 있습니다.
볼륨 목록에서 인스턴스에 볼륨 첨부
Block Storage for VPC 의 모든 권 목록에서 다음 단계를 따르십시오.
- IBM Cloud 콘솔에서 탐색 메뉴 아이콘
> 인프라
> 스토리지> Block Storage 볼륨을 클릭합니다.
- 볼륨 목록에서 사용 가능한 연결되지 않은 볼륨을 식별하고 행 끝에 있는 조치 아이콘
를 클릭하십시오.
- 인스턴스에 연결을 선택하십시오.
- 사용 가능한 인스턴스 목록에서 가상 서버 인스턴스를 선택한 다음, ‘저장’을 클릭합니다. 목록에 가상 서버 인스턴스가 표시되지 않으면 서버 작성 을 클릭하여 인스턴스 프로비저닝 페이지로 이동하십시오.
- 볼륨이 이미지에 연결되고 있음을 표시하기 위해 볼륨 세부사항 페이지에 메시지가 표시됩니다. 완료되면 이미지 이름이 연결된 인스턴스 아래에 표시됩니다.
Hyper Protect Virtual Servers 인스턴스를 생성할 때 계약서에 볼륨에 대한 내용이 명시되어 있다면, 인스턴스 생성 후 15분 이내에 데이터 볼륨을 연결해야 합니다. 이 작업을 수행하지 않으면 15분창 이후에 인스턴스가 종료 상태가 됩니다.
볼륨 세부사항 페이지에서 인스턴스에 볼륨 첨부
볼륨 세부사항 페이지에서 다음 단계를 수행하십시오.
- Block Storage 볼륨 목록 에서 연결되지 않은 볼륨을 선택하십시오.
- 볼륨 세부사항 페이지의 가상 서버 인스턴스 타일에서 첨부를 클릭하십시오.
- 측면 패널에서 가상 서버 인스턴스를 선택하고 저장을 클릭하십시오. 목록에 가상 서버 인스턴스가 표시되지 않으면 서버 작성 을 클릭하여 인스턴스 프로비저닝 페이지로 이동하십시오. 부트 또는 데이터 볼륨은 인스턴스 프로비저닝 페이지의 각 필드에 표시됩니다.
- 메시지는 볼륨이 이미지에 첨부되고 있음을 표시합니다. 완료되면 이미지 이름이 연결된 인스턴스 아래에 표시됩니다.
인스턴스 세부사항 페이지에서 인스턴스에 볼륨 첨부
가상 서버 인스턴스 세부사항 페이지에서 Block Storage for VPC 볼륨을 연결하십시오.
- IBM Cloud 콘솔에서 탐색 메뉴 아이콘
인프라 > 인프라
> 컴퓨팅 > 가상 서버 인스턴스을 클릭합니다.
- 모든 가상 서버 인스턴스 목록에서 인스턴스를 선택하십시오. Block Storage for VPC 볼륨이 연결된 경우 스토리지 볼륨아래에 나열됩니다.
- 볼륨 연결을 선택하십시오.
- 사용 가능한 리소스 목록에서 볼륨을 선택하고 연결을 클릭하십시오. 볼륨이 연결되고 있음을 표시하기 위해 인스턴스 세부사항 페이지에 메시지가 표시됩니다. 작업이 완료되면 ‘스토리지 볼륨 ’ 목록이 업데이트되어 새로운 볼륨이 포함됩니다.
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
다음 예제에서는 볼륨 연결을 생성하고 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"}
}'
성공적인 응답은 볼륨이 연결되었음을 표시합니다.
{
"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"
}
}
다음 단계
추가 볼륨을 작성하고 기존 볼륨을 관리하십시오. 다음 정보를 참조하십시오.