Verified against source code and enhanced with Docusaurus markdown features: Documentation Accuracy Fixes: - Fixed acme.md: Added "letsencrypt" as valid AUTOCONFIG value (was incorrectly shown as "-") - Added reference to ACME docs from environment-variable.md - Verified all features against actual implementation in /src Docusaurus Enhancements Added: - Admonitions (:::note, :::tip, :::warning, :::danger, :::info) for important callouts - Code block titles for all bash/yaml examples (e.g., title="Install EasyHAProxy") - Better structured warnings and notes for limitations - Improved formatting and readability throughout Files Enhanced: - kubernetes.md: Added info boxes, warnings, code titles - docker.md: Added limitation warnings, code titles - swarm.md: Added advantage tips, limitation warnings - acme.md: Fixed Let's Encrypt autoconfig, enhanced requirements with admonitions - ssl.md: Added code block titles for all examples - static.md: Added live reload tip, SSL certificate note - container-labels.md: Added definition explanation, code titles - limitations.md: Restructured with clear warnings and explanations - helm.md: Added warnings, code titles - microk8s.md: Added ingress controller warning, code titles - volumes.md: Added info box about volume purposes - other.md: Added code block titles - environment-variable.md: Added ACME reference note All changes verified against actual Python source code implementation.
80 lines
1.9 KiB
Markdown
80 lines
1.9 KiB
Markdown
---
|
|
sidebar_position: 6
|
|
---
|
|
|
|
# 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.
|
|
|
|
## Enabling EasyHAProxy on MicroK8s
|
|
|
|
EasyHAProxy is being part of official MicroK8s Community edition since MicroK8s version 1.27.
|
|
|
|
Just enable the community add-on:
|
|
|
|
```bash title="Enable community addons"
|
|
microk8s enable community
|
|
```
|
|
|
|
and you'll see:
|
|
|
|
```
|
|
$ microk8s status
|
|
|
|
microk8s is running
|
|
...
|
|
addons:
|
|
...
|
|
disabled:
|
|
easyhaproxy # (community) EasyHAProxy can detect and configure HAProxy automatically based on ingress labels
|
|
```
|
|
|
|
However, if you are using MicroK8s before 1.27 you need to enable it directly from the ByJG repository by accessing the microk8s host machine and run:
|
|
|
|
```bash title="Add ByJG addon repository"
|
|
microk8s addons repo add byjg https://github.com/byjg/microk8s-addons.git
|
|
```
|
|
|
|
And you should see:
|
|
|
|
```text
|
|
$ microk8s status
|
|
|
|
microk8s is running
|
|
...
|
|
addons:
|
|
...
|
|
disabled:
|
|
easyhaproxy # (byjg) EasyHAProxy can detect and configure HAProxy automatically based on ingress labels
|
|
....
|
|
```
|
|
|
|
## Installing EasyHAProxy addon
|
|
|
|
Once you have enable the EasyHAProxy from the community repository or from ByJG repository and can enable it by running:
|
|
|
|
Usage:
|
|
|
|
Install as a Daemonset:
|
|
|
|
```bash title="Install as DaemonSet"
|
|
microk8s enable easyhaproxy
|
|
```
|
|
|
|
Install as a NodePort:
|
|
|
|
```bash title="Install as NodePort"
|
|
microk8s enable easyhaproxy --nodeport
|
|
```
|
|
|
|
:::warning Disable Other Ingress Controllers
|
|
You need to disable any ingress controller you have previously installed (e.g., nginx, traefik, etc.) before installing EasyHAProxy to avoid conflicts.
|
|
:::
|
|
|
|
For more parameters you can refer to the [Kubernetes](kubernetes.md) page.
|
|
|
|
----
|
|
[Open source ByJG](http://opensource.byjg.com)
|