Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/thebsdbox/vctui
VMware vCenter Text UI
https://github.com/thebsdbox/vctui
Last synced: 3 months ago
JSON representation
VMware vCenter Text UI
- Host: GitHub
- URL: https://github.com/thebsdbox/vctui
- Owner: thebsdbox
- Created: 2019-03-02T15:49:31.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2020-05-14T11:27:49.000Z (over 4 years ago)
- Last Synced: 2024-10-18T05:32:23.285Z (3 months ago)
- Language: Go
- Size: 46.9 KB
- Stars: 35
- Watchers: 5
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
- awesome-tuis - vctui
README
# 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