Add Terraform install example

[stefanprodan]

This PR adds an example under config/terraform to demonstrate how to deploy Flux on a Kubernetes cluster using Terraform and the flux-operator and flux-instance Helm charts.

Note

The flux-instance Helm chart is needed because the Hashicorp Kubernetes provider can't do CRDs and CRs in the same module, xref: hashicorp/terraform-provider-kubernetes#1367

Usage

Create a Kubernetes cluster using KinD:

kind create cluster --name flux

Install the Flux Operator and deploy the Flux instance on the cluster:

terraform apply \
  -var flux_version="2.x" \
  -var flux_registry="ghcr.io/fluxcd" \
  -var git_token="${GITHUB_TOKEN}" \
  -var git_url="https://github.com/fluxcd/flux2-kustomize-helm-example.git" \
  -var git_ref="refs/heads/main" \
  -var git_path="clusters/production"

Verify the Flux components are running:

kubectl -n flux-system get pods

Verify the Flux instance is syncing the cluster state from the Git repository:

kubectl -n flux-system get fluxreport/flux -o yaml

The output should show the sync status:

apiVersion: fluxcd.controlplane.io/v1
kind: FluxReport
metadata:
  name: flux
  namespace: flux-system
spec:
  # Distribution status omitted for brevity
  sync:
    id: kustomization/flux-system
    path: clusters/production
    ready: true
    source: https://github.com/fluxcd/flux2-kustomize-helm-example.git
    status: 'Applied revision: refs/heads/main@sha1:21486401be9bcdc37e6ebda48a3b68f8350777c9'