43 lines
1.4 KiB
ReStructuredText
43 lines
1.4 KiB
ReStructuredText
========
|
|
Kolla-CLI
|
|
========
|
|
|
|
The following steps can be used to build / run the kolla-cli
|
|
|
|
* install ansible and docker
|
|
* virtualenv .venv
|
|
* . .venv/bin/activate
|
|
* pip install -r requirements.txt
|
|
* python setup.py install
|
|
* mkdir /usr/share/kolla-ansible
|
|
* cp -r kolla-ansible/ansible to /usr/share/kolla
|
|
* mkdir -p /etc/kolla/kolla-cli/ansible
|
|
* touch /etc/kolla/kolla-cli/ansible/inventory.json
|
|
* mkdir -p /usr/share/kolla-ansible/kolla-cli/tools
|
|
* mkdir /usr/share/kolla-ansible/kolla-cli/ansible
|
|
* touch /usr/share/kolla-ansible/kolla-cli/ansible.lock
|
|
* cp kolla-cli/tools /usr/share/kolla-ansible/kolla-cli/tools
|
|
* mkdir /usr/share/kolla-ansible/ansible/host_vars
|
|
* cp /etc/kolla/globals.yml /usr/share/kolla-ansible/ansible/group_vars/__GLOBAL__
|
|
* kolla-cli
|
|
|
|
At that point you will be dropped into the kollacli shell where
|
|
you can run commands like help or ? to see what commands are
|
|
available and any of the sub commands can be executed directly.
|
|
|
|
Alternately you can not use the shell and just execute commands
|
|
directly via >kollacli host add, etc.
|
|
|
|
If you make changes to the i18n strings (denoted by methods like
|
|
_("message")) make sure to re-generate the i18n files with the
|
|
>python setup.py extract_messages command and check in the files
|
|
generated in openstack-kollacli.
|
|
|
|
===============
|
|
Troubleshooting
|
|
===============
|
|
|
|
If you get an error about missing python.h install the python-dev
|
|
package via apt-get or yum or whatever mechanism is appropriate
|
|
for your platform.
|