From 63100b4f9b4108a9d7501f3207de6c7197d0b92c Mon Sep 17 00:00:00 2001 From: Nathan Cutler Date: Sat, 11 Feb 2017 12:41:22 +0100 Subject: [PATCH] doc: instructions for provisioning OpenStack VMs ad hoc Signed-off-by: Nathan Cutler --- doc/dev/index.rst | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/doc/dev/index.rst b/doc/dev/index.rst index 27a28b24546..6f480f4b9a9 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 ----------------------------------- -- 2.47.3