Improved Memcached doc

docs/concepts/databases/memcached.md

@@ -62,17 +62,20 @@ spec:
 ### spec.doNotPause
 `spec.doNotPause` is an optional field that tells KubeDB operator that if this Memcached object is deleted, whether it should be reverted automatically. This should be set to `true` for production databases to avoid accidental deletion. If not set or set to false, deleting a Memcached object put the database into a dormant state. 
 
+### spec.imagePullSecret
+`KubeDB` provides the flexibility of deploying Memcached database from a Private Docker Registry. To learn how to deploym Memcached from a Private Registry, please visit [here](/docs/guides/memcached/private-registry/using-private-registry.md).
 
 ### spec.monitor
-To learn how to monitor Memcached databases, please visit [here](/docs/concepts/monitoring.md).
-
+Memcached can be monitored with KubeDB using out-of-the-box builtin-Prometheus and out-of-the-box CoreOS-Prometheus Operator. To learn more,
+ - [Monitor Memcached with builtin-Prometheus](/docs/guides/memcached/monitoring/using-builtin-prometheus.md)
+ - [Monitor Memcached with CoreOS-Prometheus Operator](/docs/guides/memcached/monitoring/using-coreos-prometheus-operator.md)
 
 ### spec.resources
 `spec.resources` is an optional field. This can be used to request compute resources required by the database pods. To learn more, visit [here](http://kubernetes.io/docs/user-guide/compute-resources/).
 
 
 ## Next Steps
-- Learn how to use KubeDB to run a Memcached database [here](/docs/guides/memcached/overview.md).
+- Learn how to use KubeDB to run a Memcached database [here](/docs/guides/memcached/README.md).
 - Thinking about monitoring your database? KubeDB works [out-of-the-box with Prometheus](/docs/guides/monitoring.md).
 - Learn how to use KubeDB in a [RBAC](/docs/guides/rbac.md) enabled cluster.
 - Wondering what features are coming next? Please visit [here](/docs/roadmap.md).

docs/examples/memcached/demo-1.yaml

@@ -9,8 +9,8 @@ spec:
   doNotPause: true
   resources:
     requests:
-      memory: "64Mi"
-      cpu: "250m"
+      memory: 64Mi
+      cpu: 250m
     limits:
-      memory: "128Mi"
-      cpu: "500m"
+      memory: 128Mi
+      cpu: 500m

docs/examples/memcached/monitoring/builtin-prometheus/demo-1.yaml

@@ -0,0 +1,18 @@
+apiVersion: kubedb.com/v1alpha1
+kind: Memcached
+metadata:
+  name: memcd-mon-prometheus
+  namespace: demo
+spec:
+  replicas: 3
+  version: 1.5.4
+  doNotPause: true
+  resources:
+    requests:
+      memory: 64Mi
+      cpu: 250m
+    limits:
+      memory: 128Mi
+      cpu: 500m
+  monitor:
+    agent: prometheus.io/builtin

docs/examples/memcached/monitoring/coreos-operator/demo-1.yaml

@@ -0,0 +1,24 @@
+apiVersion: kubedb.com/v1alpha1
+kind: Memcached
+metadata:
+  name: memcd-mon-coreos
+  namespace: demo
+spec:
+  replicas: 3
+  version: 1.5.4
+  doNotPause: true
+  resources:
+    requests:
+      memory: 64Mi
+      cpu: 250m
+    limits:
+      memory: 128Mi
+      cpu: 500m
+  monitor:
+    agent: prometheus.io/coreos-operator
+    prometheus:
+      namespace: demo
+      labels:
+        app: kubedb
+      interval: 10s
+

docs/examples/memcached/private-registry/demo-1.yaml

@@ -0,0 +1,8 @@
+apiVersion: v1
+kind: Secret
+metadata:
+ name: myregistrykey
+ namespace: demo
+data:
+ .dockerconfigjson: <base-64-encoded-json-here>
+type: kubernetes.io/dockerconfigjson

docs/examples/memcached/private-registry/demo-2.yaml

@@ -0,0 +1,18 @@
+apiVersion: kubedb.com/v1alpha1
+kind: Memcached
+metadata:
+  name: memcd-pvt-reg
+  namespace: demo
+spec:
+  replicas: 3
+  version: 1.5.4
+  doNotPause: true
+  resources:
+    requests:
+      memory: 64Mi
+      cpu: 250m
+    limits:
+      memory: 128Mi
+      cpu: 500m
+  imagePullSecrets:
+    - name: myregistrykey

docs/examples/memcached/quickstart/demo-1.yaml

@@ -0,0 +1,16 @@
+apiVersion: kubedb.com/v1alpha1
+kind: Memcached
+metadata:
+  name: memcd-quickstart
+  namespace: demo
+spec:
+  replicas: 3
+  version: 1.5.4
+  doNotPause: true
+  resources:
+    requests:
+      memory: 64Mi
+      cpu: 250m
+    limits:
+      memory: 128Mi
+      cpu: 500m

docs/guides/README.md

@@ -27,7 +27,7 @@ Guides show you how to perform tasks with KubeDB.
 
  - [Running Redis](/docs/guides/redis/overview.md): This tutorial will show you how to use KubeDB to run a Redis database.
 
- - [Running Memcached](/docs/guides/memcached/overview.md): This tutorial will show you how to use KubeDB to run a Memcached database.
+ - [Running Memcached](/docs/guides/memcached/README.md): This tutorial will show you how to use KubeDB to run a Memcached database.
 
  - [Manage KubeDB objects using CLIs](/docs/guides/cli.md): KubeDB comes with its own cli. It is called `kubedb` cli. kubedb can be used to deploy KubeDB operator in a cluster and manage all KubeDB crds.
 

docs/guides/memcached/README.md

@@ -0,0 +1,43 @@
+
+
+> New to KubeDB? Please start [here](/docs/guides/README.md).
+
+## Memcached versions supported by KubeDB
+
+| KubeDB Version | Memcached:1.5.4 |
+|:--:|:--:|
+| 0.1.0 - 0.7.0 | ✗ |
+| 0.8.0-beta.0 | ✓ |
+| 0.8.0-beta.1 | ✓ |
+
+<br/>
+
+## KubeDB Features and their availability for Memcached
+
+|Features |Availability|
+|--|:--:|
+|Clustering | &#10007; |
+|Persistent Volume | &#10007; |
+|Instant Backup | &#10007; |
+|Scheduled Backup  | &#10007; |
+|Initialize using Snapshot | &#10007; |
+|Initialize using Script | &#10007; |
+|out-of-the-box builtin-Prometheus Monitoring | &#10003; |
+|out-of-the-box CoreOS-Prometheus-Operator Monitoring | &#10003; |
+
+<br/>
+
+## Life Cycle of Memcached in KubeDB
+<p align="center">
+  <img alt="lifecycle"  src="/docs/images/memcached/memcached-lifecycle.png" width="600" height="373">
+</p>
+
+
+## User Guide
+- [Quickstart Memcached](/docs/guides/memcached/quickstart/quickstart.md) with KubeDB Operator.
+- Monitor your Memcached database with KubeDB using [out-of-the-box CoreOS Prometheus Operator](/docs/guides/memcached/monitoring/using-coreos-prometheus-operator.md).
+- Monitor your Memcached database with KubeDB using [out-of-the-box builtin-Prometheus](/docs/guides/memcached/monitoring/using-builtin-prometheus.md).
+- Use [Private Docker Registry](/docs/guides/memcached/private-registry/using-private-registry.md) to deploy Memcached with KubeDB.
+- Detail concepts of [Memcached object](/docs/concepts/databases/memcached.md).
+- Wondering what features are coming next? Please visit [here](/docs/roadmap.md).
+- Want to hack on KubeDB? Check our [contribution guidelines](/docs/CONTRIBUTING.md).