Metadata-Version: 1.1
Name: uos.cli
Version: 0.4.1
Summary: UOS Command-line Client
Home-page: http://wiki.openstack.org/OpenStackClient
Author: UnitedStack
Author-email: yejia@unitedstack.com
License: UNKNOWN
Description: =======
        UOS cli
        =======
        
        Cli interface for `Link UOS <http://uoscloud.com>`_ , forked from `Link python-openstackclient <https://github.com/openstack/python-openstackclient>`_ .
        
        Currently Support image, volume, compute, network service.
        
        We only support keystone v3 user auth.
        
        .. Note::
        
            uos cli is just a wrap for python-keystone, python-novaclient,
            python-cinderclient, python-glanceclient, python-neutronclient,
            (just like official python-openstackclient), so you wil install
            those clients as well.
        
            Some changes in uos.cli will be backported to community.
        
            We will try our best to keep cli interface same as community version.
        
        
        Installation
        ++++++++++++
        
        `pip install uos.cli`
        
        If you are in china, you may have trouble working with official http://pypi.python.org :(,
        you can use pip mirror from douban.com. Just modifiy **~/.pip/pip.conf**::
        
            [global]
            index-url=http://pypi.douban.com/simple
            download_cache=~/.cache/pip
            timeout = 60
        
        
        Mac OSX
        -------
        
        You may failed to build python C extension, come to the following err::
        
            clang: error: unknown argument: '-mno-fused-madd'
            [-Wunused-command-line-argument-hard-error-in-future]
        
        Fix it::
        
            export CFLAGS=-Qunused-arguments
            export CPPFLAGS=-Qunused-arguments
        
        
        Upgrade
        +++++++
        
        `pip install -U uos.cli`
        
        
        Usage
        +++++
        
        Write down following info into openrc::
        
            export OS_IDENTITY_API_VERSION=3
            export OS_COMPUTE_API_VERSION=2
            export OS_IMAGE_API_VERSION=1
            export OS_NETWORK_API_VERSION=2.0
            export OS_VOLUME_API_VERSION=1
            export OS_AUTH_URL=http://identity.uoscloud.com
        
            export OS_PROJECT_DOMAIN_ID=26ff8dbbc05142a9b1e3c8d2d9e3f931
            export OS_USER_DOMAIN_ID=26ff8dbbc05142a9b1e3c8d2d9e3f931
        
            export OS_PROJECT_NAME=yejia_project
            export OS_PROJECT_ID=920ae6ded7f7486aa25a978abb0ea950
        
            export OS_USERNAME=yejia_26ff8dbbc05142a9b1e3c8d2d9e3f931
            export OS_USER_ID=c0aaeb28e06344e88205f14a10a22693
        
            export OS_PASSWORD=your_password
        
        If your login email is `yejia@unitedstack.com`, then OS_PROJECT_NAME
        will be `yejia_project`, OS_USERNAME will be `yejia_` + domain_id
        
        .. Note::
        
            The openrc can work with offical python-openstackclient as well
        
        in bash::
        
            >> source openrc
            >> uos
            (uos)          # you enter interactive shell
            (uos) help
            backup create            port delete                   server rescue
            backup delete            port list                     server resize
            backup list              port show                     server resume
            backup restore           port update                   server set
            backup show              quota set                     server show
            complete                 quota show                    server ssh
            console log show         router create                 server suspend
            flavor list              router delete                 server unlock
            flavor show              router gateway clear          server unpause
            floatingip associate     router gateway set            server unrescue
            floatingip create        router interface add          server unset
            floatingip delete        router interface delete       snapshot create
            floatingip disassociate  router list                   snapshot delete
            floatingip list          router port list              snapshot list
            floatingip show          router show                   snapshot set
            help                     router update                 snapshot show
            image create             security group create         subnet create
            image delete             security group delete         subnet delete
            image list               security group list           subnet list
            image save               security group rule create    subnet show
            image set                security group rule delete    subnet update
            image show               security group rule list      token create
            ip fixed add             security group rule show      volume create
            ip fixed remove          security group show           volume delete
            keypair create           security group update         volume list
            keypair delete           server add security group     volume set
            keypair list             server add volume             volume show
            keypair show             server create                 volume type create
            limits show              server delete                 volume type delete
            module list              server image create           volume type list
            net create               server list                   volume type set
            net delete               server lock                   volume type unset
            net external list        server pause                  volume unset
            net list                 server reboot
            net show                 server rebuild
            net update               server remove security group
            port create              server remove volume
            (uos) server list
            | 3e0849fb-aa92-4732-9f2c-fca8060e0852 | test-2       | SHUTOFF | shared=172.31.251.212 |
            | 0af2279a-6cda-45c3-8c91-c47e72da4344 | test-1       | ACTIVE  | shared=172.31.251.213 |
            (uos) help server list
            usage: server list [-h] [-f {csv,table}] [-c COLUMN] [--max-width <integer>]
                               [--quote {all,minimal,none,nonnumeric}]
                               [--reservation-id <reservation-id>]
                               [--ip <ip-address-regex>] [--ip6 <ip-address-regex>]
                               [--name <name>] [--status <status>] [--flavor <flavor>]
                               [--image <image>] [--host <hostname>]
                               [--instance-name <server-name>] [--all-projects] [--long]
        
        
Platform: UNKNOWN
Classifier: Environment :: OpenStack
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 2
Classifier: Programming Language :: Python :: 2.7
Classifier: Programming Language :: Python :: 2.6
