Skip to content
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

Open
wants to merge 65 commits into
base: dev
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from 41 commits
Commits
Show all changes
65 commits
Select commit Hold shift + click to select a range
7c025c8
feat(CSI-300): add arm64 support
sergeyberezansky Oct 29, 2024
0a35d77
feat(CSI-300): add arm64 support (#379)
sergeyberezansky Nov 7, 2024
5c7c89f
refactor(CSI-305): change mount Map logic for WEKAFS to align with NF…
sergeyberezansky Oct 31, 2024
e327c44
refactor(CSI-305): add localContainerName on NewMount
sergeyberezansky Nov 3, 2024
7efb4cd
refactor(CSI-305): cache containerName on API client object
sergeyberezansky Nov 3, 2024
492ef8a
refactor(CSI-305): simplify EnsureLocalContainer for NewMount to avoi…
sergeyberezansky Nov 3, 2024
66a1a81
refactor(CSI-305): do not fill in containerName if cluster does not s…
sergeyberezansky Nov 3, 2024
efd5d7d
refactor(CSI-305): ensure that containerName is taken from correct mo…
sergeyberezansky Nov 3, 2024
dbdd772
tests(CSI-305): add tests for GetMountContainerNameFromActualMountPoint
sergeyberezansky Nov 3, 2024
9ea969b
chore: autopublish 2024-11-07T10:25:54Z
wekabot Nov 7, 2024
4851adb
refactor(CSI-305): change mount Map logic for WEKAFS to align with NF…
sergeyberezansky Nov 7, 2024
ac82507
Add Storage class configurations file
AriAttias Nov 19, 2024
01a16d7
Update storage-class-configurations.md
AriAttias Nov 19, 2024
c54e772
Update storage-class-configurations.md
AriAttias Nov 19, 2024
099b662
Update storage-class-configurations.md
AriAttias Nov 19, 2024
64ec07f
Update storage-class-configurations.md
AriAttias Nov 19, 2024
a6f0097
Add files via upload
AriAttias Nov 19, 2024
5f6bc2a
Add image
AriAttias Nov 19, 2024
bdc2c43
Update storage-class-configurations.md
AriAttias Nov 19, 2024
eb5fe68
Add files via upload
AriAttias Nov 19, 2024
3f6f795
Update migrate-legacy-csi-volumes.sh
AriAttias Nov 19, 2024
2d5f436
Update migrate-legacy-csi-volumes.sh
AriAttias Nov 19, 2024
c44d6ed
Update upgrade-legacy-pv.md: fix links
AriAttias Nov 19, 2024
fb27131
Update storage-class-configurations.md: fix links
AriAttias Nov 19, 2024
205daec
Update storage-class-configurations.md fix linx
AriAttias Nov 19, 2024
b0c8165
Update storage-class-configurations.md
AriAttias Nov 19, 2024
0454366
Update README.md: removed reference to doc.weka.io
AriAttias Nov 21, 2024
07e684d
Update NFS.md: adjusted for TW clarity
AriAttias Nov 21, 2024
ce4c77d
Update NFS.md: added ```
AriAttias Nov 21, 2024
e8cfe6e
Update NFS.mdL typo
AriAttias Nov 21, 2024
0404b51
Update NFS.md: format typo
AriAttias Nov 21, 2024
7a10b46
Update README.md: migrated from the doc
AriAttias Nov 21, 2024
d2bf7d1
Update README.md: edit links
AriAttias Nov 21, 2024
b66375c
Update README.md: fix link
AriAttias Nov 21, 2024
7766d7b
Update README.md: fix format
AriAttias Nov 21, 2024
696c1c5
Add the deployment page
AriAttias Nov 27, 2024
ee61c28
Update deployment.md
AriAttias Nov 27, 2024
be0907f
Update deployment.md
AriAttias Nov 27, 2024
45dd874
Update deployment.md
AriAttias Nov 27, 2024
0c87443
Update deployment.md
AriAttias Nov 27, 2024
90bc16d
Update README.md: removed references to the official doc
AriAttias Nov 27, 2024
3977868
Update README.md: reworded some sentences
AriAttias Nov 28, 2024
65f4626
Update README.md.gotmpl
AriAttias Dec 16, 2024
8e72f7d
Update NFS.md
AriAttias Dec 16, 2024
6c82443
Update NFS.md
AriAttias Dec 16, 2024
935a53c
Update NFS.md
AriAttias Dec 16, 2024
350572d
Update migrate-legacy-csi-volumes.sh
AriAttias Dec 16, 2024
4bde915
Update upgrade-legacy-pv.md
AriAttias Dec 16, 2024
453b4df
Update README.md
AriAttias Dec 16, 2024
94b55f3
Update storage-class-configurations.md
AriAttias Dec 16, 2024
c4ea5fa
Update upgrade-legacy-pv.md
AriAttias Dec 16, 2024
3b086b2
Add CSI-k8s-wekafs-nfs
AriAttias Dec 17, 2024
e6a0ba2
Delete docs/csi-images/k8s-multiple-clusters.png
AriAttias Dec 17, 2024
490ff71
Update storage-class-configurations.md
AriAttias Dec 17, 2024
65699f8
Rename CSI-k8s-wekafs-nfs.png to csi-k8s-wekafs-nfs.png
AriAttias Dec 17, 2024
94f36fe
Update storage-class-configurations.md
AriAttias Dec 17, 2024
0eefc5b
Replace the image
AriAttias Dec 17, 2024
bdc5dec
Update storage-class-configurations.md
AriAttias Dec 17, 2024
d683fea
Update storage-class-configurations.md
AriAttias Dec 17, 2024
3d7f8d2
Update deployment.md (per David's comment)
AriAttias Dec 22, 2024
2f535cc
Update deployment.md: modified title
AriAttias Dec 22, 2024
a8a09e5
Update README.md.gotmpl
AriAttias Dec 22, 2024
2cd55aa
Update README.md
AriAttias Dec 22, 2024
448ffaa
Update README.md-fix link
AriAttias Dec 22, 2024
5d26eb5
Update README.md.gotmpl-fix link
AriAttias Dec 22, 2024
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 8 additions & 5 deletions .github/workflows/pull-request.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -32,6 +32,9 @@ jobs:
fi

# DOCKER BUILD & PUSH
- name: Set up QEMU
uses: docker/setup-qemu-action@v3

- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3
- name: Login to Quay.io
Expand All @@ -56,6 +59,7 @@ jobs:
provenance: false # https://issues.redhat.com/browse/PROJQUAY-5013 quay doesn't support it
build-args: |
VERSION='${{ steps.auto_version.outputs.version }}'
platforms: linux/amd64,linux/arm64

# HELM
- name: Get Helm chart version
Expand All @@ -66,12 +70,11 @@ jobs:
- name: Update Helm chart version
uses: mikefarah/yq@master
with:
cmd: |
cmd: |
BASEDIR=charts/csi-wekafsplugin
DRIVER_VERSION="$(echo ${{ steps.version.outputs.version }} | sed 's/^v//1')"
CHART_VERSION="${{ steps.helm_version.outputs.helm_version }}"
APP_VERSION="${{ steps.version.outputs.version }}"

yq -i '.version = "'$CHART_VERSION'"' $BASEDIR/Chart.yaml
yq -i '.appVersion = "'$APP_VERSION'"' $BASEDIR/Chart.yaml
yq -i '.sources[0] = "https://github.com/weka/csi-wekafs/tree/v$CHART_VERSION/charts/csi-wekafsplugin"' $BASEDIR/Chart.yaml
Expand All @@ -88,7 +91,7 @@ jobs:
options: -v ${{ github.workspace }}:/data
run: |
cd /data
helm-docs -s file -c charts -o ../../README.md -t ../README.md.gotmpl
helm-docs -s file -c charts -o ../../README.md -t ../README.md.gotmpl
helm-docs -s file -c charts

- name: Set up Helm
Expand Down Expand Up @@ -142,7 +145,7 @@ jobs:
S3_BUCKET_NAME=${{ secrets.S3_BUCKET_NAME }}
URL="https://$S3_BUCKET_NAME.s3.$AWS_REGION.amazonaws.com"
echo "filename=$FILENAME" >> $GITHUB_OUTPUT
echo "url=$URL" >> $GITHUB_OUTPUT
echo "url=$URL" >> $GITHUB_OUTPUT

- name: Install AWS CLI
id: install-aws-cli
Expand All @@ -157,7 +160,7 @@ jobs:
export AWS_SECRET_ACCESS_KEY="${{ secrets.AWS_SECRET_ACCESS_KEY}}"
export AWS_REGION="${{ secrets.AWS_REGION }}"
aws s3 cp ${{ steps.helm-package.outputs.filename }} "s3://${{ vars.AWS_BUCKET }}/"
echo "link=https://${{ vars.AWS_BUCKET }}.s3.${AWS_REGION}.amazonaws.com/${{ steps.helm-package.outputs.filename }}" >> $GITHUB_OUTPUT
echo "link=https://${{ vars.AWS_BUCKET }}.s3.${AWS_REGION}.amazonaws.com/${{ steps.helm-package.outputs.filename }}" >> $GITHUB_OUTPUT
if: steps.helm-test.outputs.passed == 'true'

- uses: rtCamp/action-slack-notify@v2
Expand Down
7 changes: 7 additions & 0 deletions .github/workflows/push-dev.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -37,14 +37,19 @@ jobs:
fi

# DOCKER BUILD & PUSH
- name: Set up QEMU
uses: docker/setup-qemu-action@v2

- name: Set up Docker Buildx
uses: docker/setup-buildx-action@v3

- name: Login to Quay.io
uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKER_USERNAME }}
password: ${{ secrets.DOCKER_PASSWORD }}
registry: quay.io

- name: Build and push
uses: docker/build-push-action@v6
with:
Expand All @@ -61,13 +66,15 @@ jobs:
provenance: false # https://issues.redhat.com/browse/PROJQUAY-5013 quay doesn't support it
build-args: |
VERSION='${{ steps.auto_version.outputs.version }}'
platforms: linux/amd64,linux/arm64

# HELM
- name: Get Helm chart version
id: helm_version
run: |
out="$(echo "${{ steps.auto_version.outputs.version }}" | sed 's/^v//1')"
echo "helm_version=$out" >> $GITHUB_OUTPUT

- name: Update Helm chart version
uses: mikefarah/yq@master
with:
Expand Down
5 changes: 5 additions & 0 deletions .github/workflows/release.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -133,7 +133,11 @@ jobs:
cat changelog1 > charts/csi-wekafsplugin/CHANGELOG.md
mv CHANGELOG.md RELEASE.md

- name: Set up QEMU
uses: docker/setup-qemu-action@v2

- uses: docker/setup-buildx-action@v3

- uses: docker/login-action@v3
with:
username: ${{ secrets.DOCKER_USERNAME }}
Expand All @@ -152,6 +156,7 @@ jobs:
revision='${{ steps.set_version.outputs.version }}'
build-args: |
VERSION='${{ steps.set_version.outputs.version }}'
platforms: linux/amd64,linux/arm64

- name: helm-docs
uses: addnab/docker-run-action@v3
Expand Down
10 changes: 4 additions & 6 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
# CSI WekaFS Driver
Helm chart for Deployment of WekaIO Container Storage Interface (CSI) plugin for WekaFS - the world fastest filesystem

![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)
[![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)

Expand All @@ -18,6 +18,7 @@ https://github.com/weka/csi-wekafs
- Kubernetes cluster of version 1.20 or later is recommended. Minimum version is 1.17
- Access to terminal with `kubectl` installed
- Weka system pre-configured and Weka client installed and registered in cluster for each Kubernetes node
- Both AMD64 and ARM64 platforms are supported

## Deployment
- [Helm public repo](https://artifacthub.io/packages/helm/csi-wekafs/csi-wekafsplugin) (recommended)
Expand All @@ -28,9 +29,6 @@ https://github.com/weka/csi-wekafs
- [SELinux Support & Installation Notes](selinux/README.md)
- [Using Weka CSI Plugin with NFS transport](docs/NFS.md)

## Additional Documentation
- [Official Weka CSI Plugin documentation](https://docs.weka.io/appendices/weka-csi-plugin)

Copy link
Collaborator Author

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

Copy link
Collaborator

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.

## Building the binaries
If you want to build the driver yourself, you can do so with the following command from the root directory:

Expand All @@ -44,7 +42,7 @@ make build
|-----|------|---------|-------------|
| 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 |
Expand All @@ -53,7 +51,7 @@ make build
| 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) |
Expand Down
1 change: 1 addition & 0 deletions README.md.gotmpl
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@
- Kubernetes cluster of version 1.20 or later is recommended. Minimum version is 1.17
- Access to terminal with `kubectl` installed
- Weka system pre-configured and Weka client installed and registered in cluster for each Kubernetes node
- Both AMD64 and ARM64 platforms are supported

## Deployment
- [Helm public repo](https://artifacthub.io/packages/helm/csi-wekafs/csi-wekafsplugin) (recommended)
Expand Down
4 changes: 2 additions & 2 deletions charts/csi-wekafsplugin/Chart.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -10,8 +10,8 @@ sources:
home: https://github.com/weka/csi-wekafs
icon: https://weka.github.io/csi-wekafs/logo.png
type: application
version: 2.5.1-SNAPSHOT.41.bddf9ed
appVersion: v2.5.1-SNAPSHOT.41.bddf9ed
version: 2.5.1-SNAPSHOT.44.0a35d77
appVersion: v2.5.1-SNAPSHOT.44.0a35d77
keywords: [storage, filesystem, HPC]
annotations:
artifacthub.io/category: "storage"
Expand Down
12 changes: 4 additions & 8 deletions charts/csi-wekafsplugin/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down Expand Up @@ -36,23 +36,19 @@ helm install csi-wekafsplugin csi-wekafs/csi-wekafsplugin --namespace csi-wekafs
>
> 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)


## 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)

Copy link
Collaborator Author

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

Copy link
Collaborator

Choose a reason for hiding this comment

The 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.
Why does the comment appear twice?

## 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 |
Expand All @@ -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) |
Expand Down
2 changes: 1 addition & 1 deletion charts/csi-wekafsplugin/values.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ dynamicProvisionPath: "csi-volumes"
# -- Name of the driver (and provisioner)
csiDriverName: "csi.weka.io"
# -- CSI driver version
csiDriverVersion: &csiDriverVersion 2.5.1-SNAPSHOT.41.bddf9ed
csiDriverVersion: &csiDriverVersion 2.5.1-SNAPSHOT.44.0a35d77
images:
# -- CSI liveness probe sidecar image URL
livenessprobesidecar: registry.k8s.io/sig-storage/livenessprobe:v2.14.0
Expand Down
Loading
Loading