RETIRED, Fuel Web UI

Go to file

Alexey Shtokolov 811dcf6966 Revert "Add bulk offline node removal" This reverts commit `de101edf03`. Change-Id: I6cfd82366f8b57d86af24b9eeb20473dbd40a8b4		2017-01-27 20:29:40 +00:00
gulp	Forcing eslint max-len rule	2016-01-25 20:06:45 +03:00
specs	Deduplicate shrinkwrap file and add file-saver library	2016-08-02 12:14:31 +03:00
static	Revert "Add bulk offline node removal"	2017-01-27 20:29:40 +00:00
.eslintrc	Restore missing quote-props ESLint rule	2016-02-17 23:01:28 +07:00
.gitignore	Add necessary files	2016-03-01 14:55:40 +07:00
.gitreview	Add necessary files	2016-03-01 14:55:40 +07:00
LICENSE	Add necessary files	2016-03-01 14:55:40 +07:00
MAINTAINERS	Adds Nikolay Bogdanov to the maintainers list	2016-03-31 10:47:29 +00:00
README.rst	Update default FUEL_WEB_ROOT value for convenience	2016-03-01 15:35:50 +00:00
gulpfile.js	Fix UI functional tests in Firefox 47+	2016-08-10 13:42:35 +03:00
karma.config.js	Enable linting for node.js files and split .eslintrc	2016-01-17 18:01:55 +03:00
npm-shrinkwrap.json	Update Boostrap to 3.3.7 to fix deployment timeline popovers	2016-08-17 12:54:06 +03:00
package.json	Add tests for NICs feature, adapt as plugin-tests	2016-12-20 19:32:56 +04:00
run_real_plugin_tests.sh	Adapt plugin-tests to run on real nailgun	2017-01-12 15:28:23 +04:00
run_real_plugin_tests_on_real_nailgun.sh	Adapt plugin-tests to run on real nailgun	2017-01-12 15:28:23 +04:00
run_ui_func_tests.sh	Don't move nailgun log for UI func tests manually	2016-03-14 15:14:27 +03:00
webpack.config.js	Colors refactoring	2016-03-01 13:42:50 +00:00

README.rst

FUEL UI

This repository contains Fuel UI - the web user interface for Nailgun.

Installation

Fuel UI requires Node.js 0.10+ to be installed on your system. On Ubuntu 14.04 you can install it using the following commands:

sudo apt-get remove --yes nodejs nodejs-legacy
sudo add-apt-repository --yes ppa:chris-lea/node.js
sudo apt-get update
sudo apt-get install --yes nodejs
sudo chown -R `whoami`.`whoami` ~/.npm

Install JS dependencies and Gulp:
```
npm install
sudo npm install -g gulp
```
The most convenient approach to modify Fuel UI is to use a development server. It watches for file changes and automatically rebuilds changed modules (significantly faster than full rebuild) and triggers page refresh in browsers:
```
gulp dev-server
```
By default it runs on port 8080 and assumes that Nailgun runs on port 8000. You can override this by using the following options:
```
gulp dev-server --dev-server-host=127.0.0.1 --dev-server-port=8080 --nailgun-host=127.0.0.1 --nailgun-port=8000
```
If automatic rebuild on change doesn't work, most likely you need to increase the limit of inotify watches:
```
echo 100000 | sudo tee /proc/sys/fs/inotify/max_user_watches
```
The production version of Fuel UI can be built by running:
```
gulp build
```
To specify custom output directory location, use static-dir option:
```
gulp build --static-dir=static_compressed
```
To speed up build process you may also want to disable uglification and source maps generation:
```
gulp build --no-uglify --no-sourcemaps
```
If for some reason you don't want to use a development server, but would like to recompile the bundle on any change, use:
```
gulp build --watch
```

Testing

UI tests use Selenium server, so you need to install Java Runtime Environment (JRE) 1.7 or newer version.
You also need to install Firefox - it is used as the default browser for tests.
Run full Web UI test suite, run:
```
npm run lint
npm test
```
UI functional tests require Nailgun server from fuel-web repo to be installed. By default it's assumed that fuel-web repo is in the same directory as fuel-ui repo, but you can specify another path using FUEL_WEB_ROOT environment variable:
```
FUEL_WEB_ROOT=/path/to/fuel-web npm test
```
By default Firefox browser is used. You can specify the browser using BROWSER environment variable:
```
BROWSER=chrome npm test
```