Skip to content

Commit

Permalink
update docs for new releases
Browse files Browse the repository at this point in the history
  • Loading branch information
songjiaxun committed Jan 11, 2024
1 parent 26fc89e commit c7da043
Show file tree
Hide file tree
Showing 3 changed files with 22 additions and 6 deletions.
22 changes: 17 additions & 5 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,11 +55,23 @@ Currently, the driver does not support [Dynamic Volume Provisioning](https://kub
Status: General Availability

### GKE Compatibility
| Cloud Storage FUSE CSI Driver Version | Status | Cloud Storage FUSE Version | Supported GKE Kubernetes Version |
| ---------------------------------------------------------------------------------------- | ---------- | ------------------------------------------------------------------------------ | -------------------------------- |
| [v0.1.2](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.2) | Deprecated | [v0.42.3](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v0.42.3) | None |
| [v0.1.3](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.3) | Deprecated | [v0.42.4](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v0.42.4) | None |
| [v0.1.4](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.4) | GA | [v1.0.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.0.0) | 1.26.3-gke.400 or later |
| CSI Driver Version | Status | Release Date | Cloud Storage FUSE Version | Earliest GKE 1.24 | Earliest GKE 1.25 | Earliest GKE 1.26 | Earliest GKE 1.27 | Earliest GKE 1.28 | Earliest GKE 1.29 |
| ------------------------------------------------------------------------------------------ | ---------- | ------------ | ------------------------------------------------------------------------------ | ------------------- | ------------------- | ------------------- | ------------------ | ------------------ | ------------------ |
| [v0.1.2](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.2) | Deprecated | N/A | [v0.42.3](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v0.42.3) | None | None | None | None | None | None |
| [v0.1.3](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.3) | Deprecated | N/A | [v0.42.4](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v0.42.4) | None | None | None | None | None | None |
| [v0.1.4](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.4) | Released | 2023-08-15 | [v1.0.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.0.0) | 1.24.10-gke.2300 | 1.25.10-gke.1200 | 1.26.5-gke.2100 | 1.27.2-gke.1200 | 1.28.1-gke.200 | None |
| [v0.1.5](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.5) | Abandoned | N/A | [v1.2.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.2.0) | None | None | None | None | None | None |
| [v0.1.6](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.6) | Released | 2023-10-25 | [v1.2.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.2.0) | 1.24.17-gke.2144000 | 1.25.14-gke.1462000 | 1.26.9-gke.1483000 | 1.27.6-gke.1487000 | 1.28.2-gke.1078000 | None |
| [v0.1.7](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.7) | Released | 2023-11-25 | [v1.2.1](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.2.1) | 1.24.17-gke.2266000 | 1.25.15-gke.1144000 | 1.26.10-gke.1101000 | 1.27.7-gke.1121000 | 1.28.3-gke.1260000 | None |
| [v0.1.8](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.8) | Released | 2023-12-08 | [v1.2.1](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.2.1) | 1.24.17-gke.2339000 | 1.25.16-gke.1011000 | 1.26.10-gke.1227000 | 1.27.7-gke.1279000 | 1.28.3-gke.1430000 | 1.29.0-gke.1003000 |
| [v0.1.9](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.9) | Abandoned | N/A | [v1.3.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.3.0) | None | None | None | None | None | None |
| [v0.1.10](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.10) | Abandoned | N/A | [v1.3.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.3.0) | None | None | None | None | None | None |
| [v0.1.11](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.11) | Abandoned | N/A | [v1.4.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.4.0) | None | None | None | None | None | None |
| [v0.1.12](https://github.com/GoogleCloudPlatform/gcs-fuse-csi-driver/releases/tag/v0.1.12) | Releasing | 2024-01-25 | [v1.4.0](https://github.com/GoogleCloudPlatform/gcsfuse/releases/tag/v1.4.0) | 1.24.17-gke.2477000 | 1.25.16-gke.1253000 | 1.26.12-gke.1107000 | 1.27.9-gke.1085000 | 1.28.5-gke.1242000 | 1.29.0-gke.1358000 |

> Note: The above GKE versions may not be valid any more, please follow the [GKE documentation](https://cloud.google.com/kubernetes-engine/docs/concepts/release-channels#what_versions_are_available_in_a_channel) to check what versions are available in a channel.
The new CSI driver version will be first available in GKE Rapid channel on its release date. For Regular and Stable channels, plan for a 4-week and 12-week wait respectively.

## Get Started
- GKE documentation: [Access Cloud Storage buckets with the Cloud Storage FUSE CSI driver](https://cloud.google.com/kubernetes-engine/docs/how-to/persistent-volumes/cloud-storage-fuse-csi-driver)
Expand Down
4 changes: 4 additions & 0 deletions docs/authentication.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,6 +35,8 @@ See the GKE documentation: [Access Cloud Storage buckets with the Cloud Storage
workloadPool: ${PROJECT_ID}.svc.id.goog
```

If not, [have Workload Identity enabled](https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity#enable).

- Make sure the DaemonSet `gke-metadata-server` is running on your node pool:

```bash
Expand All @@ -48,6 +50,8 @@ See the GKE documentation: [Access Cloud Storage buckets with the Cloud Storage
gke-metadata-server 3 3 3 3 3 beta.kubernetes.io/os=linux,iam.gke.io/gke-metadata-server-enabled=true 17d
```

If not, [have GKE metadata server enabled on your node pool](https://cloud.google.com/kubernetes-engine/docs/how-to/workload-identity#migrate_applications_to).

- Check whether the GCP Service Account was created:

```bash
Expand Down
2 changes: 1 addition & 1 deletion docs/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -57,7 +57,7 @@ limitations under the License.
- Run the following command to install the latest driver with version `v0.1.4`. The driver will be installed under a new namespace `gcs-fuse-csi-driver`. The installation may take a few minutes.
```bash
# Replace <cluster-project-id> with your cluster project ID.
make install STAGINGVERSION=v0.1.4 PROJECT=<cluster-project-id>
make install STAGINGVERSION=v0.1.12 PROJECT=<cluster-project-id>
```

- If you would like to build your own images, follow the [Cloud Storage FUSE CSI Driver Development Guide](development.md) to build and push the images. Run the following command to install the driver.
Expand Down

0 comments on commit c7da043

Please sign in to comment.