Skip to content

Commit 615415d

Browse files
Fix frictions identified in gke-h4d example (GoogleCloudPlatform#5183)
1 parent d0947cc commit 615415d

3 files changed

Lines changed: 9 additions & 57 deletions

File tree

examples/gke-h4d/README.md

Lines changed: 1 addition & 49 deletions
Original file line numberDiff line numberDiff line change
@@ -5,55 +5,7 @@ This blueprint uses GKE to provision a Kubernetes cluster and a H4D node pool, a
55
> **_NOTE:_** The required GKE version for H4D support is >= 1.32.3-gke.1170000.
66
77
## Steps to deploy the H4D blueprint
8-
9-
1. Install Cluster Toolkit
10-
1. Install [dependencies](https://cloud.google.com/cluster-toolkit/docs/setup/install-dependencies).
11-
1. Set up [Cluster Toolkit](https://cloud.google.com/cluster-toolkit/docs/setup/configure-environment).
12-
1. Switch to the Cluster Toolkit directory
13-
14-
```sh
15-
cd cluster-toolkit
16-
```
17-
18-
1. Get the IP address for your host machine
19-
20-
```sh
21-
curl ifconfig.me
22-
```
23-
24-
1. Update the vars block of the `gke-h4d-deployment.yaml` file.
25-
1. `project_id`: ID of the project where you are deploying the cluster.
26-
1. `deployment_name`: Name of the deployment.
27-
1. `region`: Compute region used for the deployment.
28-
1. `zone`: Compute zone used for the deployment.
29-
1. `static_node_count`: Number of nodes to create.
30-
1. `authorized_cidr`: update the IP address in `<your-ip-address>/32`.
31-
1. `reservation`: The name of the compute engine reservation in the form of <reservation-name>. To target a BLOCK_NAME, the name of the extended reservation can be inputted as <reservation-name>/reservationBlocks/<reservation-block-name>.
32-
33-
1. Build the Cluster Toolkit binary
34-
35-
```sh
36-
make
37-
```
38-
39-
1. Provision the GKE cluster
40-
41-
```sh
42-
./gcluster deploy -d examples/gke-h4d/gke-h4d-deployment.yaml examples/gke-h4d/gke-h4d.yaml
43-
```
44-
45-
These four options are displayed:
46-
47-
```sh
48-
(D)isplay full proposed changes,
49-
(A)pply proposed changes,
50-
(S)top and exit,
51-
(C)ontinue without applying
52-
```
53-
54-
Type `a` and hit enter to create the cluster.
55-
56-
1. Additionally, this example blueprint provisions a filestore and connects it to the GKE Cluster via Persistent Volume (PV). An example job template is included in the blueprint which runs a parallel job that reads and writes data to this shared storage. A command similar to `kubectl create -f <file-path>` is displayed in the deployment outputs which can be used to trigger the sample job.
8+
Refer to [Run high performance computing (HPC) workloads with H4D](https://docs.cloud.google.com/kubernetes-engine/docs/how-to/run-hpc-workloads#cluster-toolkit) for instructions on creating the GKE-H4D cluster.
579

5810
## Run a test using the MPI Operator
5911
The MPI Operator is installed on the cluster during the deployment. To run a test using the MPI Operator on the GKE H4D cluster, refer to https://github.com/GoogleCloudPlatform/kubernetes-engine-samples/tree/main/hpc/mpi.

examples/gke-h4d/gke-h4d-deployment.yaml

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -16,28 +16,28 @@ terraform_backend_defaults:
1616
type: gcs
1717
configuration:
1818
# The GCS bucket used for storing terraform state
19-
bucket: BUCKET_NAME
19+
bucket:
2020

2121
vars:
2222
# Your GCP Project ID
23-
project_id: PROJECT_ID
23+
project_id:
2424

2525
# This should be unique across all of your Cluster
2626
# Toolkit Deployments.
27-
deployment_name: DEPLOYMENT_NAME
27+
deployment_name:
2828

2929
# The GCP Region used for this deployment.
30-
region: COMPUTE_REGION
30+
region:
3131

3232
# The GCP Zone used for this deployment.
33-
zone: COMPUTE_ZONE
33+
zone:
3434

3535
# The number of nodes to be created
36-
static_node_count: NODE_COUNT
36+
static_node_count:
3737

3838
# Cidr block containing the IP of the machine calling terraform.
3939
# The following line must be updated for this example to work.
40-
authorized_cidr: IP_ADDRESS/SUFFIX
40+
authorized_cidr:
4141

4242
# The name of the compute engine reservation in the form of
4343
# <reservation-name>

examples/gke-h4d/gke-h4d.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -181,7 +181,7 @@ deployment_groups:
181181
jobset:
182182
install: true
183183
apply_manifests:
184-
- source: "https://raw.githubusercontent.com/kubeflow/mpi-operator/v0.6.0/deploy/v2beta1/mpi-operator.yaml"
184+
- source: "https://raw.githubusercontent.com/kubeflow/mpi-operator/v0.7.0/deploy/v2beta1/mpi-operator.yaml"
185185
server_side_apply: true
186186

187187
# Filestore

0 commit comments

Comments
 (0)