From: Nathan Cutler Date: Sat, 11 Feb 2017 11:41:22 +0000 (+0100) Subject: doc: instructions for provisioning OpenStack VMs ad hoc X-Git-Tag: v12.0.1~433^2 X-Git-Url: http://git-server-git.apps.pok.os.sepia.ceph.com/?a=commitdiff_plain;h=63100b4f9b4108a9d7501f3207de6c7197d0b92c;p=ceph.git doc: instructions for provisioning OpenStack VMs ad hoc Signed-off-by: Nathan Cutler --- diff --git a/doc/dev/index.rst b/doc/dev/index.rst index 27a28b245462..6f480f4b9a9e 100644 --- a/doc/dev/index.rst +++ b/doc/dev/index.rst @@ -1297,6 +1297,33 @@ Even if you don't providing the ``--upload`` option, however, all the logs can still be found on the teuthology machine in the directory ``/usr/share/nginx/html``. +Provision VMs ad hoc +-------------------- + +From the teuthology VM, it is possible to provision machines on an "ad hoc" +basis, to use however you like. The magic incantation is:: + + teuthology-lock --lock-many $NUMBER_OF_MACHINES \ + --os-type $OPERATING_SYSTEM \ + --os-version $OS_VERSION \ + --machine-type openstack \ + --owner $EMAIL_ADDRESS + +The command must be issued from the ``~/teuthology`` directory. The possible +values for ``OPERATING_SYSTEM`` AND ``OS_VERSION`` can be found by examining +the contents of the directory ``teuthology/openstack/``. For example:: + + teuthology-lock --lock-many 1 --os-type ubuntu --os-version 16.04 \ + --machine-type openstack --owner foo@example.com + +When you are finished with the machine, find it in the list of machines:: + + openstack server list + +to determine the name or ID, and then terminate it with:: + + openstack server delete $NAME_OR_ID + Deploy a cluster for manual testing -----------------------------------