vmware-archive / vsphere-storage-for-docker

vSphere Storage for Docker
https://vmware.github.io/vsphere-storage-for-docker
Apache License 2.0
251 stars 95 forks source link

Document the upper to lower case conversion of volume names in Windows #2033

Closed govint closed 6 years ago

govint commented 6 years ago

Windows converts all names to lower case when using docker commands and this can create the types of issues as in #2006. While #2006 is fixed for the datastore name getting converted to lower case, the plugin has no way of figuring out the real volume name if the container volume name has a mix of upper and lower case letters.

For example, creating two volumes like Bvol and bVol ends up creating a single volume bvol on the backing storage since Windows converts both volume names to bvol. Hence on Windows at least the user should avoid using mixed case or upper case letters in the volume name.

PS C:\Users\root> docker volume create -d vsphere Bvol

PS C:\Users\root> docker volume inspect bVol [ { "Driver": "vsphere", "Labels": {}, "Mountpoint": "C:\Windows\system32\config\systemprofile\AppData\Lo cal\docker-volume-vsphere\mounts\bvol\", "Name": "bvol", <----------------------- "Options": {}, "Scope": "global", "Status": { "access": "read-write", "attach-as": "independent_persistent", "capacity": { "allocated": "48MB", "size": "100MB" }, "clone-from": "None", "created": "Mon Dec 11 04:10:23 2017", "created by VM": "Windows-VM-1", "datastore": "vsanDatastore", "diskformat": "thin", "fstype": "ntfs", "status": "detached" } } ]

shuklanirdesh82 commented 6 years ago

Yeah it is already documented for the windows plugin (FAQ page and known difference between linux plugin vs windows plugin)