Skip to content

Latest commit

 

History

History
57 lines (40 loc) · 2.81 KB

running_bats_using_rake_tasks.md

File metadata and controls

57 lines (40 loc) · 2.81 KB
Raw

BATs rake tasks

There are two rake tasks that are designed to help with running BATs. They require a minimum number of environment variables which are used to construct the deployment manifest. See Environment variables section below for the full list of environment variables.

Running BATs against existing director

The following command should be used to run BATs against a running director.

$ cd bosh
$ bundle exec rake spec:system:existing_micro[<infrastructure>,<hypervisor>,<os_name>,<os_version>,<network_type>,<agent_type>,<light_stemcell_flag>,<disk_format>]
  • infrastructure - the type of infrastructure director is running on. (e.g. aws, openstack, vsphere, vcloud, warden)
  • hypervisor - the stemcell hypervisor (hvm or xen)
  • os_name - the name of OS used in stemcell (ubuntu or centos)
  • os_version - the version of OS (e.g. trusty)
  • network_type - the type of network being tested (manual or dynamic).
  • agent_type - the agent type that is running on stemcell (e.g. go). There used to be ruby agent, which is no longer supported by BOSH, so this argument probably will go away soon from rake task.
  • light_stemcell_flag - the boolean flag that indicates if stemcell type is light (for aws stemcells).
  • disk_format - the disk format that stemcell is using (e.g. raw, qcow2, ovf, files)

There are some infrastructure specific BATs and BATs that depend on network type.

Running BATs without existing director

The following command will deploy the micro BOSH using a tested stemcell first and then run BATs against it.

$ cd bosh
$ bundle exec rake spec:system:micro[<infrastructure>,<hypervisor>,<os_name>,<os_version>,<network_type>,<agent_type>,<light_stemcell_flag>,<disk_format>]

See previous section for arguments' meanings.

Specifying the stemcell to be tested

CANDIDATE_BUILD_NUMBER environment variable determines which stemcell is being tested in rake tasks.

If it is set then rake tasks will download the public stemcell of the given number of type based on arguments specified in rake tasks (e.g. light aws ubuntu trusty stemcell).

If it is not set the stemcell of version 0000 will be used that is located in bosh/tmp folder.

Environment variables

Export these environment variable before running your BATs task:

export BAT_DIRECTOR=<Director IP>
export BAT_DNS_HOST=<Director IP>
export BAT_VCAP_PRIVATE_KEY=<private key file for vcap user $PWD/bats.pem>
export BAT_DEPLOYMENT_SPEC=<deployment spec template $PWD/ubuntu-dynamic-bats-config.yml>
export BAT_INFRASTRUCTURE=<infrastructure type, aws/openstack/vcloud/vsphere/etc>
export BAT_NETWORKING=<networking type, manual/dynamic>
export BAT_VCAP_PASSWORD=<password for vcap user>
export BAT_STEMCELL=<Path to stemcell ex: $PWD/stemcell/stemcell.tgz>