Prepare Cluster for Rok CSI

Rok uses the Container Storage Interface (CSI) v1alpha1. However, GKE forces a different, incompatible version by default. In this guide you will prepare your cluster to install the CSI version that Rok needs.

See also

• Official documentation on Kubernetes Custom Resources.

What You'll Need

• A configured management environment.
• Your clone of the Arrikto GitOps repository.
• An existing GKE cluster.
• Access to the GKE cluster.

Procedure

Prepare your cluster to install the CSI version that Rok needs with the following commands:

1. Go to your GitOps repository, inside your rok-tools management environment:

   root@rok-tools:~# cd ~/ops/deployments
   

2. Install Kyverno:

   root@rok-tools:~/ops/deployments# rok-deploy --apply rok/kyverno/overlays/deploy
   

3. Apply a Kyverno policy to disable the original GKE-provided CSI version:

   root@rok-tools:~/ops/deployments# rok-deploy --apply rok/csi-disable-v1beta1/overlays/deploy
   

4. Verify that Kyverno is up-and-running:

   root@rok-tools:~/ops/deployments# kubectl get deploy -n kyverno
   

5. Delete the original GKE-provided VolumeSnapshot Custom Resource Definition (CRD):

   root@rok-tools:~/ops/deployments# kubectl delete customresourcedefinitions.apiextensions.k8s.io volumesnapshots.snapshot.storage.k8s.io
   

6. Delete the original GKE-provided VolumeSnapshotClass CRD:

   root@rok-tools:~/ops/deployments# kubectl delete customresourcedefinitions.apiextensions.k8s.io volumesnapshotclasses.snapshot.storage.k8s.io
   

7. Delete the original GKE-provided VolumeSnapshotContents CRD:

   root@rok-tools:~/ops/deployments# kubectl delete customresourcedefinitions.apiextensions.k8s.io volumesnapshotcontents.snapshot.storage.k8s.io
   

Verify

1. Verify your cluster does not have any snapshot-related CRDs left. Ensure that the following command produces no output:

   root@rok-tools:~/ops/deployments# kubectl get customresourcedefinitions.apiextensions.k8s.io | grep volumesnapshot
   

Summary

You have successfully prepared your cluster to install the CSI version that Rok needs.

What's Next

The next step is to deploy Rok.

• Deploy Rok

PreviousNext