Skip to content

A python CLI client example using python-openstackclient plugin mechanism.

License

Notifications You must be signed in to change notification settings

lingxiankong/python-cliclient

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

python-cliclient

A python CLI client example using python-openstackclient plugin mechanism.

还是需要 python-openstackclient

首先,openstack client是用cliff实现,所以建议先熟读cliff的官方文档,知道cliff的实现机制,这样才能对openstack client的机制有了解,这是熟悉openstack client的基础。如果你不是为了实现 openstack 命令,可以跳过此文直接参考 cliff 给出的一个示例照猫画虎即可。

cliff 中 App 初始化时,初始化参数 command_manager=CommandManager('cliff.demo') 告诉你,命令都在 setup.cfg 中的 cliff.demo 命名空间中定义。

从OSC 2.4.0版本以后,从openstack client又提取出一个叫osc-lib的可重用的库,新的plugin可以继承这个osc-lib来集成openstack命令,但是plugin的加载还是由openstack client来完成。从设计层次上讲,osc-lib继承自cliff,而openstack client和其他的extension其实是平级结构,都继承自osc-lib,只是由openstack client入口而已。

所以,你自己的 CLI 命令要生效,还需要依赖 python-openstackclient,因为 CLI 中的 openstack 命令是安装完 python-openstackclient 后才有。

python-openstackclient 都做了什么

入口在 openstackclient.shell:main

OpenStackShell 类最终继承自 cliff 中的 App。python-openstackclient 的实现之所以复杂,是因为它除了扮演 CLI 总入口的责任外,还需要为其他 plugin 提供支持,承担一些公共事务(比如 keystone 鉴权),让 plugin 只需要关注自己的业务实现。

所以,当你在 CLI 下每次执行 openstack 命令时,python-openstackclient 都会动态的加载系统中所有已注册的 plugin,根据约定好的规则,获取它们的名字,版本,命令行参数等,并把这些 plugin module 注册到 osc-lib 的 clientmanager.ClientManager 类中,属性名由 API_NAME 定义,属性的值是一个描述符对象,被访问时会获取函数 def make_client(instance) 的返回值,其中的 instance 就是一个 clientmanager.ClientManager 实例。

initialize_app 函数执行时,命令行参数已经经过解析。此时,除了 OpenStackShell 初始化时 command_manager 参数指定的命名空间,在这里还有机会再注册其他命令。各个 openstack plugin 命令就是在此时注册。

prepare_to_run_command 函数中主要是实例化 clientmanager.ClientManager,如果 command.auth_required = True 则进行鉴权操作,因为大家在使用命令行时,同样的两个命令,传递的鉴权信息会不一样,因此必须在每个命令执行前进行鉴权。所以 ClientManager 对象保存了鉴权信息。

通过openstack client工程的setup.cfg可以看出,openstack client默认集成了Nova, Keystone, Glance, Neutron, Swift, Cinder这6个项目(在openstack.cli.base命名空间中),同时,从setup.cfg中也可以看到,openstack client有两个全局的命令,分别是openstack command list和openstack module list(在openstack.cli命名空间中),用以查询加载的模块和支持的命令列表。

最终,在command处理时,比如命令行:openstack compute agent list,会调用self.app.client_manager.compute.agents.list处理。还记得那个ClientManager类变量么?compute就是类变量之一,当访问clientmanager.compute时,就会调用openstackclient.compute.client提供的make_client方法,传入clientmanager对象。

你的 client 需要做什么

根据上述的过程,python-openstackclient 把该做的都做了,你只需要按照约定填空即可。

  1. setup.cfg 你需要定义:

    openstack.cli.extension =
        runit = mycli.osc.plugin
    openstack.runit.v1 =
        runit_echo = mycli.echo:Echo

    让 python-openstackclient 找到你的 plugin 定义。

  2. mycli/osc/plugin.py 文件中,按照这里的代码流程定义一些变量。比如:

    • API_NAME,你的 plugin 名字,比如 runit
    • API_VERSION_OPTION,比如 os_runit_version
    • DEFAULT_API_VERSION,比如 1,这个变量最好定义,否则你的 command 不会生效。最终,根据字符串拼接会注册命名空间 openstack.runit.v1 下的 commands
  3. 如果 runit 这个程序不是一个 openstack service client 或者只需要引用其他 service 的 client,就没有必要实现 make_client 方法。

  4. mycli/echo.py 文件中:

    from osc_lib.command import command
    
    
    class Echo(command.Command):
        auth_required = False
    
        def get_parser(self, prog_name):
            parser = super(Echo, self).get_parser(prog_name)
            parser.add_argument(
                '-m', '--message', default='Hello, World!', help='Echo message.'
            )
            return parser
    
        def take_action(self, parsed_args):
            print(parsed_args.message)
  5. 安装和试用。

    $ mkvirtualenv openstack
    $ cd ~/code/python-cliclient
    $ pip install -e .
    $ openstack runit echo
    Hello, World!

About

A python CLI client example using python-openstackclient plugin mechanism.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages