History

John Cowen 66c139ceae UI: Text change and clarity Node Health > Health Checks (#5115 ) Text change Node Health > Health Checks Also adds an info icon and tooltip to Health Checks column header		2019-01-17 09:20:00 +00:00
..
app	UI: Text change and clarity Node Health > Health Checks (#5115 )	2019-01-17 09:20:00 +00:00
config	UI: Add conditional enterprise logo (#4432 )	2018-07-30 17:59:43 +01:00
lib	ui: Adds the CONSUL_VERSION env var into the HTML source in a comment (#4993 )	2018-11-26 14:27:56 +00:00
public	ui: serve /robots.txt when UI is enabled. (#5089 )	2018-12-17 19:35:03 +01:00
tests	enable ember-exam	2019-01-03 22:21:20 -05:00
.dev.eslintrc.js	…
.editorconfig	…
.ember-cli	Move testing doubles to use data embedded in the HTML vs HTTP/fetch	2018-07-02 19:02:16 +01:00
.eslintrc.js	…
.gitignore	WIP: Feature/acceptance tests	2018-06-12 11:24:35 +01:00
.nvmrc	…
.prettierrc	…
.watchmanconfig	…
GNUmakefile	Move testing doubles to use data embedded in the HTML vs HTTP/fetch	2018-07-02 19:02:16 +01:00
README.md	add documentation on how to use ember-exam	2019-01-03 23:50:02 -05:00
ember-cli-build.js	ui: Adds multi syntax linting to the code editor (#4814 )	2018-10-19 17:36:38 +01:00
package.json	add test-parallel yarn command	2019-01-03 23:49:45 -05:00
testem.js	output XML test results	2019-01-03 22:21:19 -05:00
yarn.lock	adding ember-exam package	2019-01-03 16:59:30 -05:00

README.md

consul-ui

Prerequisites

You will need the following things properly installed on your computer.

Installation

git clone https://github.com/hashicorp/consul.git this repository
cd ui-v2
yarn install

Running / Development

The source code comes with a small server that runs enough of the consul API as a set of mocks/fixtures to be able to run the UI without having to run consul.

make start-api or yarn start:api (this starts a Consul API double running on http://localhost:3000)
make start or yarn start to start the ember app that connects to the above API double
Visit your app at http://localhost:4200.

To enable ACLs using the mock API, use Web Inspector to set a cookie as follows:

CONSUL_ACLS_ENABLE=1

This will enable the ACLs login page, to which you can login with any ACL token/secret.

You can also use a number of other cookie key/values to set various things whilst developing the UI, such as (but not limited to):

CONSUL_SERVICE_COUNT=1000
CONSUL_NODE_CODE=1000
// etc etc

See ./node_modules/@hashicorp/consul-api-double for more details.

Code Generators

Make use of the many generators for code, try ember help generate for more details

Running Tests

Please note: You do not need to run make start-api/yarn run start:api to run the tests, but the same mock consul API is used.

make test or yarn run test
make test-view or yarn run test:view to view the tests running in Chrome

Running Tests in Parallel

Alternatively, ember-exam can be used to split the tests across multiple browser instances for faster results. Most options are the same as ember test. To see a full list of options, run ember exam --help.

Note: The EMBER_EXAM_PARALLEL environment variable must be set to override the default parallel value of 1 browser instance in testem.js.

To quickly run the tests across 4 parallel browser instances:

yarn test-parallel

To run manually:

$ EMBER_EXAM_PARALLEL=true ember exam --split <num> --parallel

More ways to split tests can be found in the ember-exam README.md.