summaryrefslogtreecommitdiffstats
path: root/openecomp-ui/README.md
diff options
context:
space:
mode:
authorandre.schmid <andre.schmid@est.tech>2021-08-06 16:04:50 +0100
committerMichael Morris <michael.morris@est.tech>2021-08-11 08:25:33 +0000
commitead5c383df30c94a83ee1d7e2c869cc5b23697a2 (patch)
tree3f21ba4cf4fcb119243acbbde176dc7ab37d91f7 /openecomp-ui/README.md
parent7c8f40bc6df4a5a4d5822e48ecbe5ebe6a0d251a (diff)
Fix local build of onboarding-fe
dox-sequence-diagram-ui/package.json: - upgrades webpack-cli to 3.3.12, the actual version 2.0.14 is not compatible or recommended with the webpack version. openecomp-ui/package.json: - upgrades webpack-cli to 3.3.12, the actual version 2.0.14 is not compatible or recommended with the webpack version. - upgrades babel-core from 6.24.0 to 6.26.0. Code and config fixes: - fixes i18n openecomp-ui/src/nfvo-utils/i18n/i18n.js. The previous code was calling an non-existent attribute of the intl-format-cache. - fixes dox-sequence-diagram-ui path in openecomp-ui/webpack.config.js. The previous path configuration was causing compilation problems in the openecomp-ui (folder not found problem). Updates README.md with used procedure to run onboarding-fe. Change-Id: I28f7b78a1f30b5f904b3f7214f72e9741253622d Issue-ID: SDC-3661 Signed-off-by: André Schmid <andre.schmid@est.tech>
Diffstat (limited to 'openecomp-ui/README.md')
-rw-r--r--openecomp-ui/README.md40
1 files changed, 24 insertions, 16 deletions
diff --git a/openecomp-ui/README.md b/openecomp-ui/README.md
index 883aeb41e3..c270802744 100644
--- a/openecomp-ui/README.md
+++ b/openecomp-ui/README.md
@@ -2,33 +2,41 @@
## Setup
-##### Install `nodejs`:
+###Install `npm`
-download nodejs from here: https://nodejs.org/en/ (take the "current" version with latest features) & install it.
-##### Install `gulp`
+Install npm v6.
+
+###Install `Node.js`
+
+Install node v10.17.0 (as in the pom.xml <nodeVersion>v10.17.0</nodeVersion>).
+
+* To manage different versions of node, is recommended to install "n" (https://github.com/tj/n).
+
+### Install `gulp`
install gulp by running the following command `npm install --global gulp-cli`
-##### Install DOX-UI
+## Build
+
+### Install DOX-UI
* pull for latest changes
-* go to folder `dox-sequence-diagram-ui`
-* run `npm install`
-* wait for it...
-* go to folder `openecomp-ui`
-* run `npm install`
-* create a copy of `devConfig.defaults.json` file and name it `devConfig.json` (we already configured git to ignore it so it will not be pushed)
-in that file.
+* go to folder `../dox-sequence-diagram-ui`
+* run `npm install && npm run build`
- set "proxyCatalogTarget" to the URL of the sdc-frontend; set "proxyTarget" to the URL of the sdc-onboard-backend (**pay attention, it is a JSON file**):
+#### Install onboarding-fe
+* go to the current project folder `openecomp-ui`
+* run `npm install`
+* create a copy of `devConfig.defaults.json` file and name it `devConfig.json` (it is already configured to gitignore, so it will not be pushed)
+* in `devConfig.json`:
+ * set "proxyCatalogTarget" to the URL of the sdc-frontend; set "proxyTarget" to the URL of the sdc-onboard-backend (**pay attention, it is a JSON file**):
- For example *http://\<host>:\<port>*
+ For example *http://\<host>:\<port>*
* run `npm start`
* your favorite UI will wait for you at: `http://localhost:9000/sdc1/#!/onboardVendor`
-
-
-#### Troubleshooting
+## Troubleshooting
Problem | Why is this happening | Solution
------- | --------------------- | --------
+Build (npm install) error | npm/node_modules cache | If having problems with the compilation of dox-sequence-diagram-ui and openecomp-ui, delete the node_modules and package-lock.json in each respective projects folder.
npm cannot reach destination | proxy | When within managed network, you should set your proxy to NPM as the following: <br> `npm config set proxy http://<host>:<port>` <br> `npm config set https-proxy http://<host>:<port>`
git protocol is blocked and cannot connect | managed network rules for protocols | When within managed network, you should set globally that when git protocol is used, then it will be replaced with "https" <br> `git config --global url."https://".insteadOf git://`