Skip to content

Commit

Permalink
Merge pull request #36 from robusta-dev/brew-readme-update
Browse files Browse the repository at this point in the history
Add brew installation process
  • Loading branch information
LeaveMyYard authored May 15, 2023
2 parents 4b1b389 + 3d19717 commit 53ee1b4
Showing 1 changed file with 21 additions and 30 deletions.
51 changes: 21 additions & 30 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -139,42 +139,30 @@ More features (like seeing graphs, based on which recommendations were made) com
### Installation
<!-- _Depending on your operating system, select the appropriate installation method._
#### Linux
```sh
sudo apt install robusta-krr
````
#### MacOS
#### Installing with brew (MacOS/Linux):
1. Add our tap:
```sh
brew install robusta-krr
brew tap robusta-dev/homebrew-krr
```

#### Windows

2. Install KRR:
```sh
choco install robusta-krr
brew install krr
```

#### Debian

3. Check that installation was successfull (First launch might take a little longer):
```sh
sudo apt install robusta-krr
krr --help
```

#### Docker
#### Installing on Windows:

`````sh
docker pull robusta/krr
````
We will use chocolatey for easier installing on Windows, but currently it is not yet supported.
If you want to still run on Windows, you can do that by installing using brew (see above) on [WSL2](https://docs.brew.sh/Homebrew-on-Linux), or installing manually:

#### Manual

-->

1. Make sure you have [Python 3.9](https://www.python.org/downloads/) (or greater) installed
2. Clone the repo:

Expand All @@ -195,6 +183,9 @@ pip install -r requirements.txt
python krr.py --help
```

Notice that using source code requires you to run as a python script, when installing with brew allows to run `krr`.
All above examples show running command as `krr ...`, replace it with `python krr.py ...` if you are using a manual installation.

To use krr with [Google Cloud Managed Service for Prometheus](https://cloud.google.com/stackdriver/docs/managed-prometheus) some [additional configuration](./docs/google-cloud-managed-service-for-prometheus.md) is necessary.

<p align="right">(<a href="#readme-top">back to top</a>)</p>
Expand All @@ -206,43 +197,43 @@ To use krr with [Google Cloud Managed Service for Prometheus](https://cloud.goog
Straightforward usage, to run the simple strategy:

```sh
python krr.py simple
krr simple
```

If you want only specific namespaces (default and ingress-nginx):

```sh
python krr.py simple -n default -n ingress-nginx
krr simple -n default -n ingress-nginx
```

By default krr will run in the current context. If you want to run it in a different context:

```sh
python krr.py simple -c my-cluster-1 -c my-cluster-2
krr simple -c my-cluster-1 -c my-cluster-2
```

If you want to get the output in JSON format (--logtostderr is required so no logs go to the result file):

```sh
python krr.py simple --logtostderr -f json > result.json
krr simple --logtostderr -f json > result.json
```

If you want to get the output in YAML format:

```sh
python krr.py simple --logtostderr -f yaml > result.yaml
krr simple --logtostderr -f yaml > result.yaml
```

If you want to see additional debug logs:

```sh
python krr.py simple -v
krr simple -v
```

More specific information on Strategy Settings can be found using

```sh
python krr.py simple --help
krr simple --help
```

<p align="right">(<a href="#readme-top">back to top</a>)</p>
Expand Down Expand Up @@ -279,7 +270,7 @@ kubectl port-forward pod/kube-prometheus-st-prometheus-0 9090
Then, open another terminal and run krr in it, giving an explicit prometheus url:

```sh
python krr.py simple -p http://127.0.0.1:9090
krr simple -p http://127.0.0.1:9090
```

<p align="right">(<a href="#readme-top">back to top</a>)</p>
Expand Down

0 comments on commit 53ee1b4

Please sign in to comment.