kubernetes

name	kubernetes
description	Run local Kubernetes clusters with kind on Bluefin DX for cloud-native development.
domain	cloud-native

Kubernetes (kind) on Bluefin

Bluefin DX ships with kind (Kubernetes IN Docker), kubectl, and helm pre-installed via Homebrew. Use kind to spin up local clusters for development and testing.

Load with: point your agent at this file.

When to Use

• Creating a local Kubernetes cluster for development or testing
• Deploying and testing Helm charts locally
• CI/CD pipeline development that targets Kubernetes
• Learning Kubernetes without a cloud account

When NOT to Use

• Production workloads — use a managed cloud Kubernetes service
• Running kind inside a Distrobox — run it on the host for full socket access

Key Commands

# Create a cluster
kind create cluster --name dev

# List clusters
kind get clusters

# Load a local image into a kind cluster (avoids registry push)
kind load docker-image myimage:latest --name dev

# Delete a cluster
kind delete cluster --name dev

# Get kubeconfig for a cluster
kind get kubeconfig --name dev > ~/.kube/config

# Use a specific Kubernetes version
kind create cluster --image kindest/node:v1.31.0

Multi-Node Cluster

Create a kind-config.yaml:

kind: Cluster
apiVersion: kind.x-k8s.io/v1alpha4
nodes:
  - role: control-plane
  - role: worker
  - role: worker

kind create cluster --config kind-config.yaml --name multinode

Common Kubectl Commands

kubectl get pods -A              # all pods, all namespaces
kubectl get nodes                # node status
kubectl describe pod <name>      # detailed pod info
kubectl logs <pod> -f            # follow logs
kubectl apply -f manifest.yaml   # apply a manifest
kubectl delete -f manifest.yaml  # delete resources

Ingress (nginx)

# Install nginx ingress controller for kind
kubectl apply -f https://raw.githubusercontent.com/kubernetes/ingress-nginx/main/deploy/static/provider/kind/deploy.yaml

Tips

• Bluefin uses Podman — set KIND_EXPERIMENTAL_PROVIDER=podman if kind doesn't auto-detect
• Use ujust recipes if available for project-specific cluster setup
• k9s (if installed) provides a great TUI for cluster management: k9s