diff --git a/samples/deployments/README.rst b/samples/deployments/README.rst index 2f798589..dca1f1f8 100644 --- a/samples/deployments/README.rst +++ b/samples/deployments/README.rst @@ -1,12 +1,21 @@ Rally Deployments ================= -Before starting cluster benchmarking, its connection parameters -should be saved in Rally database (deployment record). +Rally needs to be configured to use an OpenStack Cloud deployment before it +can benchmark the deployment. -If there is no cluster, rally also can create it. +To configure Rally to use an OpenStack Cloud deployment, you need create a +deployment configuration by supplying the endpoint and credentials, as follows: + +.. code-block:: + + rally deployment create --file --name my_cloud + + +If you don't have OpenStack deployments, Rally can deploy it for you. +For samples of various deployments take a look at samples from +**for_deploying_openstack_with_rally** directory. -There are examples of deployment configurations: existing.json ------------- @@ -18,6 +27,15 @@ existing-keystone-v3.json Register existing OpenStack cluster that uses Keystone v3. +existing-with-predefined-users.json +-------------------------------------- + +If you are using read-only backend in Keystone like LDAP, AD then +you need this sample. If you don't specify "users" rally will use already +existing users that you provide. + + + existing-with-given-endpoint.json --------------------------------- @@ -26,33 +44,3 @@ to explicitly set keystone management_url. Use this parameter if keystone fails to setup management_url correctly. For example, this parameter must be specified for FUEL cluster and has value "http://:35357/v2.0/" - -devstack-in-existing-servers.json ---------------------------------- - -Register existing DevStack cluster. - -devstack-in-lxc.json --------------------- - -Deploy DevStack cluster on LXC and register it by Rally. - -devstack-in-openstack.json --------------------------- - -Deploy DevStack cluster on OpenStack and register it by Rally. - -devstack-lxc-engine-in-existing-servers.json --------------------------------------------- - -See *devstack-lxc-engine-in-existing-servers.rst* for details - -fuel-ha.json ------------- - -Deploy High Availability FUEL cluster and register it by Rally. - -fuel-multinode.json -------------------- - -Deploy Multinode FUEL cluster and register it by Rally. diff --git a/samples/deployments/existing-with-predefined-users.json b/samples/deployments/existing-with-predefined-users.json new file mode 100644 index 00000000..f1002b5d --- /dev/null +++ b/samples/deployments/existing-with-predefined-users.json @@ -0,0 +1,23 @@ +{ + "type": "ExistingCloud", + "auth_url": "http://example.net:5000/v2.0/", + "region_name": "RegionOne", + "endpoint_type": "public", + "admin": { + "username": "admin", + "password": "pa55word", + "tenant_name": "demo" + }, + "users": [ + { + "username": "not_an_admin1", + "password": "password", + "tenant_name": "some_tenant" + }, + { + "username": "not_an_admin2", + "password": "password2", + "tenant_name": "some_tenant2" + } + ] +}