Damon is a terminal user interface (TUI) for Nomad. It provides functionality to observe and interact with Nomad resources such as Jobs, Deployments, or Allocations. Interactions include:
$ nomad status <job>
)Additional Notes
Damon is in an early stage and is under active development. We are working on improving the performance and adding new features to Damon. Please take a look at the Damon project board to see what features you can expect in near future. If you find a bug or you have great ideas how Damon can be improved feel free to open an issue. To avoid duplicates, please check the project board before submitting one. Thank you!
--> Coming soon
Make sure you have your go environment setup:
$ make build
to build the binary$ make run
to run the binary$ make install-osx
on a Mac to cp the binary to /usr/local/bin/damon
or
$ go install ./cmd/damon
Once Damon
is installed and avialable in your path, simply run:
$ damon
Damon reads the following environment variables on startup:
NOMAD_TOKEN
NOMAD_ADDR
NOMAD_REGION
NOMAD_NAMESPACE
NOMAD_HTTP_AUTH
NOMAD_CACERT
NOMAD_CAPATH
NOMAD_CLIENT_CERT
NOMAD_CLIENT_KEY
NOMAD_TLS_SERVER_NAME
NOMAD_SKIP_VERIFY
You can read about them in detail here.
On every table or text view, you can use:
k
or arrow up
to navigate upj
or arrow down
to navigate downctrl-j
ctrl-d
ctrl-n
ctrl-j
s
ctrl-c
<ENTER>
(on the selected job)<t>
(on the selected job)<i>
(on the selected job)</>
(on the selected job)i
(on the selected job)STDOUT
for a Task: <ENTER>
STDERR
for a Task: <ctrl-e>
<e>
When Damon displays logs, you can navigate through the logs using j
, k
, G
, and g
.
/
which will open an input field to enter the filter string.h
. This will also open an input field to enter the highlighting string.s
to stop a log stream.r
to resume a log stream.