RETIRED, Fuel Web UI

Go to file

OpenDev Sysadmins 2d09d065df OpenDev Migration Patch This commit was bulk generated and pushed by the OpenDev sysadmins as a part of the Git hosting and code review systems migration detailed in these mailing list posts: http://lists.openstack.org/pipermail/openstack-discuss/2019-March/003603.html http://lists.openstack.org/pipermail/openstack-discuss/2019-April/004920.html Attempts have been made to correct repository namespaces and hostnames based on simple pattern matching, but it's possible some were updated incorrectly or missed entirely. Please reach out to us via the contact information listed at https://opendev.org/ with any questions you may have.		2019-04-19 19:27:57 +00:00
fixtures/ostf	Add ostf fake server responses to dev server	2016-06-02 09:35:05 +03:00
gulp	Forcing eslint max-len rule	2016-01-25 20:06:45 +03:00
specs	Adjust spec file for new version of nodejs-nailgun	2016-05-30 22:13:34 +03:00
static	Change testgroups to remove whitespaces	2017-03-14 12:00:01 +00:00
.eslintignore	Remove "vendor" directory from project configs	2016-06-23 12:11:39 +03:00
.eslintrc	Fix consistent-return warnings	2016-09-21 15:15:10 +03:00
.gitignore	Add necessary files	2016-03-01 14:55:40 +07:00
.gitreview	OpenDev Migration Patch	2019-04-19 19:27:57 +00:00
LICENSE	Add necessary files	2016-03-01 14:55:40 +07:00
MAINTAINERS	Add Bogdan Dudko to the list of maintainers	2016-04-20 17:19:58 +03:00
README.rst	Update README for running tests	2016-06-01 15:06:32 +00:00
gulpfile.js	Fixes a code typo in gulpfile	2017-03-16 16:01:31 +00:00
karma.config.js	Enable linting for node.js files and split .eslintrc	2016-01-17 18:01:55 +03:00
npm-shrinkwrap.json	Fix UI functional tests in Firefox 47+	2016-08-10 13:22:17 +03:00
package.json	Add tests for NICs feature, adapt as plugin-tests	2016-12-21 15:43:01 +04:00
run_real_plugin_tests.sh	Adapt plugin-tests to run on real nailgun	2017-01-12 15:20:18 +04:00
run_real_plugin_tests_on_real_nailgun.sh	Fix/refactor UI tests after migration from 9.x	2017-03-06 06:34:41 +00:00
run_ui_func_tests.sh	Unify syntax of run_ui_func_tests.sh to suit macosx	2016-07-04 14:44:56 +03:00
webpack.config.js	Enable loose mode for ES6 class transformation	2016-07-15 19:07:29 +03: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 run unit-tests
npm run func-tests
```
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 run func-tests
```
To run a single functional test file, use:
```
npm run func-tests static/tests/functional/test_cluster_page.js
```
By default Firefox browser is used. You can specify the browser using BROWSER environment variable:
```
BROWSER=chrome npm run unit-tests
BROWSER=firefox npm run func-tests
```