Deployment

Deploy a K3s Cluster with Astra

Deploy a K3s cluster with Astra

Use this model when you want Astra to be its own replicated datastore tier instead of sharing a host with K3s.

Topology

  • 3 Astra nodes minimum for the control-plane datastore
  • 1 or 3 K3s server nodes depending on your HA target
  • additional worker nodes as needed

Design rules

  • keep Astra peer traffic and client traffic explicit,
  • give K3s all Astra client endpoints in --datastore-endpoint,
  • reserve memory and IO for Astra instead of treating it like a sidecar,
  • validate kubectl get crd, LIST-heavy workloads, and watch fanout before production cutover.

Example K3s server install

curl -sfL https://get.k3s.io | \
  INSTALL_K3S_EXEC="server \
    --write-kubeconfig-mode 644 \
    --disable servicelb \
    --snapshotter stargz \
    --datastore-endpoint 'http://10.0.0.11:2379,http://10.0.0.12:2379,http://10.0.0.13:2379'" \
  sh -

Validation checklist

  • all K3s servers are Ready
  • Astra quorum is healthy across all client endpoints
  • CRD discovery succeeds without chunk-size workarounds
  • ingress and storage smoke tests succeed
  • restart behavior is predictable after host or node reboots