Home

Awesome

ntui - A Terminal Based UI To Manage Nomad Clusters.

This is an unofficial open source terminal UI tool to manage your Hashicorp Nomad clusters. The purpose of this tui is to just make it easy to access Nomad services like Jobs, Allocations, Deployments, TaskGroups, Tasks, Logs, Restart/Delete resources.

ntui is free to use and currently at its BETA stage. We are continuously working on adding more features of ntui, so stay tune and keep using ntui.

Screens:

1. Regions/Namespaces:

ntui Regions/Namespaces

2. Jobs:

ntui Jobs

3. Allocations:

ntui Allocations

4. Versions:

ntui Versions

Installations:

ntui can be installed through shell script or make through source code.

Install By Make:

  1. Clone this git repository.
  2. Run make install
  3. Run make build.
  4. Make sure to set all the configurations inside config.toml
  5. Run ntui to start the tui.

Install By shell script:

  1. Clone this git repository.
  2. Run setup script using bash ./setup.sh. It will setup a home directory(.ntui) with configs. Make sure to set all the configurations inside config.toml.
  3. Run build script using bash ./build.sh. It will build the code in local system.
  4. Run it using ./bin/ntui. More options can be viewed using ./bin/ntui --help

How To Use It:

ntui requires some configurations to be set, the default config file should be at user's root home diretory.

Default config file looks like below -

  #Home Directory of ntui
  Home_Dir = ""

  #Set the config path from where all configs should be read
  #Config_Path = ""

  #Set log levels, default: info (info|error|warn) 
  #Log_Level = "info"

  #Set custom log directory for storing ntui app logs
  #Log_Dir = ""

  #Set ntui screen table data refresh rate, default: 5
  #Refresh_Rate = 5

  #Set Nomad HTTP authentication credentials, format username:password
  #Nomad_Http_Auth = ""

  #Set Nomad Server URL
  Nomad_Server_Base_Url = ""

  #Set Nomad ACL Token
  #Nomad_Token = ""

  #Set Default Nomad Cluster Region
  Nomad_Region = ""

  #Set Default Nomad Region's Namespace
  Nomad_Namespace = ""

  #Set Nomad CA certificate
  #Nomad_Cacert = ""

  #Set Nomad CA path
  #Nomad_Capath = ""

  #Set Nomad Client Certificate
  #Nomad_Client_Cert = ""

  #Set Nomad Client Certificate Key
  #Nomad_Client_Key = ""

  #Set Nomad TLS server
  #Nomad_Tls_Server = ""

  #Set If skip certificate verify
  #Nomad_Skip_Verify = false

Commands:

# Run ntui
ntui

# View Help options
ntui help

#  View current ntui version
ntui version

# View config values.
ntui config 

Flags:

Below are the falgs which can be passed while running ntui -

-c or --config-path to set ntui config path.

--home-dir to set home directory of ntui app.

--host to set nomad host.

-l or --log-level to set the ntui log level.

--region to set the nomad region.

-n or --namespace to set the nomad namespace.

-r or --refresh to set refresh rate to refresh the screen data.

--skip-verify to set if skip cetificate verification.

-t or --token to set nomad token to perform actions, which requires it.

Keys:

Global Keys

<1>: To view Nomad Nodes

<2>: To view/change regions and namespaces

<esc>: To go back to previous screen

<enter>: To select the row

Jobs Screen

<ctrl+q>: To stop job

<ctrl+s>: To start job

<d>: View job's definition

<ctrl+d>: Run new job

TaskGroups Screen

<v>: To view job versions

Versions Screen

<ctrl+v>: To revert the selected job versions

Allocations Screen

<ctrl+t>: To restart selected task.

<l>: View logs of selected alloc.

Tasks Screen

<ctrl+t>: To restart selected task.

<l>: To view logs of selected task.

Logs Screen

<e>: To view stderr logs.

<o>: To view stdout logs.