Low-Level Orchestrator for K8s

K8s Operator developed using Operator-SDK for Infrastructure Elements of Kubernetes type.

Description

This Operator watches for a new ServiceComponentK8s (K8s Custom Resource) deployment in the K8s cluster and then deploys a K8s Deployment and a linked service in the same K8s cluster.

Technology

This project aims to follow the Kubernetes Operator pattern.

It uses Controllers, which provide a reconcile function responsible for synchronizing resources until the desired state is reached on the cluster.

NOTE: Run make --help for more information on all potential make targets

More information can be found via the Kubebuilder Documentation

Deployment in a K8s cluster

K8s manifests

All the needed K8s manifests have been packaged into a single YAML file: operator-deployment.yaml

kubectl apply -f operator-deployment.yaml

You can also create these manifests by running the below command, but some modifications may be needed.

bin/kustomize build config/default > operator-deployment.yaml

Helm chart

A Helm chart has been created and uploaded to the Eclipse aeriOS Helm chart repository.

helm repo add eclipse-aerios https://eclipse-aerios.github.io/resources/charts

helm install aerios-llo-k8s eclipse-aerios/llo-k8s --debug

Local development using Operator SDK

A K8s cluster is required. The controller will automatically use the current context in your kubeconfig file (i.e. whatever cluster kubectl cluster-info shows).

Run the Operator

1. Generate CRDs and other needed manifests

make manifests

2. Generate internal operator-sdk code

make generate

3. Install the CRDs into the cluster:

make install

4. Run the controller (this will run in the foreground, so switch to a new terminal if you want to leave it running):

make run

NOTE: You can also run this in one step by running: make install run

5. Install example Instances of Custom Resources:

kubectl apply -f config/samples/

Generate and upload the Docker image

1. Build and push your image to the location specified by IMG:

make docker-build docker-push IMG=<some-registry>/aeros-llo-k8s-operator-sdk:tag

To upload the image to the common deployments repo (Docker login is required):

make docker-build docker-push IMG=eclipseaerios/llo-k8s-operator:1.4.1

For multi-arch images:

make docker-buildx-gitlab IMG=eclipseaerios/llo-k8s-operator:1.4.1

2. Deploy the controller to the cluster with the image specified by IMG:

make deploy IMG=<some-registry>/aeros-llo-k8s-operator-sdk:tag

To deploy the image to the common deployments repo (Docker login is required):

make deploy IMG=eclipseaerios/llo-k8s-operator:1.4.1

Uninstall the Operator

First, undeploy the controller from the cluster:

make undeploy

Then, delete the CRDs from the cluster:

make uninstall

License

Copyright 2025 aeriOS HE project.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.