BeKind

Installs a K8S cluster using KIND, and does a number of post deployment steps.

Bekind will:

• Install a KIND cluster based on the supplied config
• KIND cluster can be modified to deploy a specific K8S version
• Installs any Supplied Helm Charts
• Loads images into the KIND cluster

Installation

Prerequisites:

• go version 1.20 or newer
• Docker (Podman is still considered experemental by KIND)

Install with:

go install github.com/christianh814/bekind@latest

Then move into your $PATH (example showing /usr/local/bin)

sudo mv $GOBIN/bekind /usr/local/bin/bekind
sudo chmod +x /usr/local/bin/bekind

Config

You can customize the setup by providing a Specific Config (under ~/.bekind/config.yaml or by providing --config to a YAML file)

For example:

• domain: Domain to use for any ingresses this tool will autocreate, assuming wildcard DNS (currently unused/ignored)
• kindImageVersion: The KIND Node image to use (You can find a list on dockerhub). You can also supply your own public image or a local image.
• kindConfig: A custom kind config. It's "garbage in/garbage out".
• helmCharts: Different Helm Charts to install on startup. "garbage in/garbage out". See Helm Chart Config for more info.
• loadDockerImages: List of images to load onto the nodes. See the Loading Docker Images section below for more info.
• postInstallManifests: List of YAML files to apply to the KIND cluster after setup. This is the last step to run in the process. There is no checks done and any errors are from the K8S API. Currently only YAML files are supported. It's "garbage in/garbage out".

domain: "7f000001.nip.io"
kindImageVersion: "kindest/node:v1.34.0"
helmCharts:
  - url: "https://kubernetes.github.io/ingress-nginx"
    repo: "ingress-nginx"
    chart: "ingress-nginx"
    release: "nginx-ingress"
    namespace: "ingress-controller"
    wait: true
    valuesObject:
      controller:
        extraArgs:
          enable-ssl-passthrough: ""
        hostNetwork: true
        ingressClassResource:
          default: true
        nodeSelector:
          nginx: ingresshost
        service:
          externalTrafficPolicy: ""
          type: ClusterIP
        tolerations:
        - operator: Exists
  - url: "https://argoproj.github.io/argo-helm"
    repo: "argo"
    chart: "argo-cd"
    release: "argocd"
    namespace: "argocd"
    wait: true
    valuesObject:
      configs:
        secret:
          argocdServerAdminPassword: $2a$10$pKM9yRpR2G5X8c3.M.lgs.v5xBBzEyiJnH5vrWYGkO3JNr5HTW8yq
        cm:
          kustomize.buildOptions: "--enable-helm"
          resource.customizations.health.argoproj.io_Application: |
            hs = {}
            hs.status = "Progressing"
            hs.message = ""
            if obj.status ~= nil then
              if obj.status.health ~= nil then
                hs.status = obj.status.health.status
                if obj.status.health.message ~= nil then
                  hs.message = obj.status.health.message
                end
              end
            end
            return hs
          resource.customizations.health.networking.k8s.io_Ingress: |
            hs = {}
            hs.status = "Healthy"
            hs.message = "Probably just fine"
            return hs
      global:
        domain: argocd.7f000001.nip.io
      server:
        ingress:
          annotations:
            '"nginx.ingress.kubernetes.io/force-ssl-redirect"': true
            '"nginx.ingress.kubernetes.io/ssl-passthrough"': true
          enabled: true
          hostname: argocd.7f000001.nip.io
          ingressClassName: nginx
          tls: true
kindConfig: |
  kind: Cluster
  name: argocd-ingress
  apiVersion: kind.x-k8s.io/v1alpha4
  networking:
    podSubnet: "10.254.0.0/16"
    serviceSubnet: "172.30.0.0/16"
  nodes:
  - role: control-plane
    kubeadmConfigPatches:
    - |
      kind: InitConfiguration
      nodeRegistration:
        kubeletExtraArgs:
          node-labels: "nginx=ingresshost"
    extraPortMappings:
    - containerPort: 80
      hostPort: 80
      listenAddress: 0.0.0.0
    - containerPort: 443
      hostPort: 443
      listenAddress: 0.0.0.0
loadDockerImages:
  pullImages: true
  images:
    - gcr.io/kuar-demo/kuard-amd64:blue
    - quay.io/christianh814/simple-go:latest
    - quay.io/ablock/gitops-helm-quarkus:latest
    - christianh814/gobg:latest
postInstallManifests:
  - "file:///home/chernand/workspace/argocd/bunch-o-apps/helm-app-example.yaml"
  - "file:///home/chernand/workspace/argocd/bunch-o-apps/gobg.yaml"
  - "file:///home/chernand/workspace/argocd/bunch-o-apps/simple-go.yaml"

Helm Chart Config

The following are valid configurations for the helmCharts section:

• url: The URL of the Helm repo (REQUIRED). Can be OCI repo with oci://
• repo: What to name the repo, interally (REQUIRED). It's the <reponame> from helm repo add <reponame> <url>. (ignored when using OCI)
• chart: What chart to install from the Helm repo (REQUIRED). (Ignored when using OCI)
• release: What to call the release when it's installed (REQUIRED).
• namespace: The namespace to install the release to, it'll create the namespace if it's not already there (REQUIRED).
• version: The version of the Helm chart to install (Optional)
• wait: Wait for the release to be installed before returning (Optional); default is false.
• valuesObject: A YAML object to use as the values file (Optional).

Loading Docker Images

The following are valid configurations for the loadDockerImages section:

🚨 NOTE Only docker is supported see KIND upstream issue

• pullImages: To perform a pull of the image before lodaing (opional and defaults to true if not supplied). This is a "global" setting (you're either pulling them all or none)
• images: List of images to do the pull.