cloudgenix-toolkit-spider 1.0.0

Utility to run commands/tests across large number of CloudGenix Toolkit instances.

CloudGenix Toolkit Spider

Synopsis

Utility to run commands/tests across large number of CloudGenix Toolkit instances.

Features

Early release -

• Create a "Plan" using REGEX patterns of site/element data, and interface names for "connecting to" and "testing".
• Run a "test" (JSON file, see included azurelatency.json for example) against previously created "Plan".

Requirements

• Active CloudGenix Account
• Python >= 2.7 or >=3.6
• Python modules:
  • CloudGenix Python SDK >= 5.1.1b1 - https://github.com/CloudGenix/sdk-python
  • ProgresBar2 >= 3.34.3 - https://github.com/WoLpH/python-progressbar
  • Tabulate >= 0.8.3 - https://bitbucket.org/astanin/python-tabulate
  • Netmiko (develop branch as of 06/07/2019 for CloudGenix ION Support.)

License

MIT

Installation:

• PIP: pip install cloudgenix-toolkit-spider. After install, spider_build_plan or spider_run_plan.
• Github: Download files to a local directory, manually run spider_build_plan.py or spider_run_plan.py scripts.

Examples of usage:

1. Create a test plan to connect to controller interfaces, and test out of 'Internet 1', 'Internet 2', '1' and '2' interfaces.

   edwards-mbp-pro:toolkit_spider aaron$ export AUTH_TOKEN=`cat auth_token`
   edwards-mbp-pro:toolkit_spider aaron$ ./spider_build_plan.py --connect-interfaces "Controller 1,Controller" --test-interfaces "Internet 1,Internet 2,1,2" --output test_plan.csv
   Building Toolkit Spider connect plan..
   100%|######################################################################################################################################################################|Time:  0:00:01
   Testing Toolkit Spider connect interfaces..
   100%|######################################################################################################################################################################|Time:  0:02:00
   edwards-mbp-pro:toolkit_spider aaron$
   

2. Execute the previous created test plan to do an Azure DC latency test.

   edwards-mbp-pro:toolkit_spider aaron$ ./spider_run_plan.py --plan ./test_plan.csv --test ./azurelatency.json --output test_results.csv -U toolkituser
   Password: 
   Running Toolkit Spider Plan..
   100%|######################################################################################################################################################################|Time:  0:01:00
   edwards-mbp-pro:toolkit_spider aaron$ 
   

Caveats and known issues:

• Need latest develop branch of Netmiko, until release with CloudGenix ION support.
• Only one test supported today: tcping
• TODO need to add multiprocessing, script currently runs all tests in serial.
• Script is early access, needs lots of cleanup.

Version

Version	Build	Changes
1.0.0	b1	Initial Release.

Command line help

edwards-mbp-pro:toolkit_spider aaron$ ./spider_build_plan.py -h
usage: spider_build_plan.py [-h] [--site-key SITE_KEY]
                            [--element-key ELEMENT_KEY]
                            [--site-pattern SITE_PATTERN]
                            [--element-pattern ELEMENT_PATTERN] --output
                            OUTPUT --connect-interfaces CONNECT_INTERFACES
                            --test-interfaces TEST_INTERFACES
                            [--connect-timeout CONNECT_TIMEOUT]
                            [--controller CONTROLLER] [--email EMAIL]
                            [--password PASSWORD] [--insecure] [--noregion]
                            [--sdkdebug SDKDEBUG]

CloudGenix Toolkit Spider Build Plan (v1.0.0)

optional arguments:
  -h, --help            show this help message and exit

Build:
  Create a map/plan for the Toolkit Spider action.

  --site-key SITE_KEY, -SK SITE_KEY
                        Key in Site object to use for inclusion. Default
                        'name'
  --element-key ELEMENT_KEY, -EK ELEMENT_KEY
                        Key in Element object to use for inclusion. Default
                        'name'
  --site-pattern SITE_PATTERN, -SP SITE_PATTERN
                        REGEX Pattern to match Site Object with for inclusion.
                        Default '.*'
  --element-pattern ELEMENT_PATTERN, -EP ELEMENT_PATTERN
                        REGEX Pattern to match Element Object with for
                        inclusion. Default '.*'
  --output OUTPUT       Output to filename.
  --connect-interfaces CONNECT_INTERFACES, -CI CONNECT_INTERFACES
                        Comma separated list of interface to use as options to
                        connect via SSH to run the test, if available.
  --test-interfaces TEST_INTERFACES, -TI TEST_INTERFACES
                        Comma separated list of interface to run the test
                        FROM, if available
  --connect-timeout CONNECT_TIMEOUT, -CT CONNECT_TIMEOUT
                        Timeout for connect interface reachability test
                        (seconds, default 5)

API:
  These options change how this program connects to the API.

  --controller CONTROLLER, -C CONTROLLER
                        Controller URI, ex.
                        https://api.elcapitan.cloudgenix.com

Login:
  These options allow skipping of interactive login

  --email EMAIL, -E EMAIL
                        Use this email as User Name instead of
                        cloudgenix_settings.py or prompting
  --password PASSWORD, -PW PASSWORD
                        Use this Password instead of cloudgenix_settings.py or
                        prompting
  --insecure, -I        Do not verify SSL certificate
  --noregion, -NR       Ignore Region-based redirection.

Debug:
  These options enable debugging output

  --sdkdebug SDKDEBUG, -D SDKDEBUG
                        Enable SDK Debug output, levels 0-2

edwards-mbp-pro:toolkit_spider aaron$ ./spider_run_plan.py -h
usage: spider_run_plan.py [-h] --plan PLAN --test TEST --output OUTPUT
                          [--connect-timeout CONNECT_TIMEOUT] --toolkit-user
                          TOOLKIT_USER [--toolkit-password TOOLKIT_PASSWORD]

CloudGenix Toolkit Spider Run Plan (v1.0.0)

optional arguments:
  -h, --help            show this help message and exit

Run:
  Execute a previously built Toolkit Spider plan.

  --plan PLAN, -P PLAN  Plan (CSV) to run
  --test TEST, -T TEST  Test (json) to load and run on Plan
  --output OUTPUT, -O OUTPUT
                        Output to filename.
  --connect-timeout CONNECT_TIMEOUT, -CT CONNECT_TIMEOUT
                        Timeout for connect to run tests (seconds, default 5)
  --toolkit-user TOOLKIT_USER, -U TOOLKIT_USER
                        Toolkit username
  --toolkit-password TOOLKIT_PASSWORD, -PW TOOLKIT_PASSWORD
                        Toolkit password (will prompt if not given)
edwards-mbp-pro:toolkit_spider aaron$