Awesome

BOSH VCloud Cloud Provider Interface

Introduction

It's a BOSH CPI implementation for a vCloud Director backed infrastructure cloud. In order to target a vCloud Director instance, MicroBosh must be set to use the vCloud plugin configuration as shown below:

---
plugin: vcloud
vcds
  - url:   
    user:      
    password: 
    entities:
	  organization: 
	  virtual_datacenter: 
	  vapp_catalog: 
	  media_catalog:
	  media_storage_profile:
      vm_metadata_key:
	  description:
      control: #optional parameters
        wait_max: #optional parameters

Note that vCloud Director version 5.1 or newer is required.

Parameters

This section explains which parameters are supported in vCloud BOSH CPI.

vCloud related

url (required) The endpoint of the target vCloud Director
user (required) The user name of the target vCloud Director
password (required) The password of the target vCloud Director
organization (required) The organization name
virtual_datacenter (required) The virtual data center name
vapp_catalog (required) The name of the calalog for vapp template
media_catalog (required) The name of the calalog for media files
media_storage_profile (required) The storage profile to use. You can put * here to match all the storage profiles.
vm_metadata_key (required) The key name of VM metadata
description (required) Text associated with the VMs
Control (optional) All the following control parameters are optional
wait_max (optional) Maximum wait seconds for a single CPI task
wait_delay (optional) Delay in seconds for pooling next CPI task status
cookie_timeout (optional) The cookie timeout in seconds
retry_max (optional) Maximum retry times
retry_delay (optional) The delay of first retry, the next is *2

Network related

The network name should be specified under cloud_properties in the networks section of a BOSH deployment manifest. It should be the 'Org VDC Network' you plan to use for deployment.

Example

This is a sample of how vCloud Director specific properties are used in a BOSH deployment manifest:

---
networks:
- name: default 
  subnets:
    - reserved:
    - 192.168.21.129 - 192.168.21.150
    static:
    - 192.168.21.151 - 192.168.21.189
    range: 192.168.21.128/25
    gateway: 192.168.21.253
    dns:
    - 192.168.71.1
    cloud_properties:
      name: "tempest_vdc_network"

...

properties:
  vcd:
    url: https://192.168.10.1
    user: dev
    password: pwd
    entities:
      organization: dev
      virtual_datacenter: vdc
      vapp_catalog: cloudfoundry
      media_catalog: cloudfoundry 
      media_storage_profile: *
      vm_metadata_key: cf-agent-env
      description: Bosh on vCloudDirector