COSI Driver installation using Operator

To use the COSI Driver, you must deploy the following components to your cluster:

• Kubernetes Container Object Storage Interface CRDs
• Container Object Storage Interface Controller

Note: The following kubectl patch command is required as the current installation procedure for v0.2.1 will use a previous image version.

oc create -k 'https://github.com/kubernetes-sigs/container-object-storage-interface//?ref=v0.2.1'
oc patch deployment container-object-storage-controller -n container-object-storage-system -p '{"spec":{"template":{"spec":{"containers":[{"name":"objectstorage-controller","image":"gcr.io/k8s-staging-sig-storage/objectstorage-controller:release-0.2"}]}}}}'

Operator Installation

1. On the OpenShift console, navigate to OperatorHub and use the keyword filter to search for Dell Container Storage Modules.

2. Click Dell Container Storage Modules tile

3. Keep all default settings and click Install.

Verify that the operator is deployed

oc get operators

NAME                                                          AGE
dell-csm-operator-certified.openshift-operators               2d21h

oc get pod -n openshift-operators

NAME                                                       READY   STATUS       RESTARTS      AGE
dell-csm-operator-controller-manager-86dcdc8c48-6dkxm      2/2     Running      21 (19h ago)  2d21h

Install COSI Driver

1. Ensure that you have created the project where you want to install the driver.

oc new-project dell-cosi

2. Create a new file called secret.yaml with the contents of the configuration file. Edit the file with parameters specific to the ObjectScale instance.

cat <<EOF > secret.yaml
connections:
  - objectscale:
      id: objectscale
      credentials:
        username: namespaceadmin
        password: namespaceadminpassword
      namespace: ns1
      mgmt-endpoint: https://mgmt-endpoint-address:4443
      emptyBucket: true
      protocols:
        s3:
          endpoint: https://s3-endpoint-address:9021
      tls:
        insecure: true
EOF

3. Create a secret by running

oc create secret generic cosi-config -n dell-cosi --from-file=config.yaml=secret.yaml

4. Create a Custom Resource (CR) for COSI using either minimal resource file or the more configurable sample. Save one of the following YAML blocks to a file.

cat <<EOF > csm-cosi.yaml
apiVersion: storage.dell.com/v1
kind: ContainerStorageModule
metadata:
  name: cosi
  namespace: dell-cosi
spec:
  driver:
    csiDriverType: "cosi"
    configVersion: v1.0.0
    forceRemoveDriver: true
EOF

cat <<EOF > csm-cosi.yaml
apiVersion: storage.dell.com/v1
kind: ContainerStorageModule
metadata:
  name: cosi
  namespace: dell-cosi
spec:
  driver:
    csiDriverType: "cosi"
    configVersion: v1.0.0
    replicas: 2
    forceRemoveDriver: true
    common:
      image: "quay.io/dell/container-storage-modules/cosi:v1.0.0"
      imagePullPolicy: IfNotPresent
      # Node selector for scheduling the COSI driver pod.
      nodeSelector: {}
      # Tolerations for scheduling the COSI driver pod.
      tolerations: []
      envs:
        # COSI driver log level.
        # Options are "PANIC", "FATAL", "ERROR", "WARN", "INFO",
        # "DEBUG", and "TRACE".
        - name: COSI_LOG_LEVEL
          value: "INFO"
        # COSI driver log format
        # Allowed values: "TEXT" or "JSON"
        # Default value: "TEXT"
        - name: COSI_LOG_FORMAT
          value: "TEXT"
        # OTEL_COLLECTOR_ADDRESS is the gRPC endpoint for the OTEL Collector.
        # Example: "otel-collector.namespace:4317"
        # Default: ""
        - name: OTEL_COLLECTOR_ADDRESS
          value: ""
    sideCars:
      - name: objectstorage-provisioner-sidecar
        image: gcr.io/k8s-staging-sig-storage/objectstorage-sidecar:release-0.2
        imagePullPolicy: IfNotPresent
EOF

5. Create the COSI CR using the CR.

   oc create -f csm-cosi.yaml
   

   You should see the following output:

   containerstoragemodule.storage.dell.com/cosi created
   

6. Validate the installation

   # oc get csm -A
   NAMESPACE   NAME   CREATIONTIME   CSIDRIVERTYPE   CONFIGVERSION   STATE
   dell-cosi   cosi   16s            cosi            v1.0.0          Succeeded
   
   # oc -n dell-cosi get pods
   NAME                   READY   STATUS    RESTARTS   AGE
   cosi-59fbff5ff-m2j5x   2/2     Running   0          32s
   cosi-59fbff5ff-w2sxm   2/2     Running   0          32s