Skip to content

Added a new section for mount options #4499

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.

Sign up for GitHub

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

Merged
merged 1 commit into from
Jun 5, 2017
Merged

Added a new section for mount options #4499

Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
64 changes: 64 additions & 0 deletions architecture/additional_concepts/storage.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -405,6 +405,70 @@ cluster.

The CLI shows the name of the PVC bound to the PV.

[[pv-mount-options]]

=== Mount Options
[IMPORTANT]
====
Mount Options is a Technology Preview feature and it is only available for manually provisioned persistent volumes.
ifdef::openshift-enterprise[]
Technology Preview features are not supported with Red Hat production service
level agreements (SLAs), might not be functionally complete, and Red Hat does
not recommend to use them for production. These features provide early access to
upcoming product features, enabling customers to test functionality and provide
feedback during the development process.

For more information on Red Hat Technology Preview features support scope, see
https://access.redhat.com/support/offerings/techpreview/.
endif::[]
====

You can specify mount options while mounting a persistent volume by using the annotation `volume.beta.kubernetes.io/mount-options`.

For example:

====
[source, yaml]
----
apiVersion: v1
kind: PersistentVolume
metadata:
name: pv0001
annotations:
volume.beta.kubernetes.io/mount-options: rw,nfsvers=4,noexec <1>
spec:
capacity:
storage: 1Gi
accessModes:
- ReadWriteOnce
nfs:
path: /tmp
server: 172.17.0.2
persistentVolumeReclaimPolicy: Recycle
claimRef:
name: claim1
namespace: default
----
<1> Specified mount options are then used while mounting the persistent volume to the disk.
====

The following persistent volume types support mount options:

- NFS
- GlusterFS
- Ceph RBD
- OpenStack Cinder
- AWS Elastic Block Store (EBS)
- GCE Persistent Disk
- iSCSI
- Azure Disk
- Azure File

[NOTE]
====
Fiber Channel and HostPath persistent volumes do not support mount options.
====

[[persistent-volume-claims]]
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should this be rather more exhaustive list of volume types that supports mount-options ? Something like - https://kubernetes.io/docs/concepts/storage/persistent-volumes/#mount-options

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @gnufied
I have updated the PR to include the list of supported PVs.


== Persistent Volume Claims
Expand Down