Skip to content

Commit a4d0157

Browse files
author
Joseph Palermo
authored
Merge pull request #824 from cloudfoundry/vsphere-expand-root-disk
vSphere CPI: document new root_disk_size_gb property
2 parents f1d5976 + d554f6e commit a4d0157

File tree

1 file changed

+10
-0
lines changed

1 file changed

+10
-0
lines changed

content/vsphere-cpi.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -104,6 +104,7 @@ Schema for `cloud_properties` section:
104104
* **port** [Integer, optional]: The port that the VM's service is listening on (e.g. 80 for HTTP). If port is specified, all connections will be sent to this port on the VM. Only specify a single port (no ranges). If unset, the load balancer will connect the client to the VM using the same port number (e.g. if the client connects to port 443, the load balancer will forward to the VM on port 443).
105105
- **pci_passthroughs** [Array, optional]: Specifies a PCI (Peripheral Component Interconnect) device to attach to VM via vSphere Dynamic DirectPath IO. Requires vSphere 7.0+. Automatically sets the properties `memory_reservation_locked_to_max` and `upgrade_hw_version` to `true`. Each entry requires the PCI card's `device_id` and `vendor_id`. Available in v97+.
106106
- **vgpus** [Array, optional]: Specifies an Nvidia GRID vGPU to attach to VM. Automatically sets the properties `memory_reservation_locked_to_max` and `upgrade_hw_version` to `true`. Available in v97+.
107+
- **root_disk_size_gb** [Integer, optional]: Expands the root disk to the size specified (in GiB). Useful when files such as Nvidia CUDA libraries can only be placed on the system disk instead of the ephemeral disk. Note that setting this property uses slightly more datastore space than expected, for non-expanded system disks are vSphere linked clones, which means the datastore footprint is close to zero. Available in v97.0.6+.
107108

108109
Example of a VM asked to be placed into a specific vSphere resource pool with NSX-V and NSX-T integration:
109110

@@ -187,6 +188,15 @@ vm_extensions:
187188
- grid_t4-16q
188189
```
189190
191+
Example of expanding the root disk of a VM to 20 GB:
192+
193+
```yaml
194+
vm_extensions:
195+
- name: 20G_root
196+
cloud_properties:
197+
root_disk_size_gb: 20
198+
```
199+
190200
---
191201
## Disk Types {: #disk-pools }
192202

0 commit comments

Comments
 (0)