Skip to main content
Version: v0.5

GKE

Prerequisites​

  1. gcloud cli
  2. kubectl with correct context selected: pointing to the cluster you want to deploy Luna on.
  3. helm: the package manager for Kubernetes
  4. An existing zonal or regional GKE standard (not Autopilot) cluster

Step 1(optional): Install Nvidia gpu driver for gpu workload​

kubectl apply -f https://raw.githubusercontent.com/GoogleCloudPlatform/container-engine-accelerators/master/nvidia-driver-installer/cos/daemonset-preloaded.yaml

Step 2: Deploy Luna​

Luna needs cert-manager running in the cluster. Deploy script tries to detect cert-manager in the cluster and installs cert-manager to cert-manager namespace otherwise.

To use Luna, workload identity must be enabled on the specified nodepool of the cluster. If it's not already enabled, the deployment script will prompt you to enable it during deployment.

For deploy.sh, set cluster-location to the zone for a zonal GKE cluster and to the region for a regional GKE cluster.

    ./deploy.sh <gcp-project-name> <gke-cluster-name> <cluster-location> <nodepool-name> <additional-helm-values(optional)>

Note: This command generates an gke-cluster-name_values.yaml file; please retain this file for use in future upgrades.

Step 3: Verify Luna​

kubectl get all -n elotl

Sample Output

NAME                                READY   STATUS    RESTARTS   AGE
pod/luna-manager-5d8578565d-86jwc   1/1     Running   0          56s
pod/luna-webhook-58b7b5dcfb-dwpcb   1/1     Running   0          56s
pod/luna-webhook-58b7b5dcfb-xmlds   1/1     Running   0          56s

NAME                   TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)    AGE
service/luna-webhook   ClusterIP   x.x.x.x          <none>        8443/TCP   57s

NAME                           READY   UP-TO-DATE   AVAILABLE   AGE
deployment.apps/luna-manager   1/1     1            1           57s
deployment.apps/luna-webhook   2/2     2            2           57s

NAME                                      DESIRED   CURRENT   READY   AGE
replicaset.apps/luna-manager-5d8578565d   1         1         1       57s
replicaset.apps/luna-webhook-58b7b5dcfb   2         2         2       57s

Step 4: Run some workloads!​

Follow our tutorial to understand value provided by Luna.

Step 5: Verify test pod launch and dynamic worker node addition/removal (while testing)​

kubectl get pods --selector=elotl-luna=true -o wide -w
kubectl get nodes -w

Upgrade​

To upgrade an existing luna deployment, run:

helm upgrade elotl-luna <chart-path> --wait --namespace=<cluster-namespace> --values=<retained-path>/<gke-cluster-name>_values.yaml <additional-helm-values(optional)>

For example, to upgrade my-cluster from luna-v0.4.6 to luna-v0.5.0 and set an additional helm value binPackingNodeCpu=2, run:

helm upgrade elotl-luna ./elotl-luna-v0.5.0.tgz --wait --create-namespace --namespace=elotl --values=../../luna-v0.4.6/gke/my-cluster_values.yaml --set binPackingNodeCpu=2

And validate the upgrade as follows:

helm ls -A
NAME              NAMESPACE        REVISION        UPDATED                                     STATUS          CHART                    APP VERSION
elotl-luna        elotl            4               2023-05-19 14:15:30.686251 -0700 PDT        deployed        elotl-luna-v0.5.0        v0.5.0

Cleanup​

helm uninstall elotl-luna --namespace=elotl
kubectl delete namespace elotl
gcloud container node-pools delete luna-nodepool --zone=$COMPUTE_REGION --cluster=$CLUSTER_NAME