github
/
consul
mirror of https://github.com/hashicorp/consul
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
Consul is a distributed, highly available, and data center aware solution to connect and configure applications across dynamic, distributed infrastructure.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
6390 Commits
1703 Branches
457 Tags
697 MiB
 
 
 
 
 
 
Tree: fe915938c7
Branches Tags
${ item.name }
Create tag ${ searchTerm }
Create branch ${ searchTerm }
from 'fe915938c7'
${ noResults }
consul/ui
James Phillips 7200b8cda8
UI cleanup follow up from #3245. (#3251) 		7 years ago
..
javascripts UI cleanup follow up from #3245. (#3251) 7 years ago
scripts Moves the static assets into a subfolder where index.html expects them. 9 years ago
static Updates static assets to latest. 8 years ago
styles Merge pull request #2812 from naaaargle/master 8 years ago
tests
…
GNUmakefile Acknowledge that we're using GNU make's dialect and rename appropriate 9 years ago
Gemfile
…
Gemfile.lock properly escape session and acl data in UI (#2456) 8 years ago
README.md UI updates for new Consul logo 8 years ago
development_config.json
…
index.html Cleans up web UI and fixes ACL token "stuckness" issue. (#3245) 7 years ago
style-guide.html Everything is pink now 8 years ago

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 datacenters, 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 directory, 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 .

Basic tests can be run by adding the ?test query parameter to the application.

When developing Consul, it's recommended that you use the included development configuration.

consul agent -config-file=development_config.json

Releasing

make dist

The ../pkg/web_ui folder will contain the files you should use for deployment.

Acknowledgments

Cog icon by useiconic.com from the Noun Project

Compiling the UI into the Go binary

The UI is compiled and shipped with the Consul go binary. The generated bindata file lives in the command/agent/bindata_assetfs.go file and is checked into source control. This is useful so that not every Consul developer needs to set up bundler etc. To re-generate the file, first follow the compilation steps above to build the UI assets into the pkg/web_ui folder. With that done, from the root of the Consul repo, run:

$ make static-assets

The file will now be refreshed with the current UI data. You can now rebuild the Consul binary normally with make bin or make dev, and see the updated UI after re-launching Consul.