diff options
author | Arul.Nambi <arul.nambi@amdocs.com> | 2017-10-16 11:33:17 -0400 |
---|---|---|
committer | Arul.Nambi <arul.nambi@amdocs.com> | 2017-10-16 11:33:34 -0400 |
commit | d1c24a26266865b914f4bd0e899f4100426d3947 (patch) | |
tree | 85bf2320957dcc7fef9f1987804ea89513696538 | |
parent | 609b78f1f8e461a859d708a8d24311cb416f6271 (diff) |
Updating the documents
Issue-id: AAI-438
Change-Id: I04d3176ac0665705939bed03b7d2e59e53a5e13a
Signed-off-by: Arul.Nambi <arul.nambi@amdocs.com>
-rw-r--r-- | docs/index.rst | 66 |
1 files changed, 62 insertions, 4 deletions
diff --git a/docs/index.rst b/docs/index.rst index 833e1aa..65db788 100644 --- a/docs/index.rst +++ b/docs/index.rst @@ -1,8 +1,66 @@ .. This work is licensed under a Creative Commons Attribution 4.0 International License. -TODO Add files to toctree and delete this header ------------------------------------------------- -.. toctree:: - :maxdepth: 1 +Sparky - Inventory UI Service +============================== +*************** +Overview +*************** +_Sparky_ is a service that interacts with AAI and provides users a UI to view and analyze AAI data. The main goal behind _Sparky_ is providing a more user friendly and clear view of AAI data. + +This document covers cloning, installing, and running the front end (FE) portion of _Sparky_. + +================ +Getting Started +================ + + +Building _Sparky_ +------------------ + +Clone the _Sparky_ FE repository +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Repository name is sparky-fe + +Install required tools +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Install node.js, including the Node Package Manager (NPM). Installing latest should be fun, but if that is causing issues then v6.10.1 will work. + +Install python, v2.7.13 + +Install required packages +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Navigate to the top level project directory and run: + + > npm install + +Run or Build the Project +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +To run the project: + + > npm start + +By default the local instance of the UI will be served to "https://localhost:8001/aai/#/viewInspect". + +This can be configured in the file "webpack.devConfig.js". + +To build the project (generates a .war file): + + > gulp build + +The build will create a directory called "dist" and add the "aai.war" file into said dist directory. + +If changes to the build flow are required, updating "webpack.config.js" and "gulpfile.js" will likely provide any build tuning required. + +================ +Dependencies +================ + +_Sparky_ UI requires: + +- _Sparky_ instance that will serve the UI
\ No newline at end of file |