Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/cloudfoundry/bosh-vsphere-cpi-release
BOSH vSphere CPI
https://github.com/cloudfoundry/bosh-vsphere-cpi-release
bosh-release bosh-vsphere-cpi cpi vcenter vsphere
Last synced: 1 day ago
JSON representation
BOSH vSphere CPI
- Host: GitHub
- URL: https://github.com/cloudfoundry/bosh-vsphere-cpi-release
- Owner: cloudfoundry
- License: apache-2.0
- Created: 2015-04-01T17:21:21.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2025-01-16T22:52:31.000Z (1 day ago)
- Last Synced: 2025-01-16T23:29:28.086Z (1 day ago)
- Topics: bosh-release, bosh-vsphere-cpi, cpi, vcenter, vsphere
- Language: Ruby
- Homepage:
- Size: 186 MB
- Stars: 32
- Watchers: 39
- Forks: 36
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Authors: AUTHORS.md
Awesome Lists containing this project
README
# BOSH vSphere CPI Release
The `vsphere` CPI can be used with [VMware vSphere](https://www.vmware.com/products/vsphere.html).
* Documentation: [bosh.io/docs](https://bosh.io/docs) and [bosh.io/docs/vsphere-cpi](https://bosh.io/docs/vsphere-cpi.html)
* Slack: #bosh on
* Release: [cloudfoundry/bosh-vsphere-cpi-release](https://github.com/cloudfoundry/bosh-vsphere-cpi-release)
* Issues: [GitHub Issues](https://github.com/cloudfoundry/bosh-vsphere-cpi-release/issues)
* Mailing list: [cf-bosh](https://lists.cloudfoundry.org/pipermail/cf-bosh)This is a BOSH release for the vSphere CPI.
See [Initializing a BOSH environment on vSphere](https://bosh.io/docs/init-vsphere.html) for example usage.
## Development
See [development doc](docs/development.md).
See [vSphere API Docs](http://pubs.vmware.com/vsphere-60/topic/com.vmware.wssdk.apiref.doc/right-pane.html).
## Requirements
An environment running one of the following supported releases:
* [vSphere 6.5](https://docs.vmware.com/en/VMware-vSphere/6.5/rn/vsphere-esxi-vcenter-server-65-release-notes.html)
* [vSphere 6.7](https://docs.vmware.com/en/VMware-vSphere/6.7/rn/vsphere-esxi-vcenter-server-67-release-notes.html)
* [vSphere 7.0](https://docs.vmware.com/en/VMware-vSphere/7.0/rn/vsphere-esxi-vcenter-server-70-release-notes.html)
* [vSphere 8.0](https://docs.vmware.com/en/VMware-vSphere/8.0/rn/vsphere-vcenter-server-80a-release-notes/index.html)NSX Support:
* [NSX-V](https://docs.vmware.com/en/VMware-NSX-for-vSphere/index.html) (not actively tested)
* [NSX-T 2.5](https://docs.vmware.com/en/VMware-NSX-T-Data-Center/2.5.3/rn/VMware-NSX-T-Data-Center-253-Release-Notes.html)
* [NSX-T 3.0](https://docs.vmware.com/en/VMware-NSX-T-Data-Center/3.0/rn/VMware-NSX-T-Data-Center-303-Release-Notes.html)
* [NSX-T 3.1](https://docs.vmware.com/en/VMware-NSX-T-Data-Center/3.1/rn/VMware-NSX-T-Data-Center-3121-Release-Notes.html)
* [NSX-T 4](https://docs.vmware.com/en/VMware-NSX/4.0.1.1/rn/vmware-nsx-4011-release-notes/index.html)
* [NSX-T 4.1](https://docs.vmware.com/en/VMware-NSX/4.1.2.1/rn/vmware-nsx-4121-release-notes/index.html)## Concepts
The following table maps BOSH concepts to their vSphere-native equivalents.
| BOSH | vSphere |
| ---- | ------- |
| Availability Zone | [Clusters](https://docs.vmware.com/en/VMware-vSphere/6.0/com.vmware.vsphere.monitoring.doc/GUID-A47D16C9-0B07-4DB8-BB79-D67DD97D5194.html?hWord=N4IghgNiBcIMYQK4GcAuBTATskBfIA)/[Resource Pools](https://docs.vmware.com/en/VMware-vSphere/6.0/com.vmware.vsphere.monitoring.doc/GUID-74D23242-B353-4267-8CC3-7800DD9BB92A.html) |
| Virtual Machine | [Virtual Machine](https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.vm_admin.doc/GUID-55238059-912E-411F-A0E9-A7A536972A91.html) |
| VM Config Metadata | Virtual Device ISO |
| Network Subnet | [Networking](https://docs.vmware.com/en/VMware-vSphere/6.0/com.vmware.vsphere.networking.doc/GUID-35B40B0B-0C13-43B2-BC85-18C9C91BE2D4.html) |
| Persistent Disk | [Virtual Hard Disk](https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.vm_admin.doc/GUID-79116E5D-22B3-4E84-86DF-49A8D16E7AF2.html) |
| Stemcell | [Virtual Machine](https://docs.vmware.com/en/VMware-vSphere/6.5/com.vmware.vsphere.vm_admin.doc/GUID-55238059-912E-411F-A0E9-A7A536972A91.html) |## Feature Support
The following sections describe some specific BOSH features supported by the CPI.
### Network
The CPI supports multiple NICs being attached to a single VM.
| Network Type | Support |
| ------------ | ------- |
| Manual | Multiple networks per instance |
| Dynamic | Not Supported |
| VIP | Not Supported |### Encryption
vSphere supports disk encryption and customer-managed keys when managed through policy configuration within the vCenter 6.5+ ([learn more](https://docs.vmware.com/en/VMware-vSphere/6.7/com.vmware.vsphere.security.doc/GUID-A29066CD-8EF8-4A4E-9FC9-8628E05FC859.html)). For this functionality, encryption occurs at the hypervisor level which is transparent to the VM. Once enabled within vCenter, no additional configuration is required for the CPI.
| Disk Type | Encryption |
| --------- | ---------- |
| Root Disk | Supported |
| Ephemeral Disk | Supported |
| Persistent Disk | Supported |### Miscellaneous
| Feature | Support |
| ------- | ------- |
| Multi-CPI | Supported, [v34](https://github.com/cloudfoundry/bosh-vsphere-cpi-release/releases/tag/v34)+ |
| Native Disk Resize | Not Supported |