luxolus
/
open-consul
2
0
Fork 0
Code Issues 1 Pull Requests Packages Releases Wiki Activity
open-consul/ui
History
William Tisäter dc01e0a145 Fix parentKey transitions to root 
Previously, deleting a key in `/dc1/kv/` would transition to
`/dc1/kv//` on success. A refresh at this stage would lead to `404`,
this commit will fix this and generate the correct route key in a
helper function.
 		2014-05-05 21:32:39 +02:00
..
dist ui: ignore compiled js, dist 2014-05-01 11:22:30 -04:00
javascripts Fix parentKey transitions to root 2014-05-05 21:32:39 +02:00
scripts ui: pre-minify JS libs 2014-05-02 14:08:47 -04:00
static ui: loading 2014-05-01 12:17:06 -04:00
styles ui: fix responsiveness for medium-sm screens 2014-05-01 17:22:16 -04:00
tests ui: add base ember 2014-04-30 23:43:55 -04:00
Gemfile ui: update ember, dist steps 2014-05-01 11:21:55 -04:00
Gemfile.lock ui: update ember, dist steps 2014-05-01 11:21:55 -04:00
Makefile ui: delete backup files 2014-05-01 12:45:15 -07:00
README.md Fix typo. 2014-05-02 06:41:02 -06:00
index.html ui: actually render an error message, hide delete on root 2014-05-05 10:20:57 -04:00
style-guide.html ui: add delete key functionality 2014-04-30 23:44:29 -04:00

README.md

Consul Web UI

This directory contains the Consul Web UI. Consul contains a built-in HTTP server that serves this directory, but any common HTTP server is capable of serving it.

It uses JavaScript and Ember to communicate with the Consul API. The basic features it provides are:

  • Service view. A list of your registered services, their health and the nodes they run on.
  • Node view. A list of your registered nodes, the services running on each and the health of the node.
  • Key/value view and update

It's aware of multiple data centers, so you can get a quick global overview before drilling into specific data-centers for detailed views.

The UI uses some internal undocumented HTTP APIs to optimize performance and usability.

Development

Improvements and bug fixes are welcome and encouraged for the Web UI.

You'll need sass to compile CSS stylesheets. Install that with bundler:

cd ui/
bundle

Reloading compilation for development:

make watch

Consul ships with an HTTP server for the API and UI. By default, when you run the agent, it is off. However, if you pass a -ui-dir flag with a path to this directoy, you'll be able to access the UI via the Consul HTTP server address, which defaults to localhost:8500/ui.

An example of this command, from inside the ui/ directory, would be:

consul agent -bootstrap -server -data-dir /tmp/ -ui-dir .

Releasing

make dist

The dist folder will contain the files you should use for deployment.