bfd38adea5
- Introduced `/scripts/.venv/bin/easy-haproxy` as the default entrypoint for standalone environments. - Added `_build_parser` and `start` functions to enable CLI-driven functionality configuration. - Updated packaging to reflect new `easyhaproxy.main` module and adapted project name from `easymapping` to `easyhaproxy`. - Modified `Dockerfile` to align with new script paths and entrypoints for better portability. - Enhanced documentation with dedicated sections for pip-based installation, CLI references, and systemd setup for non-Docker environments. - Adjusted helm, plugin, and environment-related docs for accurate sidebar ordering. - Added a new GitHub workflow to automate package publishing to PyPI.
80 lines
1.9 KiB
Markdown
80 lines
1.9 KiB
Markdown
---
|
|
sidebar_position: 7
|
|
---
|
|
|
|
# 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)
|