Documentation on DO setup

Author: ranguard

README.md

@@ -5,6 +5,11 @@ Welcome to kubernetes MetaCPAN!
 This documents the kubernetes implementation for MetaCPAN. This is a work in
 progress document, more details will be added to the document as required.
 
+## Docs:
+
+- [QuickStart](./docs/QuickStart.md)
+- [Digital Ocean Setup](./docs/DigitalOceanSetup.md)
+
 ## Cluster deployment
 
 - We deploy to DigitalOcean (DO)

docs/DigitalOceanSetup.md

@@ -0,0 +1,39 @@
+
+# Digital Ocean Setup
+
+[Best practices](https://docs.digitalocean.com/developer-center/digitalocean-kubernetes-infrastructure-best-practices/)
+
+## Network setup
+
+```mermaid
+graph TD
+    Fastly --> DOCluster
+    subgraph DOCluster
+        DO_Loadbalancer --> Nginx_LB
+        Nginx_LB --> Node1
+        Nginx_LB --> Node2
+        Nginx_LB --> Node3
+    end
+    subgraph Node1
+        Node1_Service1[Node 1 Services]
+    end
+    subgraph Node2
+        Node2_Service1[Node 2 Services]
+    end
+    subgraph Node3
+        Node3_Service1[Node 3 Services]
+    end
+```
+We run 3 Nginx Ingress Load balancers, and will eventually setup so one per node, but they will load balance across all 3 nodes. 
+
+## Database
+
+- [Database Operator docs](https://docs.digitalocean.com/products/kubernetes/how-to/use-operator/)
+- [Our deployment manifests](../platform/postgres/)
+
+## Disk volumes
+
+- [Volume Docs](https://docs.digitalocean.com/products/kubernetes/how-to/add-volumes/)
+- [Sharing with NFS](
+https://github.com/kubernetes-sigs/nfs-ganesha-server-and-external-provisioner)
+- [Our deployment manifests](../platform/nfs-provisioner/)

docs/QuickStart.md

@@ -1,27 +1,24 @@
 # Quick Start
 
-This document gets you up and communicating with the k8s cluster quickly as such
-it's light on details.
+This document gets you up and communicating with the k8s cluster quickly, as such it's light on details.
 
 ## Access
 
-Copy the relevant cluster config e.g [hz-mc.kubeconfig](https://github.com/metacpan/metacpan-credentials/blob/master/k8s/hz-mc.kubeconfig) or [https://github.com/metacpan/metacpan-credentials/blob/master/k8s/hc-mc.kubeconfig](hc-mc.kubeconfig) to `$HOME/.kube/config` (note those are in a private repo for mc admins only).
-
-```sh
-mkdir $HOME/.kube
-cd $HOME/.kube
-cp ~/git/metacpan-credentials/k8s/hz-mc.kubeconfig ./config
-```
+Download the cluster config file from https://cloud.digitalocean.com/kubernetes/clusters/490ad197-959c-4024-945b-547fc99415ef?i=5289ac to `$HOME/.kube/config` 
 
 ## Browsing the cluster, looking at logs, accessing the container
+Use: https://argocd.do.metacpan.org/ with your github account
+
+Or:
+
 1. [Install k9s](https://k9scli.io/topics/install/)
 2. Run `k9s` from the command line
 3. Browse the cluster
 
 ## Deploying applications
 
 1. [Install kubectl](https://kubernetes.io/docs/tasks/tools/#kubectl)
-2. Use the `kubectl apply -k <directory path>` ( e.g. `kubectl apply -k apps/web/hz` ) command to deploy an application
+2. Use the `kubectl apply -k <directory path>` ( e.g. `kubectl apply -k apps/web/argo` ) command to deploy an application
    to a cluster. Use the appropriate directory structure to deploy the
    application to the intended environment.