COSI-98: Pin COSI install to v1alpha1 (v0.2.2)

The upstream kustomize URL
github.com/kubernetes-sigs/container-object-storage-interface tracks main,
which now ships v1alpha2 CRDs. This driver only speaks v1alpha1 (see
proto/cosi.proto and cosi-examples/**), so following the install docs
produces a broken setup: CRDs on the cluster do not match what the driver
emits, and every Bucket / BucketClaim / BucketAccess reconcile fails.

Pin the kustomize ref to v0.2.2 (the last v1alpha1 release) everywhere the
command appears: install docs (README.md, docs/installation/install-helm.md)
and CI (.github/scripts/setup_cosi_resources.sh, cleanup_cosi_resources.sh,
.github/workflows/helm-validation.yml). Also add a short compatibility note
to the docs warning users off upstream main.

Author: anurag4DSB

.github/scripts/cleanup_cosi_resources.sh

@@ -63,7 +63,7 @@ log_and_run echo "Deleting s3-secret-for-cosi secret..."
 log_and_run kubectl delete secret s3-secret-for-cosi --namespace=default || { echo "Secret s3-secret-for-cosi not found." | tee -a "$LOG_FILE"; }
 
 log_and_run echo "Deleting COSI CRD..."
-log_and_run kubectl delete -k github.com/kubernetes-sigs/container-object-storage-interface || { echo "COSI API CRDs or controller not found." | tee -a "$LOG_FILE"; }
+log_and_run kubectl delete -k github.com/kubernetes-sigs/container-object-storage-interface?ref=v0.2.2 || { echo "COSI API CRDs or controller not found." | tee -a "$LOG_FILE"; }
 
 log_and_run echo "Verifying COSI CRDs deletion..."
 if kubectl get crd | grep 'container-object-storage-interface' &>/dev/null; then

.github/scripts/setup_cosi_resources.sh

@@ -26,7 +26,7 @@ log_and_run() {
 
 # Step 1: Install COSI CRDs
 log_and_run echo "Installing COSI CRD..."
-log_and_run kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface
+log_and_run kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface?ref=v0.2.2
 log_and_run kubectl get pods --namespace container-object-storage-system
 
 # Step 2: Verify COSI Controller Pod Status

.github/workflows/helm-validation.yml

@@ -77,7 +77,7 @@ jobs:
         set -e -o pipefail
         (
           echo "=== Setup COSI Controller, CRDs and Driver ==="
-          kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface
+          kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface?ref=v0.2.2
           make container
           kind load docker-image ghcr.io/scality/cosi-driver:latest --name helm-test-cluster
         ) &

README.md

@@ -27,10 +27,10 @@ Use [Quickstart](#quickstart-guide) or follow the [installation guide](docs/inst
 To quickly deploy and test the Scality COSI Driver:
 
 1. Ensure your Kubernetes cluster is properly configured, and [Helm v3+ is installed](https://helm.sh/docs/intro/install/). The COSI specification was introduced in Kubernetes 1.25. We recommend using [one of the latest supported Kubernetes versions](https://kubernetes.io/releases/).
-2. Create namespace `container-object-storage-system` and install the COSI controller deployment and COSI CRDs:
+2. Create namespace `container-object-storage-system` and install the COSI controller deployment and COSI CRDs. The Scality COSI Driver supports only COSI **v1alpha1** — the command below pins upstream to tag `v0.2.2` (the last v1alpha1 release). Do not install from upstream `main`, which now ships v1alpha2 and is incompatible with this driver.
 
    ```bash
-   kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface
+   kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface?ref=v0.2.2
    ```
 
 3. Deploy the driver: Namespace `container-object-storage-system` will be created in step 2.

docs/installation/install-helm.md

@@ -21,8 +21,10 @@ Its recommended to deploy COSI controller first which creates the `container-obj
 
 ### Deploy COSI controller and related CRDs
 
+The Scality COSI Driver supports only COSI **v1alpha1**. The command below pins the upstream controller and CRDs to tag `v0.2.2` (the last v1alpha1 release) — do not install from upstream `main`, which now ships v1alpha2 and is incompatible with this driver.
+
 ```bash
-kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface
+kubectl create -k github.com/kubernetes-sigs/container-object-storage-interface?ref=v0.2.2
 ```