Add NATS guides and examples

docs/examples/nats/auth/nats-config-auth.yaml

@@ -0,0 +1,11 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-config-auth
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  auth:
+    mode: Config
+  deletionPolicy: WipeOut

docs/examples/nats/auth/nats-external-operator.yaml

@@ -0,0 +1,14 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-external-operator
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  auth:
+    mode: Operator
+    operator:
+      externalSecret:
+        name: my-nats-operator
+  deletionPolicy: WipeOut

docs/examples/nats/auth/nats-operator-auth.yaml

@@ -0,0 +1,19 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-operator-auth
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  auth:
+    mode: Operator
+    operator:
+      resolverStorage:
+        accessModes:
+          - ReadWriteOnce
+        resources:
+          requests:
+            storage: 1Gi
+      allowDelete: false
+  deletionPolicy: WipeOut

docs/examples/nats/backup/backupconfiguration.yaml

@@ -0,0 +1,39 @@
+apiVersion: core.kubestash.com/v1alpha1
+kind: BackupConfiguration
+metadata:
+  name: nats-backup
+  namespace: demo
+spec:
+  target:
+    apiGroup: kubedb.com
+    kind: NATS
+    namespace: demo
+    name: nats-cluster
+  backends:
+    - name: s3-backend
+      storageRef:
+        namespace: demo
+        name: s3-storage
+      retentionPolicy:
+        name: demo-retention
+        namespace: demo
+  sessions:
+    - name: frequent-backup
+      scheduler:
+        schedule: "*/30 * * * *"
+        jobTemplate:
+          backoffLimit: 1
+      repositories:
+        - name: s3-nats-repo
+          backend: s3-backend
+          directory: /nats
+          encryptionSecret:
+            name: encrypt-secret
+            namespace: demo
+      addon:
+        name: nats-addon
+        tasks:
+          - name: logical-backup
+            params:
+              includeConsumers: "true"
+          - name: manifest-backup

docs/examples/nats/backup/backupstorage.yaml

@@ -0,0 +1,17 @@
+apiVersion: storage.kubestash.com/v1alpha1
+kind: BackupStorage
+metadata:
+  name: s3-storage
+  namespace: demo
+spec:
+  storage:
+    provider: s3
+    s3:
+      endpoint: http://minio.storage.svc:9000
+      bucket: nats-backup
+      region: us-east-1
+      secretName: s3-secret
+  usagePolicy:
+    allowedNamespaces:
+      from: All
+  deletionPolicy: WipeOut

docs/examples/nats/backup/restoresession.yaml

@@ -0,0 +1,22 @@
+apiVersion: core.kubestash.com/v1alpha1
+kind: RestoreSession
+metadata:
+  name: nats-restore
+  namespace: demo
+spec:
+  target:
+    apiGroup: kubedb.com
+    kind: NATS
+    namespace: demo
+    name: nats-restored
+  dataSource:
+    repository: s3-nats-repo
+    snapshot: latest
+    encryptionSecret:
+      name: encrypt-secret
+      namespace: demo
+  addon:
+    name: nats-addon
+    tasks:
+      - name: manifest-restore
+      - name: logical-backup-restore

docs/examples/nats/cluster/core-nats.yaml

@@ -0,0 +1,11 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-core
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 2
+  jetStream:
+    enabled: false
+  deletionPolicy: WipeOut

docs/examples/nats/cluster/custom-config.yaml

@@ -0,0 +1,14 @@
+apiVersion: v1
+kind: Secret
+metadata:
+  name: nats-custom-config
+  namespace: demo
+stringData:
+  nats.conf: |
+    ping_interval: "30s"
+    max_connections: 5000
+  accounts.conf: |
+    ORDERS {
+      jetstream: enabled
+      users: [{user: orders, password: orders-secret}]
+    }

docs/examples/nats/cluster/nats-cluster.yaml

@@ -0,0 +1,40 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-cluster
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  jetStream:
+    storageType: Durable
+    storage:
+      accessModes:
+        - ReadWriteOnce
+      resources:
+        requests:
+          storage: 10Gi
+      storageClassName: standard
+    memoryStoreSize: 256Mi
+  serverConfig:
+    maxConnections: 10000
+    maxPayload: 1048576
+  lameDuck:
+    gracePeriod: 10s
+    duration: 30s
+  podTemplate:
+    spec:
+      containers:
+        - name: nats
+          resources:
+            requests:
+              cpu: "500m"
+              memory: 1Gi
+            limits:
+              cpu: "1"
+              memory: 1Gi
+  serviceTemplates:
+    - alias: primary
+      spec:
+        type: LoadBalancer
+  deletionPolicy: WipeOut

docs/examples/nats/cluster/nats-custom-config.yaml

@@ -0,0 +1,11 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-custom
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  configuration:
+    secretName: nats-custom-config
+  deletionPolicy: WipeOut

docs/examples/nats/monitoring/builtin-prom-nats.yaml

@@ -0,0 +1,11 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-builtin-prom
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  monitor:
+    agent: prometheus.io/builtin
+  deletionPolicy: WipeOut

docs/examples/nats/monitoring/prom-operator-nats.yaml

@@ -0,0 +1,16 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-monitored
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  monitor:
+    agent: prometheus.io/operator
+    prometheus:
+      serviceMonitor:
+        labels:
+          release: prometheus
+        interval: 10s
+  deletionPolicy: WipeOut

docs/examples/nats/multi-dc/nats-distributed.yaml

@@ -0,0 +1,29 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-dc
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 6
+  distributed: true
+  jetStream:
+    storage:
+      accessModes:
+        - ReadWriteOnce
+      resources:
+        requests:
+          storage: 10Gi
+  arbiter:
+    replicas: 1
+    storage:
+      accessModes:
+        - ReadWriteOnce
+      resources:
+        requests:
+          storage: 1Gi
+  podTemplate:
+    spec:
+      podPlacementPolicy:
+        name: nats-3dc
+  deletionPolicy: WipeOut

docs/examples/nats/multi-dc/nats-gateway-a.yaml

@@ -0,0 +1,15 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: dc-a
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  gateway:
+    name: dc-a
+    remotes:
+      - name: dc-b
+        urls:
+          - nats://dc-b-pods.demo.svc.slice.local:7222
+  deletionPolicy: WipeOut

docs/examples/nats/multi-dc/nats-hub-leaf-accept.yaml

@@ -0,0 +1,15 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-hub
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 3
+  leafNodes:
+    accept: true
+  serviceTemplates:
+    - alias: leafnodes
+      spec:
+        type: LoadBalancer
+  deletionPolicy: WipeOut

docs/examples/nats/multi-dc/nats-leaf.yaml

@@ -0,0 +1,16 @@
+apiVersion: kubedb.com/v1alpha2
+kind: NATS
+metadata:
+  name: nats-edge
+  namespace: demo
+spec:
+  version: "2.15.1"
+  replicas: 1
+  leafNodes:
+    jetStreamDomain: edge
+    remotes:
+      - natsRef:
+          name: nats-hub
+          namespace: demo
+        account: APP
+  deletionPolicy: WipeOut

docs/examples/nats/multi-dc/placement-policy.yaml

@@ -0,0 +1,19 @@
+apiVersion: apps.k8s.appscode.com/v1
+kind: PlacementPolicy
+metadata:
+  name: nats-3dc
+spec:
+  clusterSpreadConstraint:
+    slice:
+      projectNamespace: kubeslice-demo
+      sliceName: demo-slice
+    distributionRules:
+      - clusterName: dc-a
+        replicaIndices: [0, 1, 2]
+        role: Member
+      - clusterName: dc-b
+        replicaIndices: [3, 4, 5]
+        role: Member
+      - clusterName: dc-c
+        replicaIndices: []
+        role: Arbiter

docs/examples/nats/opsrequests/horizontal-scaling-dc.yaml

@@ -0,0 +1,17 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: NATSOpsRequest
+metadata:
+  name: nats-hscale-dc
+  namespace: demo
+spec:
+  type: HorizontalScaling
+  databaseRef:
+    name: nats-dc
+  horizontalScaling:
+    dataCenters:
+      - clusterName: dc-a
+        replicas: 5
+      - clusterName: dc-b
+        replicas: 5
+  timeout: 1h
+  apply: IfReady

docs/examples/nats/opsrequests/horizontal-scaling.yaml

@@ -0,0 +1,13 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: NATSOpsRequest
+metadata:
+  name: nats-hscale
+  namespace: demo
+spec:
+  type: HorizontalScaling
+  databaseRef:
+    name: nats-cluster
+  horizontalScaling:
+    replicas: 5
+  timeout: 30m
+  apply: IfReady

docs/examples/nats/opsrequests/reconfigure-tls-add.yaml

@@ -0,0 +1,21 @@
+apiVersion: ops.kubedb.com/v1alpha1
+kind: NATSOpsRequest
+metadata:
+  name: nats-add-tls
+  namespace: demo
+spec:
+  type: ReconfigureTLS
+  databaseRef:
+    name: nats-cluster
+  tls:
+    issuerRef:
+      apiGroup: cert-manager.io
+      kind: Issuer
+      name: nats-ca-issuer
+    certificates:
+      - alias: server
+        subject:
+          organizations:
+            - kubedb
+  timeout: 30m
+  apply: IfReady