From 6e75d5c4de9a47ac3d9fd9e5209c83cc89e7c752 Mon Sep 17 00:00:00 2001 From: Deep Debroy Date: Thu, 6 Jun 2019 08:18:10 +0300 Subject: [PATCH] Update CSI migration docs with Azure Disk/File details (#14707) Signed-off-by: Deep Debroy --- content/en/docs/concepts/storage/volumes.md | 24 ++++++++++++++++++- .../feature-gates.md | 4 ++++ 2 files changed, 27 insertions(+), 1 deletion(-) diff --git a/content/en/docs/concepts/storage/volumes.md b/content/en/docs/concepts/storage/volumes.md index bcf6abe2d9..abcbd26e1a 100644 --- a/content/en/docs/concepts/storage/volumes.md +++ b/content/en/docs/concepts/storage/volumes.md @@ -166,6 +166,17 @@ A `azureDisk` is used to mount a Microsoft Azure [Data Disk](https://azure.micro More details can be found [here](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/staging/volumes/azure_disk/README.md). +#### CSI Migration + +{{< feature-state for_k8s_version="v1.15" state="alpha" >}} + +The CSI Migration feature for azureDisk, when enabled, shims all plugin operations +from the existing in-tree plugin to the `disk.csi.azure.com` Container +Storage Interface (CSI) Driver. In order to use this feature, the [Azure Disk CSI +Driver](https://github.com/kubernetes-sigs/azuredisk-csi-driver) +must be installed on the cluster and the `CSIMigration` and `CSIMigrationAzureDisk` +Alpha features must be enabled. + ### azureFile {#azurefile} A `azureFile` is used to mount a Microsoft Azure File Volume (SMB 2.1 and 3.0) @@ -173,6 +184,17 @@ into a Pod. More details can be found [here](https://github.com/kubernetes/examples/tree/{{< param "githubbranch" >}}/staging/volumes/azure_file/README.md). +#### CSI Migration + +{{< feature-state for_k8s_version="v1.15" state="alpha" >}} + +The CSI Migration feature for azureFile, when enabled, shims all plugin operations +from the existing in-tree plugin to the `file.csi.azure.com` Container +Storage Interface (CSI) Driver. In order to use this feature, the [Azure File CSI +Driver](https://github.com/kubernetes-sigs/azurefile-csi-driver) +must be installed on the cluster and the `CSIMigration` and `CSIMigrationAzureFile` +Alpha features must be enabled. + ### cephfs {#cephfs} A `cephfs` volume allows an existing CephFS volume to be @@ -1344,7 +1366,7 @@ configuration changes to existing Storage Classes, PVs or PVCs (referring to in-tree plugins) when transitioning to a CSI driver that supersedes an in-tree plugin. In the alpha state, the operations and features that are supported include -provisioning/delete, attach/detach and mount/unmount of volumes with `volumeMode` set to `filesystem` +provisioning/delete, attach/detach, mount/unmount and resizing of volumes. In-tree plugins that support CSI Migration and have a corresponding CSI driver implemented are listed in the "Types of Volumes" section above. diff --git a/content/en/docs/reference/command-line-tools-reference/feature-gates.md b/content/en/docs/reference/command-line-tools-reference/feature-gates.md index 574b996a6d..90436cfc73 100644 --- a/content/en/docs/reference/command-line-tools-reference/feature-gates.md +++ b/content/en/docs/reference/command-line-tools-reference/feature-gates.md @@ -62,6 +62,8 @@ different Kubernetes components. | `CSIInlineVolume` | `false` | Alpha | 1.14 | - | | `CSIMigration` | `false` | Alpha | 1.14 | | | `CSIMigrationAWS` | `false` | Alpha | 1.14 | | +| `CSIMigrationAzureDisk` | `false` | Alpha | 1.15 | | +| `CSIMigrationAzureFile` | `false` | Alpha | 1.15 | | | `CSIMigrationGCE` | `false` | Alpha | 1.14 | | | `CSIMigrationOpenStack` | `false` | Alpha | 1.14 | | | `CSINodeInfo` | `false` | Alpha | 1.12 | 1.13 | @@ -228,6 +230,8 @@ Each feature gate is designed for enabling/disabling a specific feature: - `CSIDriverRegistry`: Enable all logic related to the CSIDriver API object in csi.storage.k8s.io. - `CSIMigration`: Enables shims and translation logic to route volume operations from in-tree plugins to corresponding pre-installed CSI plugins - `CSIMigrationAWS`: Enables shims and translation logic to route volume operations from the AWS-EBS in-tree plugin to EBS CSI plugin +- `CSIMigrationAzureDisk`: Enables shims and translation logic to route volume operations from the Azure-Disk in-tree plugin to Azure Disk CSI plugin +- `CSIMigrationAzureFile`: Enables shims and translation logic to route volume operations from the Azure-File in-tree plugin to Azure File CSI plugin - `CSIMigrationGCE`: Enables shims and translation logic to route volume operations from the GCE-PD in-tree plugin to PD CSI plugin - `CSIMigrationOpenStack`: Enables shims and translation logic to route volume operations from the Cinder in-tree plugin to Cinder CSI plugin - `CSINodeInfo`: Enable all logic related to the CSINodeInfo API object in csi.storage.k8s.io.