WARNING: Manual deployment of this driver to your GKE cluster is not recommended. Instead users should use GKE to automatically deploy and manage the GCE PD CSI Driver (see GKE Docs).
DISCLAIMER: Manual deployment of the driver to your cluster is not officially supported by Google.
The Google Compute Engine Persistent Disk CSI Driver is a CSI Specification compliant driver used by Container Orchestrators to manage the lifecycle of Google Compute Engine Persistent Disks.
Status: GA
Latest stable image: registry.k8s.io/cloud-provider-gcp/gcp-compute-persistent-disk-csi-driver:v1.20.0
| Driver Version | Kubernetes Version | Test Status |
|---|---|---|
| HEAD Latest | HEAD | |
| HEAD stable-master | HEAD (Migration ON) |
This plugin is compatible with CSI versions v1.2.0, v1.1.0, and v1.0.0
The latest stable of this driver is recommended for the latest stable Kubernetes version. For previous Kubernetes versions, we recommend the following driver versions.
| Kubernetes Version | PD CSI Driver Version |
|---|---|
| HEAD | v1.13.x |
| 1.29 | v1.12.x |
| 1.28 | v1.12.x |
| 1.27 | v1.10.x |
The manifest bundle which captures all the driver components (driver pod which includes the containers csi-provisioner, csi-resizer, csi-snapshotter, gce-pd-driver, csi-driver-registrar; csi driver object, rbacs, pod security policies etc) for the lastest stable release can be picked up from the master branch overlays directory.
See Github Issues
| Parameter | Values | Default | Description |
|---|---|---|---|
| type | Any PD type (see GCP documentation), eg pd-ssd pd-balanced |
pd-standard |
Type allows you to choose between standard Persistent Disks or Solid State Drive Persistent Disks |
| replication-type | none OR regional-pd |
none |
Replication type allows you to choose between Zonal Persistent Disks or Regional Persistent Disks |
| disk-encryption-kms-key | Fully qualified resource identifier for the key to use to encrypt new disks. | Empty string. | Encrypt disk using Customer Managed Encryption Key (CMEK). See GKE Docs for details. |
| labels | key1=value1,key2=value2 |
Labels allow you to assign custom GCE Disk labels. | |
| provisioned-iops-on-create | string (int64 format). Values typically between 10,000 and 120,000 | Indicates how many IOPS to provision for the disk. See the Extreme persistent disk documentation for details, including valid ranges for IOPS. | |
| provisioned-throughput-on-create | string (int64 format). Values typically between 1 and 7,124 mb per second | Indicates how much throughput to provision for the disk. See the hyperdisk documentation for details, including valid ranges for throughput. | |
| resource-tags | <parent_id1>/<tag_key1>/<tag_value1>,<parent_id2>/<tag_key2>/<tag_value2> |
Resource tags allow you to attach user-defined tags to each Compute Disk, Image and Snapshot. See Tags overview, Creating and managing tags. | |
| use-allowed-disk-topologies | true or false |
false |
Allows the use of specific disk topologies for provisioning. Must be used in combination with the --disk-topology=true flag on PDCSI binary to yield disk support labels in PV NodeAffinity blocks. |
This driver supports only one topology key:
topology.gke.io/zone
that represents availability by zone (e.g. us-central1-c, etc.).
GCE PD driver starts to support CSI Windows with [CSI Proxy] (https://github.com/kubernetes-csi/csi-proxy). It requires csi-proxy.exe to be installed on every Windows node. Please see more details in CSI Windows page (docs/kubernetes/user-guides/windows.md)
| Feature | Stage | Min Kubernetes Master Version | Min Kubernetes Nodes Version | Min Driver Version | Deployment Overlay |
|---|---|---|---|---|---|
| Snapshots | GA | 1.17 | Any | v1.0.0 | stable-1-21, stable-1-22, stable-1-23, stable-master |
| Clones | GA | 1.18 | Any | v1.4.0 | stable-1-21, stable-1-22, stable-1-23, stable-master |
| Resize (Expand) | Beta | 1.16 | 1.16 | v0.7.0 | stable-1-21, stable-1-22, stable-1-23, stable-master |
| Windows* | GA | 1.19 | 1.19 | v1.1.0 | stable-1-21, stable-1-22, stable-1-23, stable-master |
* For Windows, it is recommended to use this driver with CSI proxy v0.2.2+. The master version of driver requires disk v1beta2 group, which is only available in CSI proxy v0.2.2+
See Github Issues
As part of the deployment process, the driver is deployed in a newly created namespace by default. The namespace will be deleted as part of the cleanup process.
Controller-level and node-level deployments will both have priorityClassName set, and the corresponding priority value is close to the maximum possible for user-created PriorityClasses.
As noted in GCP PD documentation, ext4 and xfs are officially supported. btrfs support is experimental:
- As of writing, Ubuntu VM images support btrfs, but COS does not.
btrfs filesystem accepts two "special" mount options:
btrfs-data-bg_reclaim_thresholdbtrfs-metadata-bg_reclaim_threshold
Which writes to /sys/fs/btrfs/FS-UUID/allocation/{,meta}data/bg_reclaim_threshold, as documented in btrfs docs.
For releasing new versions of this driver, googlers should consult go/pdcsi-oss-release-process.