-
Notifications
You must be signed in to change notification settings - Fork 8
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
docs: migrate docs to GitHub repository #403
base: dev
Are you sure you want to change the base?
Changes from all commits
7c025c8
0a35d77
5c7c89f
e327c44
7efb4cd
492ef8a
66a1a81
efd5d7d
dbdd772
9ea969b
4851adb
ac82507
01a16d7
c54e772
099b662
64ec07f
a6f0097
5f6bc2a
bdc2c43
eb5fe68
3f6f795
2d5f436
c44d6ed
fb27131
205daec
b0c8165
0454366
07e684d
ce4c77d
e8cfe6e
0404b51
7a10b46
d2bf7d1
b66375c
7766d7b
696c1c5
ee61c28
be0907f
45dd874
0c87443
90bc16d
3977868
65f4626
8e72f7d
6c82443
935a53c
350572d
4bde915
453b4df
94b55f3
c4ea5fa
3b086b2
e6a0ba2
490ff71
65699f8
94f36fe
0eefc5b
bdc5dec
d683fea
3d7f8d2
2f535cc
a8a09e5
2cd55aa
448ffaa
5d26eb5
File filter
Filter by extension
Conversations
Jump to
Diff view
Diff view
There are no files selected for viewing
Original file line number | Diff line number | Diff line change |
---|---|---|
|
@@ -3,7 +3,7 @@ Helm chart for Deployment of WekaIO Container Storage Interface (CSI) plugin for | |
|
||
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](https://opensource.org/licenses/Apache-2.0) | ||
[![Artifact HUB](https://img.shields.io/endpoint?url=https://artifacthub.io/badge/repository/csi-wekafs)](https://artifacthub.io/packages/search?repo=csi-wekafs) | ||
![Version: 2.5.1-SNAPSHOT.41.bddf9ed](https://img.shields.io/badge/Version-2.5.1--SNAPSHOT.41.bddf9ed-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: v2.5.1-SNAPSHOT.41.bddf9ed](https://img.shields.io/badge/AppVersion-v2.5.1--SNAPSHOT.41.bddf9ed-informational?style=flat-square) | ||
![Version: 2.5.1-SNAPSHOT.44.0a35d77](https://img.shields.io/badge/Version-2.5.1--SNAPSHOT.44.0a35d77-informational?style=flat-square) ![Type: application](https://img.shields.io/badge/Type-application-informational?style=flat-square) ![AppVersion: v2.5.1-SNAPSHOT.44.0a35d77](https://img.shields.io/badge/AppVersion-v2.5.1--SNAPSHOT.44.0a35d77-informational?style=flat-square) | ||
|
||
## Homepage | ||
https://github.com/weka/csi-wekafs | ||
|
@@ -15,44 +15,40 @@ https://github.com/weka/csi-wekafs | |
| WekaIO, Inc. | <[email protected]> | <https://weka.io> | | ||
|
||
## Pre-requisite | ||
- Kubernetes cluster of version 1.18 and up, 1.19 and up recommended | ||
- Helm v3 must be installed and configured properly | ||
- Weka system pre-configured and Weka client installed and registered in cluster for each Kubernetes node | ||
- **Kubernetes cluster**: Version 1.18 or later (version 1.19 or later is recommended). | ||
- **Helm**: Helm v3 must be installed and properly configured. | ||
- **WEKA system**: The WEKA system must be pre-configured, with the WEKA client installed and registered on each Kubernetes node within the cluster. | ||
|
||
## Deployment | ||
```shell | ||
helm repo add csi-wekafs https://weka.github.io/csi-wekafs | ||
helm install csi-wekafsplugin csi-wekafs/csi-wekafsplugin --namespace csi-wekafsplugin --create-namespace [--set selinuxSupport=<off | mixed | enforced>] | ||
``` | ||
|
||
> **NOTE:** Since version 0.8.0, Weka CSI plugin supports installation on SELinux-enabled Kubernetes clusters | ||
> Refer to [SELinux Support & Installation Notes](https://github.com/weka/csi-wekafs/blob/master/selinux/README.md) for additional information | ||
> **NOTE:** As of version 0.8.0, the WEKA CSI plugin supports installation on Kubernetes clusters with SELinux enabled. | ||
> For more details, refer to the [SELinux Support & Installation Notes](https://github.com/weka/csi-wekafs/blob/master/selinux/README.md). | ||
|
||
> **NOTE:** Since version 0.7.0, Weka CSI plugin transitions to API-based deployment model which requires API | ||
> connectivity and credentials parameters to be set in Storage Class. | ||
> **NOTE:** Starting with version 0.7.0, the WEKA CSI plugin adopts an API-based deployment model. | ||
> This model requires API connectivity and the configuration of credential parameters within the Storage Class. | ||
> | ||
> Kubernetes does not allow storage class modification for existing volumes, hence the | ||
> recommended upgrade process is re-deploying new persistent volumes based on new storage class format. | ||
> Kubernetes does not support modifying the storage class of existing volumes. | ||
> Therefore, the recommended upgrade process involves re-deploying new persistent volumes using the updated storage class format. | ||
> | ||
> However, for sake of more convenient migration, a `legacySecretName` parameter can be set that will | ||
> bind existing legacy volumes to a Weka cluster API and allow volume expansion. | ||
> | ||
> For further information, refer [Official Weka CSI Plugin documentation](https://docs.weka.io/appendices/weka-csi-plugin) | ||
> To facilitate a smoother migration process, the legacySecretName parameter can be configured. | ||
> This parameter binds existing legacy volumes to the Weka Cluster API, enabling volume expansion. | ||
|
||
|
||
## Usage | ||
- [Deploy an Example application](https://github.com/weka/csi-wekafs/blob/master/docs/usage.md) | ||
- [SELinux Support & Installation Notes](https://github.com/weka/csi-wekafs/blob/master/selinux/README.md) | ||
|
||
## Additional Documentation | ||
- [Official Weka CSI Plugin documentation](https://docs.weka.io/appendices/weka-csi-plugin) | ||
|
||
There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. Same should be done on README.md.gotmpl There was a problem hiding this comment. Choose a reason for hiding this commentThe reason will be displayed to describe this comment to others. Learn more. I've already removed the reference to the official doc from the README.md.gotml. |
||
## Values | ||
|
||
| Key | Type | Default | Description | | ||
|-----|------|---------|-------------| | ||
| dynamicProvisionPath | string | `"csi-volumes"` | Directory in root of file system where dynamic volumes are provisioned | | ||
| csiDriverName | string | `"csi.weka.io"` | Name of the driver (and provisioner) | | ||
| csiDriverVersion | string | `"2.5.1-SNAPSHOT.41.bddf9ed"` | CSI driver version | | ||
| csiDriverVersion | string | `"2.5.1-SNAPSHOT.44.0a35d77"` | CSI driver version | | ||
| images.livenessprobesidecar | string | `"registry.k8s.io/sig-storage/livenessprobe:v2.14.0"` | CSI liveness probe sidecar image URL | | ||
| images.attachersidecar | string | `"registry.k8s.io/sig-storage/csi-attacher:v4.7.0"` | CSI attacher sidecar image URL | | ||
| images.provisionersidecar | string | `"registry.k8s.io/sig-storage/csi-provisioner:v5.1.0"` | CSI provisioner sidecar image URL | | ||
|
@@ -61,7 +57,7 @@ helm install csi-wekafsplugin csi-wekafs/csi-wekafsplugin --namespace csi-wekafs | |
| images.snapshottersidecar | string | `"registry.k8s.io/sig-storage/csi-snapshotter:v8.1.0"` | CSI snapshotter sidecar image URL | | ||
| images.nodeinfo | string | `"quay.io/weka.io/csi-wekafs"` | CSI nodeinfo sidecar image URL, used for reading node metadata | | ||
| images.csidriver | string | `"quay.io/weka.io/csi-wekafs"` | CSI driver main image URL | | ||
| images.csidriverTag | string | `"2.5.1-SNAPSHOT.41.bddf9ed"` | CSI driver tag | | ||
| images.csidriverTag | string | `"2.5.1-SNAPSHOT.44.0a35d77"` | CSI driver tag | | ||
| imagePullSecret | string | `""` | image pull secret required for image download. Must have permissions to access all images above. Should be used in case of private registry that requires authentication | | ||
| globalPluginTolerations | list | `[{"effect":"NoSchedule","key":"node-role.kubernetes.io/master","operator":"Exists"}]` | Tolerations for all CSI driver components | | ||
| controllerPluginTolerations | list | `[{"effect":"NoSchedule","key":"node-role.kubernetes.io/master","operator":"Exists"}]` | Tolerations for CSI controller component only (by default same as global) | | ||
|
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Same should be done on README.md.gotmpl
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've removed the reference to the official doc.