RETIRED, Fuel Web UI
Go to file
Julia Aranovich 0de244cf7c Remove wizard translations of Murano option
Change-Id: I391e38f90f4cef3c57a4b3a89529ed7ce07c9612
2017-02-22 16:50:58 +04: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 Remove wizard translations of Murano option 2017-02-22 16:50:58 +04: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 Update .gitignore to ignore .idea of pycharm 2016-10-10 13:14:59 +08: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 Add Bogdan Dudko to the list of maintainers 2016-04-20 17:19:58 +03:00
README.rst Show team and repo badges on README 2016-11-25 17:42:30 +01:00
gulpfile.js Adapt plugin-tests to run on real nailgun 2017-01-12 15:18:32 +04: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 09:55:53 +00:00
run_real_plugin_tests.sh Adapt plugin-tests to run on real nailgun 2017-01-12 15:18:32 +04:00
run_real_plugin_tests_on_real_nailgun.sh Adapt plugin-tests to run on real nailgun 2017-01-12 15:18:32 +04:00
run_ui_func_tests.sh Nightly ui functional tests update. 2016-11-09 13:25:50 +03:00
webpack.config.js Enable loose mode for ES6 class transformation 2016-07-15 19:07:29 +03:00

README.rst

Team and repository tags

image

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