docs(milvus): add guides and examples

docs/examples/milvus/quickstart/distributed.yaml

@@ -0,0 +1,23 @@
+apiVersion: kubedb.com/v1alpha2
+kind: Milvus
+metadata:
+  name: milvus-cluster
+  namespace: demo
+spec:
+  version: "2.6.11"
+  objectStorage:
+    configSecret:
+      name: my-release-minio
+  topology:
+    mode: Distributed
+    distributed:
+      mixcoord:
+        replicas: 2
+  storageType: Durable
+  storage:
+    accessModes:
+      - ReadWriteOnce
+    storageClassName: local-path
+    resources:
+      requests:
+        storage: 10Gi

docs/guides/milvus/README.md

@@ -0,0 +1,71 @@
+---
+title: Milvus
+menu:
+  docs_{{ .version }}:
+    identifier: milvus-readme
+    name: Milvus
+    parent: milvus-guides
+    weight: 10
+menu_name: docs_{{ .version }}
+section_menu_id: guides
+url: /docs/{{ .version }}/guides/milvus/
+aliases:
+  - /docs/{{ .version }}/guides/milvus/README/
+---
+
+> New to KubeDB? Please start [here](/docs/README.md).
+
+# Overview
+
+KubeDB supports vector database deployment with Milvus using the `Milvus` CRD.
+
+## Supported Milvus Features
+
+| Features                         | Availability |
+|----------------------------------|:------------:|
+| Standalone provisioning          |   ✓   |
+| Distributed provisioning         |   ✓   |
+| Monitoring                       |   ✓   |
+| TLS                              |      No      |
+| Ops Requests                     |      No      |
+
+## Example Milvus Manifest
+
+```yaml
+apiVersion: kubedb.com/v1alpha2
+kind: Milvus
+metadata:
+  name: milvus-cluster
+spec:
+  version: "2.6.11"
+  objectStorage:
+    configSecret:
+      name: "my-release-minio"
+  topology:
+    mode: Distributed
+    distributed:
+      mixcoord:
+        replicas: 2
+  storageType: Durable
+  storage:
+    accessModes:
+      - ReadWriteOnce
+    storageClassName: local-path
+    resources:
+      requests:
+        storage: 10Gi
+```
+
+## User Guide
+
+- [Quickstart Milvus](/docs/guides/milvus/quickstart/quickstart.md) with KubeDB operator.
+- [Milvus CRD Concept](/docs/guides/milvus/concepts/milvus.md).
+- [MilvusVersion CRD Concept](/docs/guides/milvus/concepts/catalog.md).
+- [MilvusOpsRequest CRD Concept](/docs/guides/milvus/concepts/opsrequest.md).
+- [RBAC Quickstart](/docs/guides/milvus/quickstart/rbac.md)
+- [Private Registry](/docs/guides/milvus/private-registry/using-private-registry.md)
+- [Custom RBAC](/docs/guides/milvus/custom-rbac/using-custom-rbac.md)
+- [Custom Configuration](/docs/guides/milvus/configuration/using-config-file.md)
+- [Monitoring](/docs/guides/milvus/monitoring/overview.md) for metrics collection guidance.
+- [Builtin Prometheus Monitoring](/docs/guides/milvus/monitoring/using-builtin-prometheus.md)
+- [Prometheus Operator Monitoring](/docs/guides/milvus/monitoring/using-prometheus-operator.md)

docs/guides/milvus/_index.md

@@ -0,0 +1,10 @@
+---
+title: Milvus
+menu:
+  docs_{{ .version }}:
+    identifier: milvus-guides
+    name: Milvus
+    parent: guides
+    weight: 15
+menu_name: docs_{{ .version }}
+---

docs/guides/milvus/concepts/_index.md

@@ -0,0 +1,10 @@
+---
+title: Milvus Concepts
+menu:
+  docs_{{ .version }}:
+    identifier: milvus-concepts
+    name: Concepts
+    parent: milvus-guides
+    weight: 15
+menu_name: docs_{{ .version }}
+---

docs/guides/milvus/concepts/catalog.md

@@ -0,0 +1,70 @@
+---
+title: MilvusVersion CRD
+menu:
+  docs_{{ .version }}:
+    identifier: milvus-catalog-concepts
+    name: MilvusVersion
+    parent: milvus-concepts-milvus
+    weight: 15
+menu_name: docs_{{ .version }}
+section_menu_id: guides
+---
+
+> New to KubeDB? Please start [here](/docs/README.md).
+
+# MilvusVersion
+
+## What is MilvusVersion
+
+`MilvusVersion` is the catalog CRD that defines the Milvus engine image and related metadata for KubeDB-managed Milvus deployments.
+
+KubeDB uses this CRD when resolving `Milvus.spec.version`.
+
+## MilvusVersion Specification
+
+```yaml
+apiVersion: catalog.kubedb.com/v1alpha1
+kind: MilvusVersion
+metadata:
+  name: 2.6.11
+spec:
+  db:
+    image: ghcr.io/appscode-images/milvus:2.6.11
+  etcdVersion: v3.5.21
+  securityContext:
+    runAsUser: 1000
+  version: 2.6.11
+```
+
+### metadata.name
+
+`metadata.name` is a required field that specifies the name of the `MilvusVersion` CR. You have to specify this name in `spec.version` field of [Milvus](/docs/guides/milvus/concepts/milvus.md) CR.
+
+We follow this convention for naming MilvusVersion CR:
+
+- Name format: `{Original Milvus image version}-{modification tag}`
+
+We use official Apache Milvus release tar files to build docker images for supporting Milvus versions and re-tag the image with v1, v2 etc. modification tag when there's any. An image with higher modification tag will have more features than the images with lower modification tag. Hence, it is recommended to use MilvusVersion CR with the highest modification tag to enjoy the latest features.
+
+### spec.version
+
+`spec.version` is a required field that specifies the original version of Milvus database that has been used to build the docker image specified in `spec.db.image` field.
+
+### spec.db.image
+
+`spec.db.image` is a required field that specifies the docker image which will be used to create PetSet by KubeDB operator to create expected Milvus database.
+
+### spec.etcdVersion
+
+`spec.etcdVersion` specifies the compatible Etcd version required by this Milvus release.
+
+### spec.deprecated
+
+`spec.deprecated` is an optional field that specifies whether the docker images specified here is supported by the current KubeDB operator.
+
+The default value of this field is `false`. If `spec.deprecated` is set to `true`, KubeDB operator will skip processing this CRD object and will add a event to the CRD object specifying that the DB version is deprecated.
+
+## Next Steps
+
+- Read the [Milvus CRD concept](/docs/guides/milvus/concepts/milvus.md).
+- Run the [Milvus quickstart](/docs/guides/milvus/quickstart/quickstart.md).