ceph/src/ceph-volume/ceph_volume/tests/functional/README.md

   1 # ceph-volume functional test suite
   2
   3 This test suite is based on vagrant and is normally run via Jenkins on github
   4 PRs. With a functioning Vagrant installation these test can also be run locally
   5 (tested with vagrant's libvirt provider).
   6
   7 ## Vagrant with libvirt
   8 By default the tests make assumption on the network segments to use (public and
   9 cluster network), as well as the libvirt storage pool and uri. In an unused
  10 vagrant setup these defaults should be fine.
  11 If you prefer to explicitly configure the storage pool and libvirt
  12 uri, create a file
  13 `$ceph_repo/src/ceph-volume/ceph_volume/tests/functional/global_vagrant_variables.yml`
  14 with content as follows:
  15 ``` yaml
  16 libvirt_uri: qemu:///system
  17 libvirt_storage_pool: 'vagrant-ceph-nvme'
  18 ```
  19 Adjust the values as needed.
  20
  21 After this descend into a test directory (e.g.
  22 `$ceph_repo/src/ceph-volume/ceph_volume/tests/functional/lvm` and run `tox -vre
  23 centos7-bluestore-create -- --provider=libvirt` to execute the tests in
  24 `$ceph_repo/src/ceph-volume/ceph_volume/tests/functional/lvm/centos7/bluestore/create/`