085d9887e0
This patchset updates docs to doc to align with OpenStack standard. Follow-up patchset will be needed to publish documentation to OpenStack [0]. TODO: Update Armada documentation job to align with [1]. [0] https://docs.openstack.org/doc-contrib-guide/project-guides.html [1] http://lists.openstack.org/pipermail/openstack-dev/2018-March/128594.html Change-Id: I100541611ddfcd5c42f09da631346cb8ef3de5e7
54 lines
1.3 KiB
ReStructuredText
54 lines
1.3 KiB
ReStructuredText
==================
|
|
Configuring Armada
|
|
==================
|
|
|
|
|
|
Armada uses an INI-like standard oslo_config file. A sample
|
|
file can be generated via tox
|
|
|
|
.. code-block:: bash
|
|
|
|
$ tox -e genconfig
|
|
$ tox -e genpolicy
|
|
|
|
Customize your configuration based on the information below
|
|
|
|
Keystone Integration
|
|
====================
|
|
|
|
Armada requires a service account to use for validating API
|
|
tokens
|
|
|
|
.. note::
|
|
|
|
If you do not have a keystone already deploy, then armada can deploy a keystone services:
|
|
|
|
$ armada apply keystone-manifest.yaml
|
|
|
|
.. code-block:: bash
|
|
|
|
$ openstack domain create 'ucp'
|
|
$ openstack project create --domain 'ucp' 'service'
|
|
$ openstack user create --domain ucp --project service --project-domain 'ucp' --password armada armada
|
|
$ openstack role add --project-domain ucp --user-domain ucp --user armada --project service admin
|
|
|
|
# OR
|
|
|
|
$ ./tools/keystone-account.sh
|
|
|
|
The service account must then be included in the armada.conf
|
|
|
|
.. code-block:: ini
|
|
|
|
[keystone_authtoken]
|
|
auth_type = password
|
|
auth_uri = https://<keystone-api>:5000/
|
|
auth_url = https://<keystone-api>:35357/
|
|
auth_version = 3
|
|
delay_auth_decision = true
|
|
password = armada
|
|
project_domain_name = ucp
|
|
project_name = service
|
|
user_domain_name = ucp
|
|
user_name = armada
|