feat: init

2026-06-06 06:15:45 +03:30
commit a986de98b0
33 changed files with 2141 additions and 0 deletions
@@ -0,0 +1,14 @@
+apiVersion: v2
+name: kloud-csi
+description: Kloud CSI driver for kks persistent volumes
+type: application
+version: 0.1.0
+appVersion: "0.1.0"
+kubeVersion: ">=1.28.0-0"
+home: https://github.com/KubelanCloud/kks-csi-plugin
+keywords:
+  - csi
+  - storage
+  - kloud
+maintainers:
+  - name: Kloud Team
@@ -0,0 +1,77 @@
+{{/*
+Expand the name of the chart.
+*/}}
+{{- define "kloud-csi.name" -}}
+{{- default .Chart.Name .Values.nameOverride | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{/*
+Create a default fully qualified app name.
+*/}}
+{{- define "kloud-csi.fullname" -}}
+{{- if .Values.fullnameOverride }}
+{{- .Values.fullnameOverride | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- $name := default .Chart.Name .Values.nameOverride }}
+{{- if contains $name .Release.Name }}
+{{- .Release.Name | trunc 63 | trimSuffix "-" }}
+{{- else }}
+{{- printf "%s-%s" .Release.Name $name | trunc 63 | trimSuffix "-" }}
+{{- end }}
+{{- end }}
+{{- end }}
+
+{{- define "kloud-csi.chart" -}}
+{{- printf "%s-%s" .Chart.Name .Chart.Version | replace "+" "_" | trunc 63 | trimSuffix "-" }}
+{{- end }}
+
+{{- define "kloud-csi.labels" -}}
+helm.sh/chart: {{ include "kloud-csi.chart" . }}
+{{ include "kloud-csi.selectorLabels" . }}
+{{- if .Chart.AppVersion }}
+app.kubernetes.io/version: {{ .Chart.AppVersion | quote }}
+{{- end }}
+app.kubernetes.io/managed-by: {{ .Release.Service }}
+{{- end }}
+
+{{- define "kloud-csi.selectorLabels" -}}
+app.kubernetes.io/name: {{ include "kloud-csi.name" . }}
+app.kubernetes.io/instance: {{ .Release.Name }}
+{{- end }}
+
+{{- define "kloud-csi.controllerName" -}}
+{{- printf "%s-controller" (include "kloud-csi.fullname" .) }}
+{{- end }}
+
+{{- define "kloud-csi.nodeName" -}}
+{{- printf "%s-node" (include "kloud-csi.fullname" .) }}
+{{- end }}
+
+{{- define "kloud-csi.controllerServiceAccountName" -}}
+{{- if .Values.serviceAccount.controller.create }}
+{{- default (printf "%s-controller-sa" (include "kloud-csi.fullname" .)) .Values.serviceAccount.controller.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.controller.name }}
+{{- end }}
+{{- end }}
+
+{{- define "kloud-csi.nodeServiceAccountName" -}}
+{{- if .Values.serviceAccount.node.create }}
+{{- default (printf "%s-node-sa" (include "kloud-csi.fullname" .)) .Values.serviceAccount.node.name }}
+{{- else }}
+{{- default "default" .Values.serviceAccount.node.name }}
+{{- end }}
+{{- end }}
+
+{{- define "kloud-csi.driverImage" -}}
+{{- printf "%s:%s" .Values.image.repository (default .Chart.AppVersion .Values.image.tag) }}
+{{- end }}
+
+{{- define "kloud-csi.validateRequired" -}}
+{{- if and (not .Values.existingSecret) (not .Values.accessToken) }}
+{{- fail "accessToken or existingSecret is required" }}
+{{- end }}
+{{- if not .Values.serverURL }}
+{{- fail "serverURL is required" }}
+{{- end }}
+{{- end }}
@@ -0,0 +1,11 @@
+apiVersion: v1
+kind: ConfigMap
+metadata:
+  name: {{ include "kloud-csi.fullname" . }}-driver
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+data:
+  driver.hcl: |
+    driver {}
+    client {}
@@ -0,0 +1,102 @@
+{{- include "kloud-csi.validateRequired" . }}
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: {{ include "kloud-csi.controllerName" . }}
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+    app.kubernetes.io/component: controller
+spec:
+  replicas: {{ .Values.controller.replicas }}
+  selector:
+    matchLabels:
+      {{- include "kloud-csi.selectorLabels" . | nindent 6 }}
+      app.kubernetes.io/component: controller
+  template:
+    metadata:
+      labels:
+        {{- include "kloud-csi.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/component: controller
+        {{- with .Values.podLabels }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+      {{- with .Values.podAnnotations }}
+      annotations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+    spec:
+      serviceAccountName: {{ include "kloud-csi.controllerServiceAccountName" . }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      containers:
+        - name: kloud-csi-plugin
+          image: {{ include "kloud-csi.driverImage" . }}
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          args:
+            - --config-file
+            - /etc/kloud-csi/driver.hcl
+          env:
+            - name: KKS_CSI_SERVER_URL
+              value: {{ .Values.serverURL | quote }}
+            - name: KKS_CSI_ACCESS_TOKEN
+              valueFrom:
+                secretKeyRef:
+                  name: {{ default (printf "%s-config" (include "kloud-csi.fullname" .)) .Values.existingSecret }}
+                  key: {{ .Values.existingSecretAccessTokenKey }}
+            - name: KKS_CSI_DRIVER_MODE
+              value: controller
+            - name: KKS_CSI_DRIVER_ENDPOINT
+              value: unix:///csi/csi.sock
+            - name: KKS_CSI_DRIVER_NAME
+              value: {{ .Values.driver.name | quote }}
+          volumeMounts:
+            - name: socket-dir
+              mountPath: /csi
+            - name: config
+              mountPath: /etc/kloud-csi
+          {{- with .Values.controller.resources }}
+          resources:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+        - name: csi-provisioner
+          image: {{ .Values.sidecars.provisioner.repository }}:{{ .Values.sidecars.provisioner.tag }}
+          args:
+            - --csi-address=/csi/csi.sock
+            - --v=2
+            - --feature-gates=Topology=false
+            - --timeout=60s
+            - --leader-election
+            - --default-fstype=ext4
+          volumeMounts:
+            - name: socket-dir
+              mountPath: /csi
+        - name: csi-attacher
+          image: {{ .Values.sidecars.attacher.repository }}:{{ .Values.sidecars.attacher.tag }}
+          args:
+            - --csi-address=/csi/csi.sock
+            - --v=2
+            - --leader-election
+          volumeMounts:
+            - name: socket-dir
+              mountPath: /csi
+        - name: liveness-probe
+          image: {{ .Values.sidecars.livenessProbe.repository }}:{{ .Values.sidecars.livenessProbe.tag }}
+          args:
+            - --csi-address=/csi/csi.sock
+            - --health-port=9808
+          volumeMounts:
+            - name: socket-dir
+              mountPath: /csi
+      volumes:
+        - name: socket-dir
+          emptyDir: {}
+        - name: config
+          configMap:
+            name: {{ include "kloud-csi.fullname" . }}-driver
@@ -0,0 +1,11 @@
+apiVersion: storage.k8s.io/v1
+kind: CSIDriver
+metadata:
+  name: {{ .Values.driver.name }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+spec:
+  attachRequired: true
+  podInfoOnMount: false
+  volumeLifecycleModes:
+    - Persistent
@@ -0,0 +1,130 @@
+{{- include "kloud-csi.validateRequired" . }}
+apiVersion: apps/v1
+kind: DaemonSet
+metadata:
+  name: {{ include "kloud-csi.nodeName" . }}
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+    app.kubernetes.io/component: node
+spec:
+  selector:
+    matchLabels:
+      {{- include "kloud-csi.selectorLabels" . | nindent 6 }}
+      app.kubernetes.io/component: node
+  template:
+    metadata:
+      labels:
+        {{- include "kloud-csi.selectorLabels" . | nindent 8 }}
+        app.kubernetes.io/component: node
+        {{- with .Values.podLabels }}
+        {{- toYaml . | nindent 8 }}
+        {{- end }}
+      {{- with .Values.podAnnotations }}
+      annotations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+    spec:
+      serviceAccountName: {{ include "kloud-csi.nodeServiceAccountName" . }}
+      priorityClassName: {{ .Values.node.priorityClassName }}
+      hostNetwork: true
+      hostPID: true
+      {{- with .Values.node.tolerations }}
+      tolerations:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.nodeSelector }}
+      nodeSelector:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      {{- with .Values.affinity }}
+      affinity:
+        {{- toYaml . | nindent 8 }}
+      {{- end }}
+      containers:
+        - name: kloud-csi-plugin
+          image: {{ include "kloud-csi.driverImage" . }}
+          imagePullPolicy: {{ .Values.image.pullPolicy }}
+          securityContext:
+            privileged: true
+          args:
+            - --config-file
+            - /etc/kloud-csi/driver.hcl
+          env:
+            - name: KKS_CSI_SERVER_URL
+              value: {{ .Values.serverURL | quote }}
+            - name: KKS_CSI_ACCESS_TOKEN
+              valueFrom:
+                secretKeyRef:
+                  name: {{ default (printf "%s-config" (include "kloud-csi.fullname" .)) .Values.existingSecret }}
+                  key: {{ .Values.existingSecretAccessTokenKey }}
+            - name: KKS_CSI_DRIVER_MODE
+              value: node
+            - name: KKS_CSI_DRIVER_ENDPOINT
+              value: unix:///csi/csi.sock
+            - name: KKS_CSI_DRIVER_NAME
+              value: {{ .Values.driver.name | quote }}
+            - name: KKS_CSI_NODE_ID
+              valueFrom:
+                fieldRef:
+                  fieldPath: spec.nodeName
+          volumeMounts:
+            - name: plugin-dir
+              mountPath: /csi
+            - name: kubelet-dir
+              mountPath: /var/lib/kubelet
+              mountPropagation: Bidirectional
+            - name: device-dir
+              mountPath: /dev
+            - name: config
+              mountPath: /etc/kloud-csi
+          {{- with .Values.node.resources }}
+          resources:
+            {{- toYaml . | nindent 12 }}
+          {{- end }}
+        - name: node-driver-registrar
+          image: {{ .Values.sidecars.registrar.repository }}:{{ .Values.sidecars.registrar.tag }}
+          args:
+            - --v=2
+            - --csi-address=/csi/csi.sock
+            - --kubelet-registration-path=/var/lib/kubelet/plugins/{{ .Values.driver.name }}/csi.sock
+          env:
+            - name: KUBE_NODE_NAME
+              valueFrom:
+                fieldRef:
+                  fieldPath: spec.nodeName
+          volumeMounts:
+            - name: plugin-dir
+              mountPath: /csi
+            - name: registration-dir
+              mountPath: /registration
+            - name: kubelet-dir
+              mountPath: /var/lib/kubelet
+              mountPropagation: HostToContainer
+        - name: liveness-probe
+          image: {{ .Values.sidecars.livenessProbe.repository }}:{{ .Values.sidecars.livenessProbe.tag }}
+          args:
+            - --csi-address=/csi/csi.sock
+            - --health-port=9809
+          volumeMounts:
+            - name: plugin-dir
+              mountPath: /csi
+      volumes:
+        - name: plugin-dir
+          hostPath:
+            path: /var/lib/kubelet/plugins/{{ .Values.driver.name }}/
+            type: DirectoryOrCreate
+        - name: registration-dir
+          hostPath:
+            path: /var/lib/kubelet/plugins_registry/
+            type: Directory
+        - name: kubelet-dir
+          hostPath:
+            path: /var/lib/kubelet
+            type: Directory
+        - name: device-dir
+          hostPath:
+            path: /dev
+        - name: config
+          configMap:
+            name: {{ include "kloud-csi.fullname" . }}-driver
@@ -0,0 +1,60 @@
+{{- if .Values.rbac.create }}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ include "kloud-csi.controllerServiceAccountName" . }}
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+    app.kubernetes.io/component: controller
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: {{ include "kloud-csi.fullname" . }}-controller
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+rules:
+  - apiGroups: [""]
+    resources: ["persistentvolumes"]
+    verbs: ["get", "list", "watch", "create", "delete", "patch"]
+  - apiGroups: [""]
+    resources: ["persistentvolumeclaims"]
+    verbs: ["get", "list", "watch", "update", "patch"]
+  - apiGroups: [""]
+    resources: ["persistentvolumeclaims/status"]
+    verbs: ["update", "patch"]
+  - apiGroups: [""]
+    resources: ["nodes"]
+    verbs: ["get", "list", "watch"]
+  - apiGroups: ["storage.k8s.io"]
+    resources: ["storageclasses"]
+    verbs: ["get", "list", "watch"]
+  - apiGroups: [""]
+    resources: ["events"]
+    verbs: ["list", "watch", "create", "update", "patch"]
+  - apiGroups: ["storage.k8s.io"]
+    resources: ["volumeattachments"]
+    verbs: ["get", "list", "watch", "update", "patch"]
+  - apiGroups: ["storage.k8s.io"]
+    resources: ["volumeattachments/status"]
+    verbs: ["patch"]
+  - apiGroups: ["coordination.k8s.io"]
+    resources: ["leases"]
+    verbs: ["get", "watch", "list", "create", "update", "patch"]
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: {{ include "kloud-csi.fullname" . }}-controller
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: {{ include "kloud-csi.fullname" . }}-controller
+subjects:
+  - kind: ServiceAccount
+    name: {{ include "kloud-csi.controllerServiceAccountName" . }}
+    namespace: {{ .Release.Namespace }}
+{{- end }}
@@ -0,0 +1,36 @@
+{{- if .Values.rbac.create }}
+apiVersion: v1
+kind: ServiceAccount
+metadata:
+  name: {{ include "kloud-csi.nodeServiceAccountName" . }}
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+    app.kubernetes.io/component: node
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRole
+metadata:
+  name: {{ include "kloud-csi.fullname" . }}-node
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+rules:
+  - apiGroups: [""]
+    resources: ["nodes"]
+    verbs: ["get", "list", "watch"]
+---
+apiVersion: rbac.authorization.k8s.io/v1
+kind: ClusterRoleBinding
+metadata:
+  name: {{ include "kloud-csi.fullname" . }}-node
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+roleRef:
+  apiGroup: rbac.authorization.k8s.io
+  kind: ClusterRole
+  name: {{ include "kloud-csi.fullname" . }}-node
+subjects:
+  - kind: ServiceAccount
+    name: {{ include "kloud-csi.nodeServiceAccountName" . }}
+    namespace: {{ .Release.Namespace }}
+{{- end }}
@@ -0,0 +1,13 @@
+{{- include "kloud-csi.validateRequired" . }}
+{{- if not .Values.existingSecret }}
+apiVersion: v1
+kind: Secret
+metadata:
+  name: {{ include "kloud-csi.fullname" . }}-config
+  namespace: {{ .Release.Namespace }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+type: Opaque
+stringData:
+  access-token: {{ required "accessToken is required when existingSecret is not set" .Values.accessToken | quote }}
+{{- end }}
@@ -0,0 +1,16 @@
+{{- if .Values.storageClass.enabled }}
+apiVersion: storage.k8s.io/v1
+kind: StorageClass
+metadata:
+  name: {{ .Values.storageClass.name }}
+  {{- if .Values.storageClass.isDefault }}
+  annotations:
+    storageclass.kubernetes.io/is-default-class: "true"
+  {{- end }}
+  labels:
+    {{- include "kloud-csi.labels" . | nindent 4 }}
+provisioner: {{ .Values.driver.name }}
+reclaimPolicy: {{ .Values.storageClass.reclaimPolicy }}
+volumeBindingMode: {{ .Values.storageClass.volumeBindingMode }}
+allowVolumeExpansion: {{ .Values.storageClass.allowVolumeExpansion }}
+{{- end }}
@@ -0,0 +1,76 @@
+# Kloud CSI driver — install on each user Kubernetes cluster.
+#
+# Required:
+#   serverURL     — URL of the management CSI server (from your Kloud cluster details)
+#   accessToken   — cluster csi_access_token (create a Kubernetes secret or set here)
+#
+# Example:
+#   helm install kloud-csi ./charts/kloud-csi \
+#     --namespace kube-system \
+#     --set serverURL=http://10.0.0.5:9766 \
+#     --set accessToken="$(kubectl get secret ... -o jsonpath='{.data.token}' | base64 -d)"
+
+nameOverride: ""
+fullnameOverride: ""
+
+image:
+  repository: ghcr.io/KubelanCloud/kks-csi-plugin
+  tag: "latest"
+  pullPolicy: IfNotPresent
+
+serverURL: ""
+accessToken: ""
+existingSecret: ""
+existingSecretAccessTokenKey: access-token
+
+driver:
+  name: storage.csi.kloud.team
+
+sidecars:
+  provisioner:
+    repository: registry.k8s.io/sig-storage/csi-provisioner
+    tag: v5.1.0
+  attacher:
+    repository: registry.k8s.io/sig-storage/csi-attacher
+    tag: v4.7.0
+  registrar:
+    repository: registry.k8s.io/sig-storage/csi-node-driver-registrar
+    tag: v2.12.0
+  livenessProbe:
+    repository: registry.k8s.io/sig-storage/livenessprobe
+    tag: v2.13.0
+
+storageClass:
+  enabled: true
+  name: kloud-csi
+  isDefault: false
+  reclaimPolicy: Delete
+  volumeBindingMode: WaitForFirstConsumer
+  allowVolumeExpansion: false
+
+controller:
+  replicas: 1
+  resources: {}
+
+node:
+  resources: {}
+  priorityClassName: system-node-critical
+  tolerations:
+    - operator: Exists
+
+serviceAccount:
+  controller:
+    create: true
+    name: ""
+  node:
+    create: true
+    name: ""
+
+rbac:
+  create: true
+
+podLabels: {}
+podAnnotations: {}
+
+nodeSelector: {}
+affinity: {}