Trash

Trash is a shell I made that does esxi, and redhat stuff. It's garbage.

Description

You can use trash to manipulate the API's for ESXi, linode, and RedHat Satelite Server.

Usage

Trash with no arguements drops you into the shell allowing you to use tab completion:

trash> esx-get-
esx-get-datastores      esx-get-resource-pools
esx-get-hosts           esx-get-vm-name
esx-get-registered-vms  esx-get-vm-uuid
trash> esx-get-registered-vms
{'vim.VirtualMachine:2': 'freebsd-server',
 'vim.VirtualMachine:3': 'ubuntu',
 'vim.VirtualMachine:4': 'roms-api-server',
 'vim.VirtualMachine:1': 'phs-dev-server'}
trash> quit

You may also use arguements if you already know what you want to do or if you want to script:

dusty@xor:~$ trash esx-get-registered-vms
{'vim.VirtualMachine:3': 'ubuntu',
 'vim.VirtualMachine:4': 'roms-api-server',
 'vim.VirtualMachine:2': 'freebsd-server',
 'vim.VirtualMachine:1': 'phs-dev-server'}

Installation

You can do a local install by downloading this repo then running the install:

git clone https://github.com/bsdpunk/trash
cd trash
sudo python setup.py install

Or you can do a non root / local install:

wget https://bootstrap.pypa.io/get-pip.py
python get-pip.py --user
pip install pyVmomi --user
python setup.py --user install

Or pip:

sudo pip install trash-shell

Some things you can do with Trash

trash> help

(required) <optional>

If an arguement has spaces, use single quotes.


jump (destination) <variation on username> : go to another server, via the jump server
which (potential executable): find executables on the machine trash is running on


help,? : show commands and usage
quit, exit : leave the shell
clear : clear screen

ESX-API Commands
esx-get-hosts: get esx hosts
esx-get-registered-vms: get esx vms
esx-get-resource-pools: get esx resource pools
esx-get-datastores: get esx datastores
esx-get-vm-name (hostname): get vm object
esx-vm-device-info (vm-name): get info on vm
esx-check-tools (vm-name): check vm ware tools on vm
esx-get-vm-uuid (ip-of-vm): get uuid of vm
esx-list-datastores: List all datastores
esx-change-cd (vm-name) <iso>: change the iso of the vm, blank for blank
esx-create-from-ova (ova path): Create a VM from an OVA
esx-create-from-ovf (ovf path) (vmdk path): Create a VM from an OV
esx-destroy-vm (bios uuid): destroy powered on vm

REDHAT SATELLITE API Commands
sat-list-users : lists satellite users
sat-get-api-call : get api calls for satellite
sat-get-version : satellite server version
sat-system-version : satellite system version
sat-list-all-groups: list all available groups
sat-list-systems (group) : list systems in a group
sat-list-systems-hosts (group) : list hosts and roles of system in a group
sat-list-systems-hosts-audit (group) (role) : list all sytems in a group, not in role X(1-7)
sat-system-group-audit: list all systems, and their assigned groups

LINODE Commands
linode-list : lists your linode servers
linode-create (DatacenterID) (PlanID) <PaymentTerm>: create Linode
linode-list-ip <linode_id> <IPaddress> : return JSON information about ip address and server 
avail-datacenters : lists available centers
avail-distributions : lists available distribution centers
nodebal-list : get list of lode balancers    
nodebal-config-list (id): get lode balancer specifics using id from list
nodebal-node-list (config id): get node list of a balancer
nodebal-create (DatacenterID): create node balancer


DOCKER commands
dock-containers: show docker containers

TODO

Complete the APIs so they are complete. This is more of an amalgam of uncompleted projects, rather than one that's just a single entity.

Make it more robust, and much more clear on why a command failed (Not enough parameters, Missing Required Parameter, etc). Only alerting for actual problems.

Make the commands have conistent Prefixes...IE get the linode ones all fixed up with linode prefixes

erryday I be seddin' it.

$ sed -i 's/ip-list/linode-list-ip/gi' trash/trash.py 
$ sed -i 's/ip_list/linode_list_ip/gi' trash/servers_action.py 

Provide single commands that run all the equivelant commands, ie:

list will run:

esx-get-registered-vms linode-servers sat-list-systems

Others:

ip-list spin up servers with same iso at same time, different services

This is actually for another project that will integrate the shell: I want it to be possible to have a load balancing option in the shell that will spin up webheads based on traffic.