open-consul/ui/README.md

53 lines
1.5 KiB
Markdown
Raw Normal View History

2014-04-21 20:01:53 +00:00
## Consul Web UI
This directory contains the Consul Web UI. Consul contains a built-in
2014-05-02 12:41:02 +00:00
HTTP server that serves this directory, but any common HTTP server
2014-04-21 20:01:53 +00:00
is capable of serving it.
2014-05-01 03:08:10 +00:00
It uses JavaScript and [Ember](http://emberjs.com) to communicate with
the [Consul API](http://www.consul.io/docs/agent/http.html). The basic
2014-04-21 20:01:53 +00:00
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.
2014-05-01 03:08:10 +00:00
The UI uses some internal undocumented HTTP APIs to optimize
performance and usability.
2014-04-21 20:01:53 +00:00
### Development
Improvements and bug fixes are welcome and encouraged for the Web UI.
2014-05-01 15:21:55 +00:00
You'll need sass to compile CSS stylesheets. Install that with
bundler:
2014-04-21 20:01:53 +00:00
2014-05-01 15:21:55 +00:00
cd ui/
bundle
2014-04-21 20:01:53 +00:00
Reloading compilation for development:
make watch
2014-05-01 03:08:10 +00:00
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`.
2014-05-01 03:08:54 +00:00
An example of this command, from inside the `ui/` directory, would be:
consul agent -bootstrap -server -data-dir /tmp/ -ui-dir .
2014-05-01 15:21:55 +00:00
### Releasing
2014-05-01 19:43:49 +00:00
`make dist`
2014-05-01 15:31:56 +00:00
2014-05-01 19:43:49 +00:00
The `dist` folder will contain the files you should use for deployment.