Skip to content

Commit

Permalink
Merge pull request #59 from mareklibra/readme.packaging
Browse files Browse the repository at this point in the history
README.md updated for changes in packaging
  • Loading branch information
mareklibra authored Nov 28, 2016
2 parents 774c480 + 635d98c commit f3e9640
Showing 1 changed file with 13 additions and 24 deletions.
37 changes: 13 additions & 24 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,33 +13,27 @@ POC of new oVirt User Portal.
For more info, see [doc/goals.md](https://github.com/mareklibra/userportal/blob/master/doc/goals.md)

## How To Run
So far, the UserPortal is under development.
User-friendly installation & setup will follow.

For early testing:

**Prerequisities:**

- Have the oVirt engine running at https://[ENGINE_URL]
- example: https://engine.local/ovirt-engine
- tested with npm version 3.10.8
- known issue with missing dependencies with npm v2.15.9
- known issue with missing dependencies with npm v2

**Build**

**For Development:**
After _git clone_, run:

- update package.json to (see above):
- `"proxy": "https://[ENGINE_URL]"`
- example at the end of the package.json:
- "proxy": "https://engine.local/ovirt-engine"
./autogen.sh
make # to create the 'build' directory
or
make rpm # to create (s)rpms under 'tmp.repos'

- alternatively using the `ENGINE_URL` environment variable
- `ENGINE_URL=https://my.other.engine/ovirt-engine npm start`
- when using both the `proxy` field in `package.json` and the `ENGINE_URL` environment
variable, the environment setting takes precedence.
**RPM installation**

The rpm installs to `/user/share/ovirt-web-ui`.

New ovirt-web-ui.war is added to the existing ovirt-engine.ear.

- `npm i`
- `HTTPS=true npm start`
- access the UserPortal at [https://localhost:3000/](https://localhost:3000/)

**Quick run using Docker**

Expand All @@ -51,11 +45,6 @@ Just specify where your oVirt engine is running and expose the port `3000` from

`docker run --rm -it -e ENGINE_URL=https://my.ovirt.instance/ovirt-engine/ -p 3000:3000 matobet/userportal`

**Production Build**

- `npm i && npm run build`
- result is in UserPortal/build
- TODO: an RPM will be provided ...

## Technical Details
- components maintained in [ovirt-ui-components](https://github.com/matobet/ovirt-ui-components)
Expand Down

0 comments on commit f3e9640

Please sign in to comment.