IMPORTANT

Note:

• vDVS Installation User Guide
• DEB/RPM packages will be deprecated going forward and will not be available.

What's New

• ESXCLI: vSphere Administrators can manage container volumes, policies, tenancy etc using ESXCLI. vmdkops_admin CLI will be deprecated in next release.

• Support for Windows Containers*: vSphere Volumes for Windows Containers. Now you can run SQL Server natively with Windows Containers.

• vFile – Shared File Storage*: Out of box support for shared R/W access from hosts in the same Docker Swarm cluster.

• High Availability: Tighter integration with Docker & Swarm to handle storage failover in case of Node/VM crashes.

  *These are Developer Tech-preview features and should not be used in production. We would love to hear your feedback.

Contact us at

• containers@vmware.com
• Issues
• VMware Code Slack requires joining VMware Code

Downloads

Installation instructions

• ESX VIB: https://bintray.com/vmware/vDVS/download_file?file_path=VMWare_bootbank_esx-vmdkops-service_0.17.c2aef31-0.0.1.vib
• ESX VIB Offline Bundle: https://bintray.com/vmware/vDVS/download_file?file_path=vDVS_driver-0.17-offline_bundle-6470279.zip
• vDVS managed plugin: docker plugin install --grant-all-permissions --alias vsphere vmware/docker-volume-vsphere:0.17
• DEB: https://bintray.com/vmware/vDVS/download_file?file_path=docker-volume-vsphere_0.17.c2aef31_amd64.deb
• RPM: https://bintray.com/vmware/vDVS/download_file?file_path=docker-volume-vsphere-0.17.c2aef31-1.x86_64.rpm
• vFile managed plugin: docker plugin install --grant-all-permissions --alias vfile vmware/vfile:latest
• vDVS plugin for Windows docker host: https://bintray.com/vmware/vDVS/download_file?file_path=docker-volume-vsphere_windows_developer-preview.zip

Change Log

0.17 (2017-08-28)

Full Changelog

Closed issues:

• vFile : Replace references to cnastorage docker hub with vmware #1830
• vFile : plugin installation intermittently fails #1829
• Document vFile plugin release process #1821
• Admin CLI document needs some cosmetic changes. #1835
• Unable to mount first shared volume #1815
• vFile: plugin is not enabled after node is reboot #1807
• Admin CLI errors out without args. #1804
• Add documentation(user guide) for shared volume support. #1796
• Cleanup README.md and fix broken links (if there are any) #1791
• Documentation cleanup for http://vmware.github.io/docker-volume-vsphere/documentation #1785
• Fix the plugin upgrade flow when disable -f is used (live upgrade). #1779
• Unable to install vDVS managed plugin #1769
• vShared plugin: volume mount failed due to cannot start service before timeout #1766
• Document the issue #1073 #1763
• Documentation update for admin-cli.md to reflect usage of esxcli based commands. #1757
• Support ESXCLI for vSphere Docker Volume Service #1752
• Document the dependency on vm-tools and open-vm-tools for installation of VSOCK and VMCI drivers #1749
• Remove file server image on plugin uninstall #1746
• boot2docker support #1744
• vFile : Handle volumes with spaces in the name #1740
• Cannot mount new volume after another volume plugin is deleted #1726
• Volume unmount failed after docker restart #1724
• Allow deletion of volumes stuck in deleting state #1722
• VMDKOps Service communication failure on Windows VM #1720
• shared plugin: cannot remove volume from worker node #1715
• Support case-insensitive match for datastore names #1712
• [Debuggability/Serviceability] Add logging for important workflows #1709
• Don't create dockvols directory on datastores we don't need to create #1705
• Find VM by uuid should be fixed when trying to find VM by vc uuid #1704
• Make mounts read logs statements on plugin logs Debug instead of Info #1703
• Document update for vDVS upgrade instruction and expected behavior #1700
• Contact Us page is pointing to old slack channel #1695
• Fail the request if volume name contains illegal characters #1691
• Highlight dependency on vDVS plugin while kahuna install #1679
• golint error for one of the method in etcdops.go #1676
• Volume stays attached if the ESX of the vm goes down and vsphere HA moves vm to different ESX #1675
• Document Windows plugin #1664
• if datastore is renamed, all dockvols/<vmgroup> links are broken #1659
• Volume creation succeeds on a datastore which is in maintenance mode #1651
• If vm is reverted to a snapshot while container is running, volume remains in attached state after revert finishes. #1649
• Admin CLI should not allow VM list when re-creating _DEFAULT vmgroup #1644
• Volume remains attached even after we do 'Reset' of a vm #1638
• Not able to add description to the vmgroup at the time of vmgroup creation #1635
• Do not see the old volumes after performing storage vMotion of the vm #1618
• Not able to attach volume of filesystem ext4dev to a container #1617
• Current license or ESXi version prohibits execution of the requested operation. #1599
• vDVS documentation related issues #1545
• After docker restart, restarted containers show plugin volume as in-use but volume is detached #1499
• Update error message for _DEFAULT vmgroup #1442
• With default vmgroup removed detach requests are skipped, volumes remain attached [default vmgroup removal] #1441
• compose yml with datastore selection #1315
• Support set "--volume-totalsize" for "_VM_DS" and "_ALL_DS" #1185
• Protocol compatible check need to print build version when client/server version mismatch is found #1103
• VMDK migration #636
• Extend ESXCLI to support vmdkops_admin.py commands #623
• Document interop with vSphere features #270

Merged pull requests:

• Cosmetics for usage of esxcli storage guestvol commandset #1836 (pshahzeb)
• [SKIP CI] Minor fix to known-issues.md and contactus.md #1832 (ashahi1)
• Fix the userguide docker hub name for vFile plugin [SKIP CI] #1831 (luomiao)
• Do not log error for GetVolume with volume for empty names #1828 (pshahzeb)
• [SKIP CI] Remove references to gitter #1827 (tusharnt)
• Cutting release steps for windows [SKIP CI] #1824 (pshahzeb)
• vFile: adjust garbage collector interval and server timeout #1823 (luomiao)
• Add cutting release guideline for vFile plugin [SKIP CI] #1822 (luomiao)
• vFile: move time-consuming initialization works to goroutine #1818 (luomiao)
• Update user guide.[SKIP CI] #1817 (lipingxue)
• Add Windows plugin documentation [SKIP CI] #1813 (shaominchen)
• Handling mount during recovery for an already attached volume #1811 (pshahzeb)
• Documentation cleanup #1809 (divyenpatel)
• [SKIP CI] Cleanup README.md (#1791) #1808 (shuklanirdesh82)
• Report usage if no args/commands provided on the command line #1805 (govint)
• Create dockvols only when required on specific datastores. #1803 (govint)
• [SKIP CI] bringing .md files for known-issues and contact-us to vmware master #1802 (ashahi1)
• vFile: rename from vShared/shared to vFile #1801 (luomiao)
• Support case-insensitive match for datastore names #1800 (shaominchen)
• Increase the timeout value for service start/stop #1799 (lipingxue)
• [SKIP CI] Script to copy changes from vmware:master to gh-pages #1798 (ashahi1)
• vShared plugin: userguide [SKIP CI] #1793 (luomiao)
• [SKIP CI] correcting slack channel link #1790 (ashahi1)
• [SKIP CI] Update Site Recovery Manager's behavior with vDVS #1788 (ashahi1)
• [SKIP CI] Documentation update for ESXCLI usage and minor command fixes #1784 (pshahzeb)
• Revert rename change #1782 (shuklanirdesh82)
• Support unmout for shared volume. #1778 (lipingxue)
• Adds utility to reuse a single PowerShell session #1775 (venilnoronha)
• vShared: remove orphan services and internal volumes #1774 (luomiao)
• [SKIP CI] Push document changes to gh-pages #1773 (shaominchen)
• Vendors go-powershell package #1771 (venilnoronha)
• Refactoring: Project repo name is updated to vsphere-storage-for-docker #1767 (shuklanirdesh82)
• Document the known issue #1073 [SKIP CI] #1764 (shaominchen)
• [SKIP CI] Update Readme.md with instruction to upgrade driver or plugin #1758 (ashahi1)
• Kubernetes Documentation Cleanup #1755 (divyenpatel)
• vShared plugin: Address timeout error due to docker load image #1754 (luomiao)
• Added dependency to vm tools [SKIP CI] #1750 (govint)
• Cleanup Kubernetes Documentation #1747 (divyenpatel)
• Adds support for whitespace chars in Datastore names on Windows #1745 (venilnoronha)
• vShared plugin: improve volume state handling during Remove() #1743 (luomiao)
• Server side Mounting #1742 (shivanshu21)
• Fixes ls failure in Windows volumes #1741 (venilnoronha)
• [SKIP CI] Update 'Contact Us' information with latest docker channel #1739 (ashahi1)
• Added log for errors on get volume meta-data #1737 (govint)
• Fixes escaped spaces from /proc/mounts entries #1736 (govint)
• Integrating vmdkops_admin cli commands with esxcli - Part 1 #1735 (pshahzeb)
• Updating Kubernetes docs #1734 (divyenpatel)
• Fixing volume deletion from worker node #1733 (shivanshu21)
• Adds Windows plugin documentation [SKIP CI] #1730 (venilnoronha)
• vShared plugin: Add Mount() support for worker #1727 (luomiao)
• vShared plugin: Change the mount point to /mnt/vshared #1725 (luomiao)
• Shared plugin: fix to make sure error out when swarm is not active. #1716 (luomiao)
• Silencing mount logs on plugin side to Debug instead of Info #1713 (pshahzeb)
• Fixing find VM util for attach/detach flow #1711 (pshahzeb)
• Recover attached volumes after a VM reset or VM migrating after ESX host down. #1710 (govint)
• Improving error message incase of version mismatch between client and server(#1103) #1693 (shuklanirdesh82)
• Validate if volume name contains illegal characters #1692 (shaominchen)
• [SKIP CI] Document interop with vSphere features #1689 (ashahi1)
• Shared plugin: refactor kvstore and docker ops #1687 (luomiao)
• Allow "--volume-totalsize" to be set for "_VM_DS" and "_ALL_DS". #1686 (lipingxue)
• Pass user provided description when creating a vmgroup. #1677 (govint)
• Enables Docker plugin registration via plugin_server module #1672 (venilnoronha)
• Added check to skip vm_list when creating the default tenant #1670 (govint)
• Shared volume rm #1669 (shivanshu21)
• [SKIP CI] Update vDVS_bulletin.xml #1668 (ashahi1)
• Detaching disks when vmgroup is removed #1665 (msterin)
• Shared plugin: add etcd watcher and event handler #1661 (luomiao)
• Update README.md to add a known issue regarding storage vmotion of VM [SKIP CI] #1639 (lipingxue)