Files
openstack-ansible-os_tempest/doc/source/user/installation.rst
Chandan Kumar ecdc0eedaf Update openstack.org -> opendev.org
It updates the url from git.openstack.org to opendev.org and
also remove cgit from opendev.org.

Keeping vagrantfile, run_tests.sh and bindep.txt as itis
as these are updated automatically by openstack-ansible-tests.

Change-Id: Ia449079776e0339515ae1a2bca7553b03d9cde1c
Signed-off-by: Chandan Kumar <chkumar@redhat.com>
2019-05-30 15:29:22 +05:30

34 lines
1.2 KiB
ReStructuredText

============
Installation
============
This page describes how to install ``os_tempest`` role.
To clone or view the source code of ``os_tempest``, visit the role repository
for `os_tempest <https://opendev.org/openstack/openstack-ansible-os_tempest>`_.
Install dependencies via ``ansible-galaxy``:
.. code-block:: shell
$ mkdir ~/.ansible/roles -p
$ git clone https://opendev.org/openstack/openstack-ansible-os_tempest ~/.ansible/roles/os_tempest
$ ansible-galaxy install -r ~/.ansible/roles/os_tempest/requirements.yml --roles-path=~/.ansible/roles/
Then you need to export a couple of variables, `ANSIBLE_ROLES_PATH` which
points to the directory where ``os_tempest`` was cloned and
`ANSIBLE_ACTION_PLUGINS` which points to the location of ``config_template``
plugin. In this case it's:
.. code-block:: shell
$ export ANSIBLE_ROLES_PATH=$HOME/.ansible/roles
$ export ANSIBLE_ACTION_PLUGINS=~/.ansible/roles/config_template/action
Then create a ``playbook.yaml``, you can find an `example one here`_.
Then don't forget to set the name of the cloud you're going to run the role
against, `see this page`_.
.. _example one here: ./usage.html#example-playbook
.. _see this page: ./configuration.html#set-the-name-of-the-cloud