vROpsCLI

A utility to assist in managing a vRealize Operation Manager (vROps) environment through the CLI. A user can perform MP installs and upgrades, licensing management, endpoint configuration, credential management, and more! The design is focused around exposing core functionality that can be scripted to make more complex solutions.

Usage

• Downloads are available on the release page.
• Usage details can be located at USAGE.md
• Examples scripts that use the utilty are located in the examples directory
• Blog articles
  • Introducing vROpsCLI from Blue Medora
  • Blue Medora vROpsCLI Tutorial Part One: Getting Started

Development Environment Setup

• Make sure to have Python and Pipenv install
  • For Mac, Install Homebrew (this may take a while if Xcode needs to be installed):

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

• Run pipenv --python 3.7 In current directory (or pipenv --python 3.6 for vROps build directly)
  • If a local python is not available, you may need to install pyenv
• Run pipenv lock --pre and pipenv sync to ensure everything is up to date

To Use

• Run pipenv shell to enter environment

Development Environment Alternative - Docker

• Use docker to run and test code. Run the following to start a dockerfile setup with pre-requisites install, and with the source mapped to /vropscli. Authentication information for the hosts .vropscli.yml will also be mapped in.

make devenv 

To Distribute

Make sure to compile this on the oldest OS you wish to support with your binary!

• Run pylint tests

pylint --disable=all --enable=F,E,unreachable,duplicate-key,unnecessary-semicolon,global-variable-not-assigned,unused-variable,binary-op-exception,bad-format-string,anomalous-backslash-in-string,bad-open-mode *.py

• Run pytest suite

pytest

• Make sure authentication tokens are cleared from recorded sessions.

make cleanauth

• Run installer locally

pipenv shell
pipenv install pyinstaller
pyinstaller -F vropscli.py

• If you wish to compile to work natively on a vROps system (SLES 11), run the Docker build script:

./build.sh

Binary build will be in a artifacts directory

Notes

• Inspired by vROps Relay
• Using Pipenv for package management. See this pipenv tutorial for basic tutorial