Skip to main content

Kubernetes DaemonSet

Use this playbook to deploy Breeze as a DaemonSet so every Kubernetes node runs the agent.

Prerequisites

  • A Kubernetes cluster (EKS, AKS, GKE, or self-hosted) with:
    • Linux worker nodes supported by Breeze.
    • Outbound access from nodes to Breeze endpoints.
  • Access to a container registry for Breeze images.

Build and Push Images

  1. In Cloudaware, go to Admin.
  2. Find Breeze in DevOps Integrations. Click CONFIGURED.
  3. Download the installer.
  4. Clone the Breeze tools repo (or obtain your organization’s equivalent Kubernetes helper files).
  5. In the Kubernetes/DaemonSet folder:
    • Copy the Breeze archive into the folder and extract it so the breeze-agent directory is present.
    • Build Breeze images (for example, init + agent, or a single DaemonSet image) and tag them for your registry.
  6. Push the images to your container registry.

Apply DaemonSet + RBAC

  1. Update the DaemonSet manifest to reference:
    • Your registry image URLs.
    • Image pull secrets (if required).
    • Target namespace and labels.
  2. Apply the manifest:
    • kubectl apply -f ds-breeze-agent.yaml (or equivalent).
  3. Ensure RBAC is scoped so Breeze pods can access node‑level resources they need, but not cluster‑wide admin privileges.

Validate Health

  • Check DaemonSet status:
    • kubectl get ds -n <namespace> and confirm DESIRED = CURRENT = READY.
  • Inspect pod logs:
    • kubectl logs -n <namespace> <breeze-pod> to confirm successful runs and no recurring errors.
  • In Cloudaware:
    • Verify that Kubernetes nodes report Breeze facts and that any TunHub‑backed integrations see the cluster if applicable.

Roll Updates

  • Build and tag new Breeze images when upgrading the agent or configuration.
  • Update the DaemonSet manifest (or image tag) and apply the change.
  • Use a rolling update strategy (default for DaemonSets) to replace pods while maintaining coverage.