☸️ Kubernetes installation

We provide an easy kubernetes installation based on Kustomize to deploy the complete Bleemeo Community Edition stack. However, the default kustomization isn't properly configured and should be used with caution.

Deploying with kubernetes

Starts by creating a kustomization.yaml file in your project:

resources:
- github.com/bleemeo/bleemeo-community-edition/kubernetes?ref=main

warning

The default kustomization lacks necessary security measures. Ensure you implement the required security steps before using it in a production environment.

Create the namespace used to run Bleemeo community edition PODs

kubectl create namespace bleemeo-community-edition

Then, apply the kustomization to your cluster:

kubectl apply -k .

After a few minutes, you should have the Bleemeo Community Edition stack running in your cluster.

tip

Now that the stack is up and running, you can setup your first agent by following the agent installation guide.

Configuration

The Kustomization let you configure the Bleemeo stack by overriding the default configuration or by patching the resources.

tip

Refer to the Kustomize documentation to learn more about how to customize the resources.

Override nats configuration

Now let's say you want to override the nats configuration, start by creating your own nats config:

# nats.conf
server_name: "my-bleemeo-mqtt"

jetstream {}

mqtt {
   port: 1883
}

Then, edit your kustomization.yaml file in your project:

configMapGenerator:
- name: nats-config
  files:
  - nats.conf

resources:
- github.com/bleemeo/bleemeo-community-edition/kubernetes?ref=main

As a result, the nats deployment will use your custom configuration.

Changing the number of replicas

You can also change the number of replicas of squirreldb (or any other components) by symply specifying the number of replicas in your kustomization.yaml file:

replicas:
- name: squirreldb
  count: 3

resources:
- github.com/bleemeo/bleemeo-community-edition/kubernetes?ref=main