Single Host Kubernetes

The local provider provisions a KubeAid-managed K3D cluster on your local machine for development and testing.

[!CAUTION] The local provider does not support cluster upgrades or disaster recovery. Use for testing only.

Features

• Cilium CNI in kube-proxyless mode
• GitOps with ArgoCD and Sealed Secrets
• Monitoring with KubePrometheus
• Runs entirely in Docker containers

Prerequisites

• Fork the KubeAid Config repository
• GitHub PAT with write access
• Docker running locally

Install KubeAid CLI

KUBEAID_CLI_VERSION=$(curl -s "https://api.github.com/repos/Obmondo/kubeaid-cli/releases/latest" | jq -r .tag_name)
OS=$([ "$(uname -s)" = "Linux" ] && echo "linux" || echo "darwin")
CPU_ARCHITECTURE=$([ "$(uname -m)" = "x86_64" ] && echo "amd64" || echo "arm64")

wget "https://github.com/Obmondo/kubeaid-cli/releases/download/${KUBEAID_CLI_VERSION}/kubeaid-cli-${KUBEAID_CLI_VERSION}-${OS}-${CPU_ARCHITECTURE}"
sudo mv kubeaid-cli-${KUBEAID_CLI_VERSION}-${OS}-${CPU_ARCHITECTURE} /usr/local/bin/kubeaid-cli
sudo chmod +x /usr/local/bin/kubeaid-cli

Setup

# Generate configuration
kubeaid-cli config generate local

# Edit outputs/configs/general.yaml and secrets.yaml

# Bootstrap the cluster
kubeaid-cli cluster bootstrap

# Access the cluster
export KUBECONFIG=./outputs/kubeconfigs/main.yaml
kubectl cluster-info

Logs are saved in outputs/.log. Access the ArgoCD and Grafana dashboards.

Cleanup

kubeaid-cli cluster delete management

See Also

• Cloud Providers - API-managed cloud infrastructure with HA
• Bare Metal - On-premises multi-node clusters
• Hybrid Setup - Cilium Cluster Mesh for multi-cloud