flux-operator-local-dev

Flux Operator local dev environment with Docker and Kubernetes KIND.

Get started

Start by cloning the repository locally:

git clone https://github.com/controlplaneio-fluxcd/flux-operator-local-dev.git
cd flux-operator-local-dev

The following tools are required:

On macOS, you can install all the required tools with Homebrew by running:

make tools

Start the dev environment with:

make up

The make up command performs the following steps:

creates the Docker registry container if it's not already running and exposes it on localhost:5050
creates the Kubernetes Kind cluster if it's not already running
pushes the Kubernetes manifests as OCI artifacts to the local registry
- locahost:5050/flux-cluster-sync is generated from kubernetes/clusters/local
- locahost:5050/flux-infra-sync is generated from kubernetes/infra
- locahost:5050/flux-apps-sync is generated from kubernetes/apps
installs Flux Operator on the cluster and configures it to reconcile the manifests from the local registry
waits for Flux to reconcile the cluster addons from oci://flux-registry:5000/flux-infra-sync
waits for Flux to reconcile the demo apps from oci://flux-registry:5000/flux-apps-sync

To sync changes to the Kubernetes manifests, run:

make sync

The make sync command pushes the Kubernetes manifests to the local registry and waits for Flux to reconcile the changes on the cluster.

To tear down the dev environment, run:

make down

The make up command deletes the Kind cluster and the Docker registry container.