Client for Congress
Free software: Apache license
Documentation: https://docs.openstack.org/python-congressclient/latest/
Install the Congress CLI by cloning the repository and running the setup file. The master repository always contains the latest source code, so if you are installing and testing a specific branch of Congress, clone the matching branch of the python-congressclient.
To execute CLI commands to standalone Congress installed with noauth:
Install python-openstackclient:
$ pip install python-openstackclient
Clone master repository & install python-congressclient:
$ git clone https://github.com/openstack/python-congressclient.git
$ cd python-congressclient
$ python setup.py install
(Optional) Clone a branch; for example, if you are using the Ocata version of OpenStack and Congress:
$ git clone -b stable/ocata https://github.com/openstack/python-congressclient.git
$ cd python-congressclient
$ python setup.py install
Read the HTML documentation. Install python-sphinx and the oslosphinx extension if missing:
$ sudo pip install sphinx
$ sudo pip install oslosphinx
Build the docs $ make docs
Open doc/html/index.html in a browser
To execute CLI commands:
$ cd python-congressclient
For example:
$ export CONGRESS_URL="http://127.0.0.1:1789"
$ openstack --os-token foo --os-url $CONGRESS_URL
(openstack) congress policy create test_policy
+--------------+--------------------------------------+
| Field | Value |
+--------------+--------------------------------------+
| abbreviation | test_ |
| description | |
| id | 8595f24a-7d74-45ee-8168-0b3e937b8419 |
| kind | nonrecursive |
| name | test_policy |
| owner_id | user |
+--------------+--------------------------------------+
(openstack) congress policy rule create test_policy "p(5)"
+---------+--------------------------------------+
| Field | Value |
+---------+--------------------------------------+
| comment | None |
| id | 5ce7fb18-a227-447e-bec8-93e99c0052a5 |
| name | None |
| rule | p(5) |
+---------+--------------------------------------+
(openstack) congress policy rule list test_policy
// ID: 5ce7fb18-a227-447e-bec8-93e99c0052a5
// Name: None
p(5)
(openstack) exit
$
TODO
Except where otherwise noted, this document is licensed under Creative Commons Attribution 3.0 License. See all OpenStack Legal Documents.