Merge pull request #345 from owncloud/nats-deployment-example

add nats deployment example

charts/ocis/docs/values-desc-table.adoc

@@ -893,7 +893,7 @@ a| [subs=-attributes]
 +string+
 a| [subs=-attributes]
 `"kubernetes"`
-| Configure the service registry type. Defaults to "kubernetes". Can be set to "etcd", then the address of etcd node(s) needs to be set to `registry.nodes`.
+| Configure the service registry type. Defaults to "kubernetes". Can be set to "etcd" or "nats", then the address of etcd / nats node(s) needs to be set to `registry.nodes`.
 | replicas
 a| [subs=-attributes]
 +int+

charts/ocis/docs/values.adoc.yaml

@@ -109,7 +109,7 @@ store:
 registry:
   # -- Configure the service registry type.
   # Defaults to "kubernetes".
-  # Can be set to "etcd", then the address of etcd node(s) needs to be set to `registry.nodes`.
+  # Can be set to "etcd" or "nats", then the address of etcd / nats node(s) needs to be set to `registry.nodes`.
   type: kubernetes
   # -- Nodes of the service registry to use.
   nodes: []

charts/ocis/templates/_common/registry/registry.tpl

@@ -2,7 +2,7 @@
 oCIS service registry
 */}}
 {{- define "ocis.serviceRegistry" -}}
-{{- $valid := list "kubernetes" "etcd" -}}
+{{- $valid := list "kubernetes" "etcd" "nats" -}}
 {{- if not (has .Values.registry.type $valid) -}}
 {{- fail "invalid registry.type set" -}}
 {{- end -}}

charts/ocis/values.yaml

@@ -108,7 +108,7 @@ store:
 registry:
   # -- Configure the service registry type.
   # Defaults to "kubernetes".
-  # Can be set to "etcd", then the address of etcd node(s) needs to be set to `registry.nodes`.
+  # Can be set to "etcd" or "nats", then the address of etcd / nats node(s) needs to be set to `registry.nodes`.
   type: kubernetes
   # -- Nodes of the service registry to use.
   nodes: []

deployments/ocis-nats/README.md

@@ -0,0 +1,48 @@
+# oCIS with NATS deployment example
+
+## Introduction
+
+This example shows how to deploy NATS with NATS as message bus and store.
+It will deploy an oCIS instance and NATS, preconfigured to work together.
+
+***Note***: This example is not intended for production use. It is intended to get a working oCIS
+with NATS running in Kubernetes as quickly as possible. It is not hardened in any way.
+
+## Getting started
+
+### Prerequisites
+
+This example requires the following things to be installed:
+
+- [Kubernetes](https://kubernetes.io/) cluster, with an ingress controller installed.
+- [Helm](https://helm.sh/) v3
+- [Helmfile](https://github.com/helmfile/helmfile)
+
+### End result
+
+After following the steps in this guide, you should be able to access the following endpoint, you
+may want to add these to your `/etc/hosts` file pointing to your ingress controller IP:
+
+- https://ocis.kube.owncloud.test
+
+Note that if you want to use your own hostname and domain, you will have to change the `externalDomain` value.
+
+### Deploying
+
+In this directory, run the following commands:
+
+```bash
+$ helmfile sync
+```
+
+This will deploy oCIS and NATS.
+
+### Logging in
+
+You can get the admin password with the following command:
+
+```bash
+$ kubectl -n ocis get secret admin-user -o go-template --template="{{.data.password | base64decode }}"
+```
+
+You can use this password to login with the user `admin`.

deployments/ocis-nats/helmfile.yaml

@@ -0,0 +1,84 @@
+repositories:
+  - name: nats
+    url: https://nats-io.github.io/k8s/helm/charts
+
+releases:
+  - name: nats
+    chart: nats/nats
+    namespace: ocis-nats
+    values:
+      - cluster:
+          enabled: true
+          name: "ocis-cluster"
+      - nats:
+          jetstream:
+            enabled: true
+
+  - name: ocis
+    chart: ../../charts/ocis
+    namespace: ocis
+    values:
+      - externalDomain: ocis.kube.owncloud.test
+      - ingress:
+          enabled: true
+          ingressClassName: nginx
+          annotations:
+            nginx.ingress.kubernetes.io/proxy-body-size: 1024m
+          tls:
+            - secretName: ocis-dev-tls
+              hosts:
+                - ocis.kube.owncloud.test
+
+      - insecure:
+          oidcIdpInsecure: true
+          ocisHttpApiInsecure: true
+
+      - messagingSystem:
+          external:
+            enabled: true
+            endpoint: nats.ocis-nats.svc.cluster.local:4222
+            tls:
+              enabled: false
+
+      - registry:
+          type: nats
+          nodes:
+            - nats.ocis-nats.svc.cluster.local:4222
+
+      - store:
+          type: nats-js
+          nodes:
+            - nats.ocis-nats.svc.cluster.local:4222
+
+      - services:
+          idm:
+            persistence:
+              enabled: true
+
+          nats:
+            persistence:
+              enabled: true
+
+          search:
+            persistence:
+              enabled: true
+
+          storagesystem:
+            persistence:
+              enabled: true
+
+          storageusers:
+            persistence:
+              enabled: true
+
+          store:
+            persistence:
+              enabled: true
+
+          thumbnails:
+            persistence:
+              enabled: true
+
+          web:
+            persistence:
+              enabled: true