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

Update documentation and add blog #607

Merged
merged 1 commit into from
Oct 12, 2016
Merged

Conversation

kerneltime
Copy link
Contributor

We need to curate external links of interest and post content that is
not code/issues for public consumption.

Also, fix the documentation part of #583

@kerneltime kerneltime force-pushed the our2centblog.kerneltime branch 2 times, most recently from 46a5adf to 5a0bc92 Compare September 29, 2016 07:22

Thanks to [Bruno Moura's](https://github.com/brunotm) excellent [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.
Copy link
Contributor

@govint govint Sep 29, 2016

Choose a reason for hiding this comment

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

Admin cli can be used to set to read-write also, both modes are supported. Allowing the user to temporarily make a volume as read-write, make changes and then set to read-write allowing multiple containers in the same VM to use the same volume contents - containers don't need to build all their libs into the docker image. 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. Allows distributing ready to use "app volumes" that containers can use.

Copy link
Contributor Author

@kerneltime kerneltime Sep 29, 2016

Choose a reason for hiding this comment

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

What you describe should be part of the user guide not the announcement

Copy link
Contributor

Choose a reason for hiding this comment

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

Agree, just saying somewhere we should say how these features can get leveraged beyond just create/attach/detach/delete volumes.

Copy link
Contributor

Choose a reason for hiding this comment

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

I agree with the both of you, but I think Govindan's text should go in Readme or doc in the same PR

Copy link
Contributor

@govint govint left a comment

Choose a reason for hiding this comment

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

Overall, the documentation for the release should ideally also practical use cases where a user can leverage the features in the release.

@@ -0,0 +1,15 @@
# New Release
We continue our montly release cycle with our [September release](https://github.com/vmware/docker-volume-vsphere/releases/tag/0.7)
Copy link
Contributor

Choose a reason for hiding this comment

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

Typo: monthly

# External Blog entries

- Cormac Hogan - [Docker Volume Driver for vSphere using policies on VSAN](http://cormachogan.com/2016/09/26/docker-volume-driver-vsphere-using-policies-vsan-short-video/)
- 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)
Copy link
Contributor

Copy link
Contributor

Choose a reason for hiding this comment

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

Copy link
Contributor

@msterin msterin left a comment

Choose a reason for hiding this comment

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

Looks good. I do think we need to add Govindan's text to readme or admin-cli.md , and then it's good to go IMO.

I am not sure we need to enumerate all blogs. Maybe mention them or give a query :-)

# New Release
We continue our montly 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) excellent [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.
Copy link
Contributor

Choose a reason for hiding this comment

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

nit: drop "excellent" please - the work is indeed excellent but IMO not needed for the announcement


Thanks to [Bruno Moura's](https://github.com/brunotm) excellent [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.
Copy link
Contributor

Choose a reason for hiding this comment

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

I agree with the both of you, but I think Govindan's text should go in Readme or doc in the same PR

@msterin
Copy link
Contributor

msterin commented Oct 12, 2016

@kerneltime - any update for this one ?

not code/issues for public consumption.

Also, fix the documentation part of #583
@kerneltime
Copy link
Contributor Author

updated

@kerneltime kerneltime merged commit 1f11be2 into master Oct 12, 2016
@msterin msterin deleted the our2centblog.kerneltime branch October 22, 2016 00:42
# for free to subscribe to this conversation on GitHub. Already have an account? #.
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants