Metadata-Version: 2.1
Name: lazo
Version: 1.3
Summary: small utility to iteract with Rancher API
Home-page: https://github.com/saxix/lazo
Author: Stefano Apostolico
Author-email: s.apostolico@gmail.com
License: MIT
Description: ## Lazo
        
        [![PyPI version](https://badge.fury.io/py/lazo.svg)](https://badge.fury.io/py/lazo)
        
        Small utility to work with Rancher. It has been developd to be used in CI environments.
        
        Current features:
        
         - get infos on running cluster/project/workload
         - get docker image info
         - upgrade workload 
         - execute commands in running containers
         
          
        ### Install
        
            $ pip install lazo
            
        or using [pipsi](https://pypi.org/project/pipsi/) 
        
            $ pipsi install lazo
            
        ### Help        
                
            $ lazo --help
            Usage: lazo [OPTIONS] COMMAND [ARGS]...
            
            Options:
              --version        Show the version and exit.
              --env
              -v, --verbosity  verbosity level
              -q, --quit       no output
              -d, --dry-run    dry-run mode
              --debug          debug mode
              -h, --help       Show this message and exit.
            
            Commands:
              docker
              rancher    
        
        
        ### Environment varialbles      
        
        - RANCHER_BASE_URL as `--base-url`
        - RANCHER_KEY as `--key`
        - RANCHER_SECRET as `--secret`
        - RANCHER_CLUSTER as `--cluster`
        - RANCHER_PROJECT as `--project`
        - RANCHER_INSECURE as `--inxecure`
        - DOCKER_REPOSITORY as `--repository`
        
        You can inspect your default configuration with:
        
            $ lazo --defaults
            Env                  Value                                              Origin
            repository           https://hub.docker.com/v2
            auth
            base_url
            cluster
            insecure             False
            project
            use_names            False
            
        or list handler environment variables with:
        
            $ lazo --env
            Env                  Value
            DOCKER_REPOSITORY    -- not set --
            RANCHER_AUTH         -- not set --
            RANCHER_BASE_URL     -- not set --
            RANCHER_CLUSTER      -- not set --
            RANCHER_INSECURE     -- not set --
            RANCHER_PROJECT      -- not set --
            RANCHER_USE_NAMES    -- not set --      
        
        
        ### Examples
        
        #### Rancher
        
        ##### get infos on running workload
              
            $ lazo rancher -i -n info -p cluster1:bitcaster -w bitcaster:bitcaster
            Workload infos:
            Image: bitcaster/bitcaster:0.3.0a15
            Command: ['stack']
            imagePullPolicy: Always    
        
        ##### upgrading workload
        
            $ export RANCHER_KEY=key
            $ export RANCHER_SECRET=secret
            $ lazo upgrade saxix/devpi:latest \
                   --base-url https://rancher.example.com/v3/
                   --cluster c-wwk6v
                   --project p-xd4dg
         
        ##### use stdin to read credentials
        
            $  cat .pass.txt | lazo --stdin \
                upgrade bitcaster:bitcaster \
                bitcaster/bitcaster:0.3.0a10 \
                --insecure
        
        ##### execute command in running container
        
            $ lazo shell bitcaster:db -- ls -al /var/log
            total 432
            drwxr-xr-x 1 root        root       4096 Jan  1 01:39 .
            drwxr-xr-x 1 root        root       4096 Dec 26 00:00 ..
            drwxr-xr-x 1 root        root       4096 Jan  1 01:39 apt
            -rw-r--r-- 1 root        root      74886 Jan  1 01:39 dpkg.log
            -rw-r--r-- 1 root        root      32000 Jan  1 01:39 faillog
            drwxr-xr-x 2 root        root       4096 May 25  2017 sysstat
        
        
        #### Docker
        
        ##### list image available tags
        
            $ lazo docker info saxix/devpi
            latest
            2.3
            2.2
            2.1
            2.0
            1.1
        
        ##### get information on image
        
            $ lazo docker info library/python --filter '3\.6.*alpine3.8' --size
            3.6-alpine3.8                  26.2MiB
            3.6.8-alpine3.8                26.2MiB
            3.6.7-alpine3.8                26.2MiB
            3.6.6-alpine3.8                26.2MiB
        
Keywords: rancher
Platform: UNKNOWN
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.6
Description-Content-Type: text/markdown
Provides-Extra: test
