kolla-cli 10.0.0

安装

以下安装过程假定kolla-ansible仓库与kolla-cli仓库处于同一级别。这在cli_setup.py脚本中已明确说明，该脚本通过相对引用“../”指向kolla-ansible仓库。如果您的kolla-ansible目录在其他位置，则可以将该位置作为参数传递给cli_setup.py脚本。kolla-cli期望kolla-ansible文件所在的系统位置，并安装到该位置，可以通过在运行cli_setup.py脚本之前和运行kolla-cli命令本身时设置KOLLA_HOME和KOLLA_ETC环境变量来调整。KOLLA_HOME的默认值是/usr/share/kolla-ansible，KOLLA_ETC的默认值是/etc/kolla。

以下步骤可以用来构建/运行kolla-cli

• 安装ansible和docker

• virtualenv .venv

• . .venv/bin/activate

• pip install -r requirements.txt

• python setup.py install

• python ./cli_setup.py

• kolla-cli

此时，您将进入kollacli shell，在那里您可以运行help或?之类的命令来查看可用的命令，以及可以直接执行的任何子命令。

或者，您也可以不使用shell，直接通过kollacli host add等命令执行命令。

如果您对i18n字符串（如_(“message”）之类的函数）进行了更改，请确保使用python setup.py extract_messages命令重新生成i18n文件，并将生成的文件存入openstack-kollacli中。

API

要使用API，将ClientAPI导入到您的模块中

from kolla_cli.api.client import ClientApi

然后定义一个全局变量

CLIENT = ClientApi()

然后您可以使用该全局变量执行API命令，例如，向清单添加主机

CLIENT.host_add([‘host_name’])

生成文档

我们使用Sphinx来维护文档。您可以使用pip安装Sphinx。

$ pip install -U Sphinx

除了Sphinx，您还需要以下要求（由doc/requirements.txt覆盖）

$ pip install openstackdocstheme reno 'reno[sphinx]'

文档的源代码位于doc目录下，您可以使用以下命令生成html文件。如果生成成功，将在doc目录下创建一个build/html目录。

$ cd doc
$ make html

现在您可以在http://localhost:8080上作为简单网站提供文档。

$ cd build/html
$ python -m SimpleHTTPServer 8080

参与进来

需要功能吗？找到错误吗？告诉我们！贡献非常受欢迎，应遵循标准Gerrit工作流程。

• 我们使用#openstack-kolla irc频道进行交流。

• 在Launchpad上提交错误、蓝图、跟踪发布等。

• 参加每周的会议。

• 贡献代码。

贡献者

查看谁在贡献代码和贡献审查。

故障排除

如果您收到有关缺失python.h的错误，请通过apt-get或yum或其他适合您平台的方式安装python-dev包。