Merge pull request #4 from jianxiaoguo/master

chore(docs):add volumes and resources docs

Author: duanhongyi

.gitignore

@@ -22,3 +22,4 @@ venv/
 _build/
 
 .DS_Store
+.idea/*

mkdocs.yml

@@ -50,6 +50,8 @@ nav:
     - Managing App Processes: applications/managing-app-processes.md
     - Managing App Configuration: applications/managing-app-configuration.md
     - Managing App Lifecycle: applications/managing-app-lifecycle.md
+    - Managing App Volumes: applications/managing-app-volumes.md
+    - Managing App Resources: applications/managing-app-resources.md
     - Inter-app Communication: applications/inter-app-communication.md
     - Resource Limits: applications/managing-resource-limits.md
     - Domains and Routing: applications/domains-and-routing.md

src/applications/managing-app-resources.md

@@ -0,0 +1,75 @@
+# Managing resources for an Application
+
+We can use blow command to create resources and bind which resource is created.
+This command depend on [service-catalog](https://svc-cat.io).
+
+
+Use `drycc resources` to create and bind a resource for a deployed application.
+
+    $ drycc help resources
+    Valid commands for resources:
+
+    resources:create           create a resource for the application
+    resources:list             list resources in the application
+    resources:describe         get a resource detail info in the application
+    resources:update           update a resource from the application
+    resources:destroy          delete a resource from the applicationa
+    resources:bind             bind a resource to servicebroker
+    resources:unbind           unbind a resource from servicebroker
+
+    Use 'drycc help [command]' to learn more.
+
+## Create resource in application
+
+You can create a resource with one `drycc resources:create` command
+
+    $ drycc resources:create memcached:custom memcached
+    Creating memcached to scenic-icehouse... done
+
+After resources are created, you can list the resources in this application.
+
+    $ drycc resources:list
+    === scenic-icehouse resources
+    memcached      memcached:custom
+
+## Bind resources
+
+The resource which is named memcached is created, you can bind the memcached to the application,
+use the command of `drycc resources:bind memcached`.
+
+    $ drycc resources:bind memcached
+    Binding resource... done
+
+## Describe resources
+
+And use `drycc resources:describe` show the binding detail. If the binding is successful, this command will show the information of connect to the resource.
+
+    $ drycc resources:describe memcached
+    === scenic-icehouse resource memcached
+    plan:        memcached:custom
+    status:      Ready
+    binding:     Ready
+
+    HOST:        10.1.7.241 10.1.7.101
+    PORT:        11211
+
+## Update resources
+
+You can use the `drycc resources:update` command to upgrade a new plan.
+An example of how to upgrade the plan's capacity to 100MB:
+
+    $ drycc resources:update memcached:100 memcached
+    Updating memcached to scenic-icehouse... done
+
+## Remove the resource
+
+If you don't need resources, use `drycc resources:unbind` to unbind the resource and then use `drycc resources:destroy` to delete the resource from the application.
+Before deleting the resource, the resource must be unbinded.
+
+    $ drycc resources:unbind memcached
+    Unbinding resource... done
+
+    $ drycc resources:destroy memcached
+    Deleting memcached from scenic-icehouse... done
+
+

src/applications/managing-app-volumes.md

@@ -0,0 +1,58 @@
+# Mounting volumes for an Application
+
+We can use the blow command to create volumes and mount the created volumes.
+Drycc create volume support [ReadWriteMany](https://kubernetes.io/docs/concepts/storage/persistent-volumes/#access-modes), so before deploying drycc, you need to have a StorageClass ready which can support ReadWriteMany.
+Deploying drycc, set controller.app_storage_class to this StorageClass.
+
+
+Use `drycc volumes` to mount a volume for a deployed application's processes.
+
+    $ drycc help volumes
+    Valid commands for volumes:
+
+    volumes:create           create a volume for the application
+    volumes:list             list volumes in the application
+    volumes:delete           delete a volume from the application
+    volumes:mount            mount a volume to process of the application
+    volumes:unmount          unmount a volume from process of the application
+
+    Use 'drycc help [command]' to learn more.
+
+## Create a volume for the application
+
+You can create a volume with the `drycc volumes:create` command
+
+    $ drycc volumes:create myvolume 200M
+    Creating myvolumes to scenic-icehouse... done
+
+## List volumes in the application
+
+After volume is created, you can list the volumes in this application.
+
+    $ drycc volumes:list
+    === scenic-icehouse volumes
+    --- myvolumes     200M
+
+## Mount a volume
+
+The volume which is named myvolumes is created, you can mount the volume with process of the application,
+use the command of `drycc volumes:mount`. When volume is mounted, a new release will be created and deployed automatically.
+
+    $ drycc volumes:mount myvolumes web=/data/web
+    Mounting volume... done
+
+And use `drycc volumes:list` show mount detail.
+
+    $ drycc volumes:list
+    === scenic-icehouse volumes
+    --- myvolumes     200M
+    web               /data/web
+
+If you don't need the volume, use `drycc volumes:unmount` to unmount the volume and then use  `drycc volumes:delete` to delete the volume from the application.
+Before deleting volume, the volume has to be unmounted.
+
+    $ drycc volumes:unmount myvolumes web
+    Unmounting volume... done
+
+    $ drycc volumes:delete myvolumes
+    Deleting myvolumes from scenic-icehouse... done