Skip to content

Commit 88297af

Browse files
committed
doc: promote NFS feature to beta
1 parent 82cb2d4 commit 88297af

File tree

8 files changed

+27
-28
lines changed

8 files changed

+27
-28
lines changed

deploy/example/daemonset.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -28,11 +28,11 @@ spec:
2828
kubernetes.io/os: linux
2929
containers:
3030
- name: nginx
31-
image: mcr.microsoft.com/oss/nginx/nginx:1.17.3-alpine
31+
image: mcr.microsoft.com/oss/nginx/nginx:1.19.5
3232
command:
33-
- "/bin/sh"
33+
- "/bin/bash"
3434
- "-c"
35-
- while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
35+
- set -euo pipefail; while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
3636
volumeMounts:
3737
- name: azurefile
3838
mountPath: "/mnt/azurefile"

deploy/example/deployment.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -32,11 +32,11 @@ spec:
3232
"kubernetes.io/os": linux
3333
containers:
3434
- name: deployment-azurefile
35-
image: mcr.microsoft.com/oss/nginx/nginx:1.17.3-alpine
35+
image: mcr.microsoft.com/oss/nginx/nginx:1.19.5
3636
command:
37-
- "/bin/sh"
37+
- "/bin/bash"
3838
- "-c"
39-
- while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
39+
- set -euo pipefail; while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
4040
volumeMounts:
4141
- name: azurefile
4242
mountPath: "/mnt/azurefile"

deploy/example/nfs/README.md

Lines changed: 7 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
11
## NFS support
22
[NFS 4.1 support for Azure Files](https://azure.microsoft.com/en-us/blog/nfs-41-support-for-azure-files-is-now-in-preview/preview/) is now in Public Preview. This service is optimized for random access workloads with in-place data updates and provides full POSIX file system support. This page shows how to use NFS feature by Azure File CSI driver on Azure Kubernetes cluster.
33

4-
#### Feature Status: Alpha
4+
#### Feature Status: Beta
55
> supported OS: Linux
66
7-
#### Supported CSI driver version: `v0.8.0`
7+
#### Supported CSI driver version: `v0.9.0`
8+
> storage account dynamic provisioning is supported from `v0.10.0`.
89
910
#### [Available regions](https://aka.ms/azurefiles/nfs/preview/regions)
1011
We are continually adding more regions. Latest region list is available on [Azure NFS documentation](https://aka.ms/azurefiles/nfs/preview/regions)
@@ -17,14 +18,15 @@ az feature register --name AllowNfsFileShares --namespace Microsoft.Storage
1718
az feature list -o table --query "[?contains(name, 'Microsoft.Storage/AllowNfsFileShares')].{Name:name,State:properties.state}"
1819
az provider register --namespace Microsoft.Storage
1920
```
20-
- Create a `Premium_LRS` Azure storage account with following configurations to support NFS share
21+
- [Optional] Create a `Premium_LRS` Azure storage account with following configurations to support NFS share
2122
- account kind: `FileStorage`
2223
- secure transfer required(enable HTTPS traffic only): `false`
2324
- select virtual network of agent nodes in `Firewalls and virtual networks`
25+
- specify `storageAccount` in below storage class `parameters`
2426

2527
#### How to use NFS feature
2628
- Create an Azure File storage class
27-
> specify `storageAccount` and `protocol: nfs` in storage class `parameters`
29+
> specify `protocol: nfs` in storage class `parameters`
2830
> </br>for more details, refer to [driver parameters](../../../docs/driver-parameters.md)
2931
```yaml
3032
apiVersion: storage.k8s.io/v1
@@ -33,9 +35,7 @@ metadata:
3335
name: azurefile-csi-nfs
3436
provisioner: file.csi.azure.com
3537
parameters:
36-
resourceGroup: EXISTING_RESOURCE_GROUP_NAME # optional, only set this when storage account is not in the same resource group as agent node
37-
storageAccount: EXISTING_STORAGE_ACCOUNT_NAME
38-
protocol: nfs # use "fsType: nfs" in v0.8.0
38+
protocol: nfs
3939
```
4040
4141
run following commands to create a storage class:

deploy/example/nfs/statefulset.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,11 @@ spec:
1717
"kubernetes.io/os": linux
1818
containers:
1919
- name: statefulset-azurefile
20-
image: mcr.microsoft.com/oss/nginx/nginx:1.17.3-alpine
20+
image: mcr.microsoft.com/oss/nginx/nginx:1.19.5
2121
command:
22-
- "/bin/sh"
22+
- "/bin/bash"
2323
- "-c"
24-
- while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
24+
- set -euo pipefail; while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
2525
volumeMounts:
2626
- name: persistent-storage
2727
mountPath: /mnt/azurefile

deploy/example/nginx-pod-azurefile.yaml

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -7,16 +7,16 @@ spec:
77
nodeSelector:
88
"kubernetes.io/os": linux
99
containers:
10-
- image: mcr.microsoft.com/oss/nginx/nginx:1.17.3-alpine
10+
- image: mcr.microsoft.com/oss/nginx/nginx:1.19.5
1111
name: nginx-azurefile
1212
command:
13-
- "/bin/sh"
13+
- "/bin/bash"
1414
- "-c"
15-
- while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
15+
- set -euo pipefail; while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
1616
volumeMounts:
17-
- name: azurefile01
17+
- name: persistent-storage
1818
mountPath: "/mnt/azurefile"
1919
volumes:
20-
- name: azurefile01
20+
- name: persistent-storage
2121
persistentVolumeClaim:
2222
claimName: pvc-azurefile

deploy/example/statefulset.yaml

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -17,11 +17,11 @@ spec:
1717
"kubernetes.io/os": linux
1818
containers:
1919
- name: statefulset-azurefile
20-
image: mcr.microsoft.com/oss/nginx/nginx:1.17.3-alpine
20+
image: mcr.microsoft.com/oss/nginx/nginx:1.19.5
2121
command:
22-
- "/bin/sh"
22+
- "/bin/bash"
2323
- "-c"
24-
- while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
24+
- set -euo pipefail; while true; do echo $(date) >> /mnt/azurefile/outfile; sleep 1; done
2525
volumeMounts:
2626
- name: persistent-storage
2727
mountPath: /mnt/azurefile

deploy/example/storageclass-azurefile-nfs.yaml

Lines changed: 1 addition & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -5,8 +5,7 @@ metadata:
55
name: azurefile-csi-nfs
66
provisioner: file.csi.azure.com
77
parameters:
8-
storageAccount: EXISTING_STORAGE_ACCOUNT_NAME
9-
protocol: nfs # use "fsType: nfs" in v0.8.0
8+
protocol: nfs
109
reclaimPolicy: Delete
1110
volumeBindingMode: Immediate
1211
allowVolumeExpansion: true

deploy/example/windows/README.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# CSI Driver on Windows
22

3-
## Feature Status: Alpha
4-
CSI on Windows support is an alpha feature since Kubernetes v1.18, refer to [Windows-CSI-Support](https://github.com/kubernetes/enhancements/blob/master/keps/sig-windows/20190714-windows-csi-support.md) for more details.
3+
## Feature Status: Beta
4+
Refer to [Windows-CSI-Support](https://github.com/kubernetes/enhancements/blob/master/keps/sig-windows/20190714-windows-csi-support.md) for more details.
55

66
## Prerequisite
77
- Install CSI-Proxy on Windows Node

0 commit comments

Comments
 (0)