Skip to content
This repository has been archived by the owner on Nov 9, 2020. It is now read-only.

Commit

Permalink
We need to curate external links of interest and post content that is
Browse files Browse the repository at this point in the history
not code/issues for public consumption.

Also, fix the documentation part of #583
  • Loading branch information
Ritesh H Shukla committed Oct 12, 2016
1 parent 8558bd1 commit d1419ab
Show file tree
Hide file tree
Showing 5 changed files with 78 additions and 1 deletion.
19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -157,3 +157,22 @@ Guest Operating System:

### Internal
* [VMware Internal Slack] (https://vmware.slack.com/archives/docker-volume-vsphere)

# External Blog entries

- Cormac Hogan
- Overview
- [Docker Volume Driver for vSphere](http://cormachogan.com/2016/06/01/docker-volume-driver-vsphere/)
- [Docker Volume Driver for vSphere – short video](http://cormachogan.com/2016/06/03/docker-volume-driver-vsphere-short-video/)
- Docker + VSAN
- [Docker Volume Driver for vSphere on Virtual SAN](http://cormachogan.com/2016/06/09/docker-volume-driver-vsphere-virtual-san-vsan/)
- [Using vSphere docker volume driver to run Project Harbor on VSAN](Using vSphere docker volume driver to run Project Harbor on VSAN)
- [Docker Volume Driver for vSphere using policies on VSAN](http://cormachogan.com/2016/09/26/docker-volume-driver-vsphere-using-policies-vsan-short-video/)
- 0.7 Release Overview
- [Some nice enhancements to Docker Volume Driver for vSphere v0.7](http://cormachogan.com/2016/10/06/nice-enhancements-docker-volume-driver-vsphere-v0-7/)
- William Lam
- [Getting Started with Tech Preview of Docker Volume Driver for vSphere - updated](http://www.virtuallyghetto.com/2016/05/getting-started-with-tech-preview-of-docker-volume-driver-for-vsphere.html)
- Virtual Blocks
- [vSphere Docker Volume Driver Brings Benefits of vSphere Storage to Containers](https://blogs.vmware.com/virtualblocks/2016/06/20/vsphere-docker-volume-driver-brings-benefits-of-vsphere-storage-to-containers/)
- Ryan Kelly
- [How to use the Docker Volume Driver for vSphere with Photon OS](http://www.vmtocloud.com/how-to-use-the-docker-volume-driver-for-vsphere-with-photon-os/)
29 changes: 29 additions & 0 deletions docs/blog/2016-9-28.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# 0.7 Release
We continue our monthly release cycle with our [September release](https://github.com/vmware/docker-volume-vsphere/releases/tag/0.7)

Thanks to [Bruno Moura's](https://github.com/brunotm) [work](https://github.com/vmware/docker-volume-vsphere/pull/597), Docker volume plugin for vSphere now supports selection of file system format when creating a new docker volume.

Ability to set a volume [read-only](https://github.com/vmware/docker-volume-vsphere/issues/274) is now supported by the plugin. The [admin cli](https://vmware.github.io/docker-volume-vsphere/user-guide/admin-cli/#set) allows the admin to set a volume to be read only.

# Coming up

One of the major features in the pipeline is multi-tenancy and vCenter integration. More about that soon..

# External Blog entries

- Cormac Hogan
- Overview
- [Docker Volume Driver for vSphere](http://cormachogan.com/2016/06/01/docker-volume-driver-vsphere/)
- [Docker Volume Driver for vSphere – short video](http://cormachogan.com/2016/06/03/docker-volume-driver-vsphere-short-video/)
- Docker + VSAN
- [Docker Volume Driver for vSphere on Virtual SAN](http://cormachogan.com/2016/06/09/docker-volume-driver-vsphere-virtual-san-vsan/)
- [Using vSphere docker volume driver to run Project Harbor on VSAN](Using vSphere docker volume driver to run Project Harbor on VSAN)
- [Docker Volume Driver for vSphere using policies on VSAN](http://cormachogan.com/2016/09/26/docker-volume-driver-vsphere-using-policies-vsan-short-video/)
- 0.7 Release Overview
- [Some nice enhancements to Docker Volume Driver for vSphere v0.7](http://cormachogan.com/2016/10/06/nice-enhancements-docker-volume-driver-vsphere-v0-7/)
- William Lam
- [Getting Started with Tech Preview of Docker Volume Driver for vSphere - updated](http://www.virtuallyghetto.com/2016/05/getting-started-with-tech-preview-of-docker-volume-driver-for-vsphere.html)
- Virtual Blocks
- [vSphere Docker Volume Driver Brings Benefits of vSphere Storage to Containers](https://blogs.vmware.com/virtualblocks/2016/06/20/vsphere-docker-volume-driver-brings-benefits-of-vsphere-storage-to-containers/)
- Ryan Kelly
- [How to use the Docker Volume Driver for vSphere with Photon OS](http://www.vmtocloud.com/how-to-use-the-docker-volume-driver-for-vsphere-with-photon-os/)
Empty file added docs/blog/links.md
Empty file.
25 changes: 25 additions & 0 deletions docs/user-guide/admin-cli.md
Original file line number Diff line number Diff line change
Expand Up @@ -135,6 +135,31 @@ enhancement tracked [here](https://github.com/vmware/docker-volume-vsphere/issue
[root@localhost:~] /usr/lib/vmware/vmdkops/bin/vmdkops_admin.py policy rm some-policy
Successfully removed policy: some-policy
```
# Set
Modify attribute settings on a given volume. The volume is identified by its name and datastore,
for example if the volume name is `container-vol` then the volume is specified as "container-vol@datastore-name".
The attributes to set/modify are specified as a comma separated list as "<attr1>=<value>, <attr2>=<value>....". For example,
a command line would look like this.

```
$ vmdkops-admin set --volume=<volume@datastore> --options="<attr1>=<value>, <attr2>=<value>, ..."
```

The volume attributes are set and take effect only the next time the volume attached to a VM. The changes do not impact any VM
thats currently using the volume. For the present, only the "access" attribute is supported to be modified via this command, and
can be set to either of the allowed values "read-only" or "read-write".

Set command allows the admin to enforce a volume to be read-only.
This removes the need to depend on [Docker's run command options for volume access](https://docs.docker.com/engine/tutorials/dockervolumes/) (``` docker run -v /vol:/vol:ro```).

A sample use case:

1. Create a volume, attach to a container (default is read-write).
2. Master the volume with libraries commonly used by the target application (or a cluster of apps that form a docker app bundle).
3. Use admin CLI to flip the access attribute to read-only.
4. Make those libraries available to the containers in the app bundle and they can all share the same libraries.

The container images themselves can be smaller as they share the libs and possibly binaries from read-only volumes.

# Status

Expand Down
6 changes: 5 additions & 1 deletion mkdocs.yml
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,12 @@ pages:
- Basic commands: user-guide/docker-volume-cli.md
- Multiple Datastores: user-guide/datastores.md
- Backend ESX Overview:
- 'Volume Layout': user-guide/esx-overview.md
- Volume Layout: user-guide/esx-overview.md
- FAQ: user-guide/faq.md
- Blog:
- 2016:
- September:
- Release announcement and updates: blog/2016-9-28.md
theme: readthedocs
google_analytics: ['UA-81413942-1', 'https://vmware.github.io/docker-volume-vsphere/']
site_favicon: favicon.ico
Expand Down

0 comments on commit d1419ab

Please # to comment.