assets

README

OpenShift 3 Static Assets

The static assets for OpenShift v3. This includes the web management console.

Contributing

Getting started

1. Install Nodejs and npm

2. Install grunt-cli and bower by running npm install -g grunt-cli bower (may need to be run with sudo)

3. Install ruby

4. Install bundler gem install bundler

5. Install dev dependencies by running hack/install-assets.sh

6. Launch the console and start watching for asset changes by running hack/serve-local-assets.sh

   Note: If you see an ENOSPC error, you may need to increase the number of files your user can watch by running this command:

   echo fs.inotify.max_user_watches=524288 | sudo tee -a /etc/sysctl.conf && sudo sysctl -p
   

Before opening a pull request

1. If needed, run hack/build-assets.sh to update bindata.go
2. Run the test suite with hack/test-assets.sh
3. Rebase and squash changes to a single commit

Production builds

1. Make sure all dev dependencies are up to date by running hack/install-assets.sh
2. Run hack/build-assets.sh
3. Run hack/build-go.sh

The assets served by the OpenShift all-in-one server will now be up to date. By default the assets are served from http://localhost:8091

Debugging Travis failures

If Travis complains that bindata.go is different than the committed version, ensure the committed version is correct:

1. Run hack/clean-assets.sh
2. Run hack/install-assets.sh
3. Run hack/build-assets.sh
4. If bindata.go is changed, add it to your commit and re-push

Documentation

Overview

Package assets includes all of the static assets used by the OpenShift console and login flows. Assets are generated into a .go file and then compiled into the OpenShift all-in-one binary.

See README.md in this directory for more information about working with these assets.