Skip to content

Commit 87c6968

Browse files
author
Ralf Grubenmann
committed
Updates GKE installation tutorial
1 parent 970cfa3 commit 87c6968

1 file changed

Lines changed: 11 additions & 22 deletions

File tree

_posts/2018-09-10-tutorial.md

Lines changed: 11 additions & 22 deletions
Original file line numberDiff line numberDiff line change
@@ -31,44 +31,33 @@ $ cd mlbench-helm
3131

3232
### Installing MLBench
3333

34-
Copy the file `values.yaml` to the current directory, calling it `myvalues.yaml`.
34+
MLBench can be installed with the `google_cloud_setup.sh` script.
3535

36-
```shell
37-
$ cp values.yaml myvalues.yaml
38-
```
39-
40-
This file contains default values for most settings in mlbench. There are however some you need to set yourself to reasonable values for your cluster, namely:
41-
42-
```yaml
43-
limits:
44-
cpu: 1000m
45-
workers: 3
46-
bandwidth: 1000
47-
gpu: 0
48-
```
49-
50-
This limits the maximum usable resources (And the maximum you are able to chose in the UI) to 1 CPU (1000m = 1000 milli-CPUs) core , 0 GPUs, 1000 mbit/s network speed per node and 3 nodes total.
51-
52-
*Note: ``n1-standard-2`` instances have 2 CPU cores. But due to Google Cloud Kubernetes running its own monitoring and management pods, which also use some CPU, it is advisable to set MLBench to use one core less than available*
53-
54-
With those values set, MLBench can be installed with the `google_cloud_setup.sh` script (Run `google_cloud_setup.sh help` to see all available options).
36+
*Note: ``n1-standard-2`` instances have 2 CPU cores. But due to Google Cloud Kubernetes running its own monitoring and management pods, which also use some CPU, it is advisable to set MLBench to use one core less than available on the nodes*
5537

5638
First, create a GKE cluster:
5739

5840
```shell
59-
$ NUM_NODES=4 ./google_cloud_setup.sh create-cluster
41+
$ NUM_NODES=4 NUM_CPUS=1 ./google_cloud_setup.sh create-cluster
6042
```
6143

6244
and then install the helm chart:
6345

6446
```shell
65-
$ ./google_cloud_setup.sh install-chart
47+
$ NUM_NODES=4 NUM_CPUS=1 ./google_cloud_setup.sh install-chart
6648
```
6749

6850
That's it, this should setup MLBench in your Google Kubernetes cluster. The Dashboard URL can be found in at the end of the output of the last command (e.g. `http://172.16.0.1:32145`).
6951

7052
Simply open the URL in your browser and you should be ready to go.
7153

54+
You can set many more options for the `google_cloud_setup.py` script, such as adding GPUs to the nodes or giving the cluster a custom name. To see all available options, execute
55+
the help command:
56+
57+
```shell
58+
$ ./google_cloud_setup.sh help
59+
```
60+
7261
### Using MLBench
7362
Once you open the dashboard URL, you will be greeted by a screen similar to this
7463

0 commit comments

Comments
 (0)