Minikube and Helm medea-demo app integration (#34)

Makefile

@@ -204,25 +204,29 @@ release.jason:
 # Docker commands #
 ###################
 
+docker-env = $(strip $(if $(call eq,$(minikube),yes),\
+	$(subst export,,$(shell minikube docker-env | cut -d '\#' -f1)),))
+
 # Build Docker image for demo application.
 #
 # Usage:
-#	make docker.build.demo [TAG=(dev|<tag>)]
+#	make docker.build.demo [TAG=(dev|<tag>)] [minikube=(no|yes)]
 
 docker-build-demo-image-name = $(DEMO_IMAGE_NAME)
 
 docker.build.demo:
 	@make yarn proj=demo
-	docker build \
+	$(docker-env) \
+	docker build $(if $(call eq,$(minikube),yes),,--network=host) \
 		-t $(docker-build-demo-image-name):$(if $(call eq,$(TAG),),dev,$(TAG)) \
 		jason/demo
 
 
 # Build medea project Docker image.
 #
 # Usage:
-#	make docker.build.medea [TAG=(dev|<tag>)]
-#	                  [debug=(yes|no)] [no-cache=(no|yes)]
+#	make docker.build.medea [TAG=(dev|<tag>)] [debug=(yes|no)]
+#	                  [no-cache=(no|yes)] [minikube=(no|yes)]
 
 docker-build-medea-image-name = $(MEDEA_IMAGE_NAME)
 
@@ -237,7 +241,8 @@ ifneq ($(no-cache),yes)
 endif
 	$(call docker.build.clean.ignore)
 	@echo "!target/$(if $(call eq,$(debug),no),release,debug)/" >> .dockerignore
-	docker build --network=host --force-rm \
+	$(docker-env) \
+	docker build $(if $(call eq,$(minikube),yes),,--network=host) --force-rm \
 		$(if $(call eq,$(no-cache),yes),\
 			--no-cache --pull,) \
 		$(if $(call eq,$(IMAGE),),\
@@ -309,6 +314,98 @@ up.medea:
 
 
 
+##############################
+# Helm and Minikube commands #
+##############################
+
+helm-cluster = $(if $(call eq,$(cluster),),minikube,$(cluster))
+
+# Upgrade (or initialize) Tiller (server side of Helm) of Minikube.
+#
+# Usage:
+#	make helm.init [client-only=no [upgrade=(yes|no)]]
+#	               [client-only=yes]
+
+helm.init:
+	helm init --wait \
+		$(if $(call eq,$(client-only),yes),\
+			--client-only,\
+			--kube-context=minikube --tiller-namespace=kube-system \
+				$(if $(call eq,$(upgrade),no),,--upgrade))
+
+
+# Run project in Minikube Kubernetes cluster as Helm release.
+#
+# Usage:
+#	make helm.up [rebuild=(no|yes) [no-cache=(no|yes)]] [wait=(yes|no)]
+#                [release=(dev|<current-git-branch>|<release-name>)]
+
+helm.up:
+ifeq ($(rebuild),yes)
+	@make docker.build.medea no-cache=$(no-cache) minikube=yes TAG=dev
+endif
+	helm upgrade --install minikube _helm/medea-demo/ \
+			$(if $(call eq,$(wait),no),,\
+				--wait )
+
+
+# Remove Helm release of project from Kubernetes Minikube cluster.
+#
+# Usage:
+#	make helm.down
+
+helm.down:
+	$(if $(shell helm ls | grep 'minikube'),\
+		helm del --purge minikube ,\
+		@echo "--> No 'minikube' release found in $(helm-cluster) cluster")
+
+
+# Lint project Helm chart.
+#
+# Usage:
+#	make helm.lint
+
+helm.lint:
+	helm lint _helm/medea-demo/
+
+
+# Bootstrap Minikube cluster (local Kubernetes) for development environment.
+#
+# The bootsrap script is updated automatically to the latest version every day.
+# For manual update use 'update=yes' command option.
+#
+# Usage:
+#	make minikube.boot [update=(no|yes)]
+#	                   [driver=(virtualbox|hyperkit|hyperv)]
+#	                   [k8s-version=<kubernetes-version>]
+
+minikube.boot:
+ifeq ($(update),yes)
+	$(call minikube.boot.download)
+else
+ifeq ($(wildcard $(HOME)/.minikube/bootstrap.sh),)
+	$(call minikube.boot.download)
+else
+ifneq ($(shell find $(HOME)/.minikube/bootstrap.sh -mmin +1440),)
+	$(call minikube.boot.download)
+endif
+endif
+endif
+	@$(if $(cal eq,$(driver),),,MINIKUBE_VM_DRIVER=$(driver)) \
+	 $(if $(cal eq,$(k8s-version),),,MINIKUBE_K8S_VER=$(k8s-version)) \
+		$(HOME)/.minikube/bootstrap.sh
+define minikube.boot.download
+	$()
+	@mkdir -p $(HOME)/.minikube/
+	@rm -f $(HOME)/.minikube/bootstrap.sh
+	curl -fL -o $(HOME)/.minikube/bootstrap.sh \
+		https://raw.githubusercontent.com/instrumentisto/toolchain/master/minikube/bootstrap.sh
+	@chmod +x $(HOME)/.minikube/bootstrap.sh
+endef
+
+
+
+
 ##################
 # .PHONY section #
 ##################
@@ -318,6 +415,8 @@ up.medea:
         docker.build.demo docker.build.medea docker.down.demo docker.up.demo \
         docs docs.rust \
         release.jason \
+        helm helm.down helm.init helm.up \
+        minikube.boot \
         test test.unit \
         up up.coturn up.demo up.dev up.jason up.medea \
         yarn

dev/coturn/turnserver.conf → _dev/coturn/turnserver.conf

@@ -3,8 +3,6 @@ fingerprint
 no-cli
 no-tls
 no-dtls
-min-port=49160
-max-port=49200
 realm=medea
 redis-userdb="ip=127.0.0.1 port=6379 dbname=0 password=turn"
 user=USER:PASS

_helm/medea-demo/Chart.yaml

@@ -0,0 +1,4 @@
+apiVersion: v1
+name: medea-demo
+version: 0.0.1
+appVersion: 0.0.0

_helm/medea-demo/conf/medea.toml

@@ -0,0 +1,67 @@
+[server]
+# IP address to bind HTTP server to.
+   bind_ip = "0.0.0.0"
+
+# Port to bind HTTP server to.
+   bind_port = 8080
+
+
+
+
+[rpc]
+# Duration, after which remote RPC client will be considered idle if no
+# heartbeat messages received.
+   idle_timeout = "10s"
+
+# Duration, after which the server deletes the client session if
+# the remote RPC client does not reconnect after it is idle.
+   reconnect_timeout = "10s"
+
+
+
+
+[turn]
+# Turn server IP address.
+   ip = "127.0.0.1"
+
+# Turn server port.
+   port = 3478
+
+# Static user on Turn server.
+   user = "USER"
+
+# Static user password on Turn server.
+   pass = "PASS"
+
+[turn.db.redis]
+# Host of Coturn's Redis database.
+   host = "127.0.0.1"
+
+# Port of Coturn's Redis database for client connections.
+   port = 6379
+
+# Password to connect to Coturn's Redis database with.
+   pass = "turn"
+
+# Number of Coturn's database in Redis.
+   db_number = 0
+
+# Timeout for establishing connection with Coturn's Redis database.
+   connection_timeout = "5s"
+
+
+
+
+[log]
+# Maximum allowed level of application log entries.
+#
+# Possible values:
+#   "OFF", "CRITICAL", "ERROR", "WARN", "INFO", "DEBUG", "TRACE"
+   level = "DEBUG"
+
+
+
+
+[shutdown]
+# Maximum duration given to shutdown the whole application gracefully.
+   timeout = "5s"

_helm/medea-demo/conf/redis.conf

@@ -0,0 +1,3 @@
+requirepass turn
+timeout 0
+tcp-keepalive 60

_helm/medea-demo/conf/turnserver.conf

@@ -0,0 +1,8 @@
+lt-cred-mech
+fingerprint
+no-cli
+no-tls
+no-dtls
+realm=medea
+redis-userdb="ip=127.0.0.1 port=6379 dbname=0 password=turn"
+user=USER:PASS

_helm/medea-demo/templates/ingress.yaml

@@ -0,0 +1,40 @@
+{{- if .Values.ingress.enabled -}}
+{{- range $i, $host := .Values.ingress.hosts }}
+---
+kind: Ingress
+apiVersion: extensions/v1beta1
+metadata:
+  name: webclient.{{ $host }}
+spec:
+{{- if $.Values.ingress.tls.enabled }}
+  tls:
+    - hosts:
+        - {{ $host | quote }}
+        - {{ printf "www.%s" $host | quote }}
+      secretName: medea-demo-cert
+{{- end }}
+  rules:
+    - host: {{ $host | quote }}
+      http:
+        paths:
+          - path: /ws
+            backend:
+              serviceName: medea
+              servicePort: http
+          - path: /
+            backend:
+              serviceName: webclient
+              servicePort: http
+    - host: {{ printf "www.%s" $host | quote }}
+      http:
+        paths:
+          - path: /ws
+            backend:
+              serviceName: medea
+              servicePort: http
+          - path: /
+            backend:
+              serviceName: webclient
+              servicePort: http
+{{- end }}
+{{- end -}}

_helm/medea-demo/templates/medea-config-map.yml

@@ -0,0 +1,11 @@
+apiVersion: v1
+data:
+  redis.conf: |
+    {{- tpl (.Files.Get "conf/redis.conf") . | nindent 4 }}
+  coturn.turnserver.conf: |
+    {{- tpl (.Files.Get "conf/turnserver.conf") . | nindent 4 }}
+  medea.toml: |
+    {{- tpl (.Files.Get "conf/medea.toml") . | nindent 4 }}
+kind: ConfigMap
+metadata:
+  name: medea.config

_helm/medea-demo/templates/medea-deployment.yaml

@@ -0,0 +1,77 @@
+kind: Deployment
+apiVersion: apps/v1
+metadata:
+  name: medea
+  labels:
+    app: medea
+    tier: backend
+spec:
+  selector:
+    matchLabels:
+      app: medea
+      tier: backend
+  template:
+    spec:
+      hostNetwork: true
+      containers:
+        - name: medea
+          image: "{{ $.Values.medea.image.repository }}:{{ $.Values.medea.image.tag }}"
+          imagePullPolicy: {{ $.Values.medea.image.pullPolicy }}
+          env:
+            - name: MEDEA_CONF
+              value: '/etc/medea.toml'
+          ports:
+            - name: medea-http
+              containerPort: 8080
+          volumeMounts:
+            - name: config
+              subPath: medea.toml
+              mountPath: /etc/medea.toml
+              readOnly: true
+        - name: coturn-db
+          image: redis:alpine
+          imagePullPolicy: IfNotPresent
+          args: ['redis-server', '/etc/redis.conf']
+          volumeMounts:
+            - name: config
+              subPath: redis.conf
+              mountPath: /etc/redis.conf
+              readOnly: true
+          livenessProbe:
+            exec:
+              command: ['redis-cli', 'ping']
+            initialDelaySeconds: 30
+          readinessProbe:
+            exec:
+              command: ['redis-cli', 'ping']
+            initialDelaySeconds: 5
+        - name: coturn
+          image: instrumentisto/coturn:4.5
+          imagePullPolicy: Always
+          args:
+            - --verbose
+            - --log-file=stdout
+          ports:
+            - name: turn
+              containerPort: 3478
+              protocol: TCP
+            - name: turn-udp
+              containerPort: 3478
+              protocol: UDP
+          volumeMounts:
+            - name: config
+              subPath: coturn.turnserver.conf
+              mountPath: /etc/coturn/turnserver.conf
+              readOnly: true
+            - name: coturn-data
+              mountPath: /var/lib/coturn
+      volumes:
+        - name: config
+          configMap:
+            name: medea.config
+        - name: coturn-data
+          emptyDir: {}
+    metadata:
+      labels:
+        app: medea
+        tier: backend

_helm/medea-demo/templates/medea-service.yaml

@@ -0,0 +1,15 @@
+kind: Service
+apiVersion: v1
+metadata:
+  name: medea
+  labels:
+    app: medea
+    tier: backend
+spec:
+  selector:
+    app: medea
+    tier: backend
+  ports:
+    - name: http
+      port: 80
+      targetPort: 8080