Fabric8 Planner
Overview
Fabric8 Planner is a task planner and the issue tracker front-end for openshift.io. It uses the Fabric8 Work Item Tracker as the back-end.
The Planner project provides a component library which is used by other applications to provide a task planning front-end.
Running the Planner
The Planner is available as an npm package. It can not be run by itself as it is an Angular component library.
However, for development and testing purpose, a minimal runtime environment is available in the runtime directory. So you can run Planner either as a minimal Standalone component or as an Integrated component using an external webapp like the fabric8-ui. Typically, you would want to develop in the Standalone mode and test your changes in the Integrated mode.
Quickstart
The Planner build can be quickly run using the launcher script.
You can use the launcher script to run the Planner either as a Standalone component or as an Integrated component using an external webapp like the fabric8-ui.
-
Without Docker: To run a minimal runtime implementation of the Planner using an in-memory mock database use:
$ scripts/run-planner.sh --standalone
You can access the service on
localhost:8080
NoteTo run the script on macOS, install gnu-getopt
, runbrew install gnu-getopt
, and set it in your PATH:echo 'export PATH="/usr/local/opt/gnu-getopt/bin:$PATH"' >> ~/.zshrc
. -
With Docker: To run the complete Planner stack using
Docker Compose
with core, auth and their respective database setups use:docker-compose up
For detailed information on building and running Planner see Building the Planner Component Library documentation.
Other Useful Scripts and Tasks
The Planner uses gulp
as the build tool and provides frequently used tasks like npm
tasks as well.
The scripts
section of the link:package.json [package.json] file lists all the tasks available.
The following table lists some of the most useful or frequently used scripts and gulp
tasks you may need to run:
Script | Command | Description |
---|---|---|
Clean |
|
Cleans the project directory |
Reinstall |
|
Cleans the dependencies and reinstalls them |
Unit Tests |
|
Runs the unit tests |
Semantic Release |
|
Builds the library and performs a semantic release to npmjs |
Continuous Build |
|
Runs the build in watch mode, watches for changes and rebuilds source |
Documentation
The following documentation is available in the docs directory:
-
Building the Planner: Provides information on manually building the Planner in Standalone, Integrated, and Production environments.
-
Technology Stack: Lists the the technology stack used by Planner.
-
Testing: Covers the tests you can run on Planner.
Contributing
All contributions are welcome, if you want to contribute to this project, ensure you follow the Contribution Guidelines.