Add MicroK8s, Helm and Dokku to the documentation

docs/dokku.md

@@ -0,0 +1,7 @@
+# Dokku
+
+Dokku is a Docker powered mini-Heroku in around 100 lines of Bash. It is the smallest PaaS implementation you've ever seen, weighing in at a little over 100 MB of memory usage and about 80 MB of disk space.
+
+## Installing EasyHAProxy on Dokku
+
+Please refer to the [official documentation](https://github.com/dokku/dokku/blob/master/docs/networking/proxies/haproxy.md).

docs/helm.md

@@ -0,0 +1,79 @@
+# Helm 3
+
+Helm is a package manager for Kubernetes. It allows you to install and manage applications on Kubernetes.
+
+## Setup EasyHAProxy with Helm 3
+
+### 1) Identify the node where your EasyHAProxy container will run
+
+EasyHAProxy will be limited to a single node. To understand that see [limitations](limitations.md) page.
+
+```bash
+$ kubectl get nodes
+
+NAME      STATUS   ROLES    AGE    VERSION
+node-01   Ready    <none>   561d   v1.21.13-3
+node-02   Ready    <none>   561d   v1.21.13-3
+```
+
+Add the EasyHAProxy label to the node.
+
+```bash
+kubectl label nodes node-01 "easyhaproxy/node=master"
+```
+
+### 2) Install EasyHAProxy
+
+Minimal configuration
+
+```bash
+helm repo add byjg https://opensource.byjg.com/helm
+helm repo update byjg
+kubectl create namespace easyhaproxy
+
+helm upgrade --install ingress byjg/easyhaproxy \
+    --namespace easyhaproxy \
+    --set resources.requests.cpu=100m \
+    --set resources.requests.memory=128Mi
+```
+
+Customizing Helm Values:
+
+```yaml
+easyhaproxy:
+  stats:
+    username: admin
+    password: password
+  refresh: "10"
+  customErrors: "true"
+  sslMode: loose
+  logLevel:
+    certbot: DEBUG
+    easyhaproxy: DEBUG
+    haproxy: DEBUG
+  letsencrypt:
+    email: ""
+
+service:
+  create: false          # If false, it will create a DaemonSet with hostPort. The easiest. 
+  type: ClusterIP        # or NodePort
+  annotations: {}
+
+binding:
+  ports:
+    http: 80
+    https: 443
+    stats: 1936
+  additionalPorts: []
+
+# Make sure to create this
+masterNode:
+  label: easyhaproxy/node
+  values: 
+    - master
+```
+
+For more parameters you can refer to the [Kubernetes](kubernetes.md) page.
+
+----
+[Open source ByJG](http://opensource.byjg.com)

docs/kubernetes.md

@@ -12,7 +12,7 @@ There are three installation modes:
 
 To install EasyHAProxy in your cluster, follow these steps:
 
-### 1) Identify the node where your EasyHAProxy container will run.
+### 1) Identify the node where your EasyHAProxy container will run
 
 EasyHAProxy will be limited to a single node. To understand that see [limitations](limitations.md) page.
 
@@ -30,11 +30,7 @@ Add the EasyHAProxy label to the node.
 kubectl label nodes node-01 "easyhaproxy/node=master"
 ```
 
-### 2) Install EasyHAProxy
-
-You can install EasyHAProxy in a Kubernetes cluster using Kubernetes Manifest or Helm 3.
-
-#### 2.1.) Using Kubernetes Manifest
+### 2) Install EasyHAProxy with Kubernetes Manifest
 
 ```bash
 kubectl create namespace easyhaproxy
@@ -45,57 +41,6 @@ kubectl apply -f \
 
 If necessary, you can configure environment variables. To get a list of the variables, please follow the [docker container environment](docker-environment.md)
 
-#### 2.2) Using HELM 3
-
-Minimal configuration
-
-```bash
-helm repo add byjg https://opensource.byjg.com/helm
-helm repo update byjg
-kubectl create namespace easyhaproxy
-
-helm upgrade --install ingress byjg/easyhaproxy \
-    --namespace easyhaproxy \
-    --set resources.requests.cpu=100m \
-    --set resources.requests.memory=128Mi
-```
-
-Customizing Helm Values:
-
-```yaml
-easyhaproxy:
-  stats:
-    username: admin
-    password: password
-  refresh: "10"
-  customErrors: "true"
-  sslMode: loose
-  logLevel:
-    certbot: DEBUG
-    easyhaproxy: DEBUG
-    haproxy: DEBUG
-  letsencrypt:
-    email: ""
-
-service:
-  create: false          # If false, it will create a DaemonSet with hostPort. The easiest. 
-  type: ClusterIP        # or NodePort
-  annotations: {}
-
-binding:
-  ports:
-    http: 80
-    https: 443
-    stats: 1936
-  additionalPorts: []
-
-# Make sure to create this
-masterNode:
-  label: easyhaproxy/node
-  values: 
-    - master
-```
-
 ## Running containers
 
 Your container only requires creating an ingress with the annotation `kubernetes.io/ingress.class: easyhaproxy-ingress` pointing to your service.

docs/microk8s.md

@@ -0,0 +1,52 @@
+# Microk8s Add-ons
+
+Microk8s is a lightweight Kubernetes distribution that can run on a single machine. It is very easy to install and use.
+You can add custom addons to your Microk8s installation.
+Here are the steps to install EasyHAProxy on your Microk8s.
+
+## Installing ByJG repository
+
+Before install the addons, you need to add the ByJG repository to your Microk8s installation.
+
+1. Access the microk8s host machine and run:
+
+```shell
+microk8s addons repo add byjg https://github.com/byjg/microk8s-addons.git
+```
+
+2. Check if it is installed:
+
+```text
+$ microk8s status
+
+microk8s is running
+...
+addons:
+  ...
+  disabled:
+    easyhaproxy          # (byjg) EasyHAProxy can detect and configure HAProxy automatically based on ingress labels
+    ....
+```
+
+## Installing EasyHAProxy addon
+
+EasyHAProxy can detect and configure HAProxy automatically based on ingress labels.
+
+Usage:
+
+Install as a Daemonset
+
+```shell
+microk8s enable easyhaproxy
+```
+
+Install as a NodePort
+
+```shell
+microk8s enable easyhaproxy --nodeport
+```
+
+For more parameters you can refer to the [Kubernetes](kubernetes.md) page.
+
+----
+[Open source ByJG](http://opensource.byjg.com)