-
Notifications
You must be signed in to change notification settings - Fork 12
Commit
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
Merge pull request #38 from bhanvimenghani/readme-updates
Updates README.md
- Loading branch information
Showing
1 changed file
with
14 additions
and
54 deletions.
There are no files selected for viewing
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -1,68 +1,28 @@ | ||
# kruize-ui | ||
# Kruize-UI | ||
|
||
This repository contains the code for Kruize Autotune user interface. The objective behind creating the UI is to enable newbies to explore and contribute to Autotune and simplify the initial steps of starting an Autotune experiment. The UI significantly reduces the burden on user to understand, operate and work with Autotune. Not only this it also helps better explain and present what remarkable optimizations Autotune can bring to site reliability engineering. | ||
This repository contains the code for Kruize user interface. The objective behind creating the UI is to enable users to explore and contribute to Kruize. The UI significantly reduces the burden on user to understand, operate and work with Kruize. Not only this it also helps better represent the remarkable optimizations Kruize can bring to your optimization usecases. | ||
|
||
## Quick Start | ||
|
||
### Clone Repository | ||
|
||
``` | ||
git clone [email protected]:kruize/kruize-ui.git | ||
``` | ||
This application is built using [Patternfly and React](https://www.patternfly.org/v4/get-started/developers) | ||
|
||
### Go to the kruize folder | ||
## Before You Start | ||
|
||
``` | ||
cd kruize-ui | ||
``` | ||
Kruize UI needs Kruize server running locally. You can setup Kruize [from here](https://github.com/kruize/kruize-demos/tree/main/remote_monitoring_demo). | ||
|
||
### Switch to mvp_demo branch | ||
Additionally Kruize UI can directly be accessed once remote monitoring demo is setup. | ||
|
||
``` | ||
git fetch origin | ||
git checkout -b mvp_demo origin/mvp_demo | ||
``` | ||
Also, make sure you have [`Node.js`](https://nodejs.org/en/) and [`npm`](https://www.npmjs.com/) installed. Check the currently maintained versions at https://nodejs.org/en/about/releases/. | ||
|
||
### Install Node Package Manager | ||
## Quick Start | ||
|
||
``` | ||
git clone [email protected]:kruize/kruize-ui.git | ||
cd kruize-ui | ||
npm install | ||
export CLUSTER_IP=$(minikube ip) | ||
export KRUIZE_PORT=$(kubectl -n monitoring get svc kruize --no-headers -o=custom-columns=PORT:.spec.ports[*].nodePort 2>/dev/null) | ||
npm run start:dev | ||
``` | ||
|
||
### Run the UI | ||
|
||
To run the kruize ui you can select any of the 2 options : | ||
|
||
1. Native way<br /> | ||
If you are starting the UI for the very first time, it is suggested to | ||
Latest Node.js source code can be downloaded from [here](https://nodejs.org/en/download/). | ||
To run the Kruize-ui: clone the repository and then execute the following command to run the launch script locally.<br /> | ||
|
||
``` | ||
./deploy.sh -d | ||
``` | ||
|
||
<br /> | ||
|
||
2. Containerized way<br /> | ||
|
||
We make use of nginx as a default react server for the UI. | ||
Create the image using the following command<br /> | ||
|
||
``` | ||
docker build -t kruize-ui . | ||
``` | ||
|
||
Run the application using the following command | ||
|
||
``` | ||
docker run --rm -it -p 8080:8080 kruize-ui | ||
``` | ||
|
||
here ui-demo is the image name.<br /> | ||
Use http://localhost:8080/ to view the UI in Browser. | ||
|
||
## Code Origin | ||
|
||
This repository uses the patternfly-react-seed base code as copied from [Patternfly Seed](https://github.com/patternfly/patternfly-react-seed). | ||
This repository uses the patternfly-react-seed base code as taken from [Patternfly Seed](https://github.com/patternfly/patternfly-react-seed). |