Merge pull request #312 from CodeForPhilly/kind-cluster

create: local kind cluster

Author: taichan03

.gitignore

@@ -1,3 +1,3 @@
-config
-config/env/env.dev
+config/*
 .idea/
+env*

README.md

@@ -46,6 +46,40 @@ Running pgAdmin:
 - The first time you use `pgAdmin` after building the Docker containers you will need to register the server. 
 The `Host name/address`, `Username` and `Password` are specified in  `balancer-main/docker-compose.yml`
 
+## Local Kubernetes Deployment
+
+### Prereqs
+
+- Fill the configmap with the [env vars](./deploy/manifests/balancer/base/configmap.yml)
+- Install [Devbox](https://www.jetify.com/devbox)
+- Run the following script with admin privileges:
+
+```bash
+HOSTNAME="balancertestsite.com"
+LOCAL_IP="127.0.0.1"
+
+# Check if the correct line already exists
+if grep -q "^$LOCAL_IP[[:space:]]\+$HOSTNAME" /etc/hosts; then
+  echo "Entry for $HOSTNAME with IP $LOCAL_IP already exists in /etc/hosts"
+else
+  echo "Updating /etc/hosts for $HOSTNAME"
+  sudo sed -i "/[[:space:]]$HOSTNAME/d" /etc/hosts
+  echo "$LOCAL_IP      $HOSTNAME" | sudo tee -a /etc/hosts
+fi
+```
+
+### Steps to reproduce
+
+Inside root dir of balancer
+
+```bash
+devbox shell
+devbox create:cluster
+devbox run deploy:balancer
+```
+
+The website should be available in [https://balancertestsite.com:30219/](https://balancertestsite.com:30219/)
+
 ## Architecture
 
 The Balancer website is a Postgres, Django REST, and React project. The source code layout is:

deploy/kind-config.yml

@@ -0,0 +1,9 @@
+kind: Cluster
+apiVersion: kind.x-k8s.io/v1alpha4
+nodes:
+  - role: control-plane
+    extraPortMappings:
+      - containerPort: 31880
+        hostPort: 31880
+      - containerPort: 30219
+        hostPort: 30219

deploy/manifests/balancer/base/configmap.yml

@@ -0,0 +1,19 @@
+apiVersion: v1
+data:
+  DEBUG: "1"
+  SECRET_KEY: "foo"
+  DJANGO_ALLOWED_HOSTS: "localhost 127.0.0.1 [::1] balancertestsite.com"
+  SQL_ENGINE: "django.db.backends.postgresql"
+  SQL_DATABASE: "balancer_dev"
+  SQL_USER: "balancer"
+  SQL_PASSWORD: ""
+  SQL_HOST: ""
+  SQL_PORT: "5432"
+  DATABASE: "postgres"
+  LOGIN_REDIRECT_URL: ""
+  OPENAI_API_KEY: ""
+  PINECONE_API_KEY: ""
+  REACT_APP_API_BASE_URL: "https://balancertestsite.com/"
+kind: ConfigMap
+metadata:
+  name: balancer-config

deploy/manifests/balancer/base/deployment.yml

@@ -0,0 +1,32 @@
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  labels:
+    app: balancer
+    service: backend
+  name: balancer
+spec:
+  replicas: 1
+  selector:
+    matchLabels:
+      app: balancer
+  strategy: {}
+  template:
+    metadata:
+      labels:
+        app: balancer
+    spec:
+      containers:
+        - image: chrissst/balancer
+          name: balancer
+          envFrom:
+            - configMapRef:
+                name: balancer-config
+          ports:
+            - containerPort: 8000
+          readinessProbe:
+            httpGet:
+              path: /
+              port: 8000
+            initialDelaySeconds: 30
+            periodSeconds: 10

deploy/manifests/balancer/base/ingress.yml

@@ -0,0 +1,23 @@
+apiVersion: networking.k8s.io/v1
+kind: Ingress
+metadata:
+  name: balancer
+  annotations:
+    cert-manager.io/cluster-issuer: "letsencrypt-staging"
+spec:
+  ingressClassName: nginx
+  tls:
+    - hosts:
+        - balancertestsite.com
+      secretName: balancer-tls
+  rules:
+    - host: balancertestsite.com
+      http:
+        paths:
+          - path: /
+            pathType: Prefix
+            backend:
+              service:
+                name: balancer
+                port:
+                  number: 80

deploy/manifests/balancer/base/kustomization.yml

@@ -0,0 +1,8 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+resources:
+  - deployment.yml
+  - service.yml
+  - configmap.yml
+  - ingress.yml

deploy/manifests/balancer/base/service.yml

@@ -0,0 +1,13 @@
+apiVersion: v1
+kind: Service
+metadata:
+  name: balancer
+  labels:
+    app: balancer
+spec:
+  ports:
+    - name: http
+      port: 80
+      targetPort: 8000
+  selector:
+    app: balancer

deploy/manifests/balancer/overlays/dev/kustomization.yml

@@ -0,0 +1,11 @@
+apiVersion: kustomize.config.k8s.io/v1beta1
+kind: Kustomization
+
+resources:
+  - "../../base"
+
+images:
+  - name: chrissst/balancer
+    newTag: v1
+
+namespace: balancer

deploy/manifests/cert-manager/clusterissuer.yml

@@ -0,0 +1,15 @@
+# clusterissuer-staging.yaml
+apiVersion: cert-manager.io/v1
+kind: ClusterIssuer
+metadata:
+  name: letsencrypt-staging
+spec:
+  acme:
+    server: https://acme-staging-v02.api.letsencrypt.org/directory
+    email: [email protected]
+    privateKeySecretRef:
+      name: letsencrypt-staging-key
+    solvers:
+      - http01:
+          ingress:
+            class: nginx