VCTUI - VMware vCenter Text User Interface

Basic holder readme.me

Inspired by the time wasted continualy right clicking in the Web UI...

To get

go get -u github.com/thebsdbox/vctui

To use

Now has a docker image:

Using -e to pass in the environment variables defined below.

docker run -it --rm -e VCUSER -e VCPASS thebsdbox/vctui:0.1.0 --address https://Username:password@URL/sdk

VMware vCenter credentials are required and can be specified in a number of ways:

Flags

--address - can either be https://Username:password@URL/sdk or omit the user/pass details

--user - used to specify a username

--pass - used to specify a password

--insecure - used to ignore a bad certificate

Environment variables

VCURL - same as --address

VCUSER / VCPASS - same as the credentials above

Then just start the application and you should see something similar below:

VMware vCenter
├──VMs
│  ├──server01
│  │  └──Details
│  │     ├──CPUs: 1
│  │     ├──Memory: 1024
│  │     ├──VMware Tools: guestToolsNotRunning
│  │     ├──VM IP Address:
│  │     └──MAC ADDRESS: 00:50:56:a3:64:a2
│  ├──server02
│  │  └──Details
│  │     ├──CPUs: 1
│  │     ├──Memory: 1024
│  │     ├──VMware Tools: 
│  │     ├──VM IP Address:
│  │     └──MAC ADDRESS: 00:50:56:a3:4c:da
│  ├──server03
│  ├──server04
│  ├──server05
│  └──server06
│     └──Details
│        ├──CPUs: 1
│        ├──Memory: 1024
│        ├──VMware Tools: guestToolsNotRunning

Additional functionality

Create New Virtual Machine

Pressing ctrl+n will open a new screen allowing you to create a new virtual machine, the datastore and network dropdowns will populate once a host has been chosen.

Deleting a Virtual Machine

Select the Virtual Machine and press ctrl+d WARNING, there will be no alert and the machine will be instantly deleted (VM has to be powered off)

Search

Pressing ctrl+f will allow a search option (regexp) allowing you to search for specific virtual machine names.

Power Management

Pressing ctrl+p will open a power management ui (press ctrl+c) to exit this menu without making any changes

                    ╔═══Set the power state for this VM════╗                    
                    ║◉  Power On                           ║                    
                    ║◯  Power Off                          ║                    
                    ║◯  Suspend                            ║                    
                    ║◯  Reset                              ║                    
                    ║◯  Reboot (guest tools required)      ║                    
                    ╚══════════════════════════════════════╝    

Installation / Deployment

This requires a plunder server up and running and accessible from where vctui is currently running. Navigate to the MAC address of a newly created virtual machine, and press ctrl+i. This will present a new menu for configuring the settings of a newly deployed OS through plunder.

     ╔════════════════════Update deployment═════════════════════╗
     ║                                                          ║
     ║ Plunder Address http://localhost                         ║
     ║                                                          ║
     ║ MAC Address     00:50:56:9b:2a:b7                        ║
     ║                                                          ║
     ║ Hostname        server09                                 ║
     ║                                                          ║
     ║ IP Address      192.168.1.3                              ║
     ║                                                          ║
     ║ Deployment Type preseed                                  ║
     ║                                                          ║
     ║   Save Settings                                          ║
     ║                                                          ║
     ╚══════════════════════════════════════════════════════════╝

Snapshot

Pressing ctrl+s on one of the listed snapshots will revert the virtual machine to that snapshot, and it will be left in the powered off state

Refreshing Virtual Machines

Pressing ctrl+r will refresh the state of all virtual machines in the VMware vCenter inventory

Feel free to use or get involved.

@thebsdbox