Is your OpenStack installation ready to run BOSH and install Cloud Foundry? Run this validator to find out.
Ruby Shell HCL
Latest commit b1ab188 Feb 14, 2017 @Kiemes Kiemes committed with beyhan Add blue-box tags in pipeline

Signed-off-by: Beyhan Veli <>

CF OpenStack Validator

Is your OpenStack installation ready to run BOSH and install Cloud Foundry? Run this validator to find out.



  • Keystone v3
  • Create an OpenStack project/tenant
  • Create a network
    • Connect the network with a router to your external network
  • Allocate a floating IP
  • Allow ssh access in the default security group
  • Create a key pair by executing
$ ssh-keygen -t rsa -b 4096 -N "" -f cf-validator.rsa_id
  • Upload the generated public key to OpenStack as cf-validator
  • A public image available in glance
    • If your OpenStack installation doesn't yet provide any image, you can upload a CirrOS test image


The validator runs on Mac and Linux. Please ensure that the following packages are installed on your system:

Linux Requirements

  • ruby 2.1.x or newer
  • make
  • gcc
  • zlib1g-dev
  • libssl-dev
  • ssh

Mac Requirements

  • xcode command line tools


  • git clone
  • cd cf-openstack-validator
  • Copy the generated private key into the cf-openstack-validator folder.
  • Copy validator.template.yml to validator.yml and replace occurrences of <replace-me> with appropriate values (see prerequisites)
$ cp validator.template.yml validator.yml
$ sudo gem install bundler
$ bundle install
  • Start validation
$ ./validate --stemcell bosh-stemcell-<xxx>-openstack-kvm-ubuntu-trusty-go_agent.tgz --config validator.yml

Configure CPI used by validator

Validator downloads CPI release from the URL specified in the validator configuration. You can override this by specifying the --cpi-release command line option with the path to a CPI release tarball.

If you already have a CPI compiled, you can specify the path to the executable in the environment variable OPENSTACK_CPI_BIN. This is used when no CPI release is specified on the command line. It overrides the setting in the validator configuration file.

Command line help

  • To learn about available options run
$ ./validate --help


You can extend the validator with custom tests. For a detailed description and examples, please have a look at the extension documentation.


The validator does not run on your OpenStack? See additional OpenStack related configuration options for possible solutions.