Files
flock/deploy/daemonset.yaml
T
Donavan Fritz eb1f5e0d8d
Build flock Image / build (push) Has been cancelled
M2: netlink, IPAM/handler wiring, BIRD sidecar, CNI installer
Code (Linux build, with no-op stubs for macOS dev):
- pkg/agent/netns_linux.go: ensureVeth → host-side configure (addrgenmode
  none, fe80::1/64, proxy_arp, forwarding) → move peer to pod ns →
  configure pod side (addr, default route via fe80::1, v4 169.254.1.1
  on-link gateway) → host /128 + /32 routes. Idempotent.
- pkg/agent/hostiface.go: deterministic host iface name flock<8hex> from
  FNV-1a-32(containerID).
- pkg/agent/annotations.go: parse flock.fritzlab.net/{ipv6,ipv4,cidr6,
  cidr4,ip-algo,anycast} with design-doc defaults; ParseCNIArgs for the
  K8S_POD_* keys kubelet sets.
- pkg/agent/podinfo.go: shared informer scoped to spec.nodeName==NODE,
  WaitForPod helper for ADD-vs-informer-sync race.
- pkg/agent/handlers.go: PodHandler does
    cache lookup → annotations → IPAM → store(pending) → SetupFunc →
    store(committed) → Result. Idempotent on retry. Del symmetric.
- pkg/routing/bird/config.go: text/template render with stable ordering;
  golden tests for host001 + anycast injection + sort stability.
- pkg/agent/bird.go: writes /etc/flock/bird/bird.conf, debounces 500ms,
  execs `birdc -s /run/flock/bird.ctl configure`. Installs blackhole
  kernel routes for the node summary CIDRs so BIRD's protocol kernel
  imports them.
- pkg/agent/runtime_linux.go: at startup, waits up to 60s for the per-
  node NodeConfig, reconciles committed allocations into IPAM.used,
  garbage-collects pending entries, builds PodHandler, swaps RPC
  handlers in.
- cmd/flock-installer: init-container binary that copies /opt/cni/bin/
  flock and writes 01-flock.conflist (lex-first so kubelet picks it
  over Calico's 10-calico.conflist on flock-labeled nodes).

Deploy:
- Dockerfile: alpine + iproute2 + bird2; multi-binary image.
- deploy/daemonset.yaml: install-cni init container; bird sidecar
  sharing /etc/flock/bird + /run/flock with the agent; ConfigMap-seeded
  bootstrap bird.conf so the sidecar boots before the agent renders.
  Privileged on flock-agent + install-cni; bird sidecar uses
  NET_ADMIN/RAW only.
- RBAC: pods + networkpolicies get/list/watch (the latter is reserved
  for M8 — harmless to grant now).

Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>
2026-04-24 22:33:48 -05:00

162 lines
4.9 KiB
YAML

apiVersion: v1
kind: ConfigMap
metadata:
name: flock-bird-init
namespace: kube-system
data:
bird.conf: |
# Bootstrap config served by the bird sidecar until flock-agent
# writes the real config. Single-protocol device + kernel keeps BIRD
# alive without trying to peer until the agent is ready.
log syslog all;
router id 127.0.0.1;
protocol device { scan time 10; }
protocol kernel kernel6 { ipv6 { import all; export all; }; }
protocol kernel kernel4 { ipv4 { import all; export all; }; }
---
apiVersion: apps/v1
kind: DaemonSet
metadata:
name: flock-agent
namespace: kube-system
labels:
app: flock-agent
spec:
selector:
matchLabels:
app: flock-agent
updateStrategy:
type: RollingUpdate
rollingUpdate:
maxUnavailable: 1
template:
metadata:
labels:
app: flock-agent
spec:
serviceAccountName: flock-agent
hostNetwork: true
dnsPolicy: ClusterFirstWithHostNet
priorityClassName: system-node-critical
nodeSelector:
flock.fritzlab.net/agent: ""
tolerations:
- key: fritzlab.net/cni-test
operator: Equal
value: "true"
effect: NoSchedule
- key: node-role.kubernetes.io/control-plane
operator: Exists
effect: NoSchedule
- key: node.kubernetes.io/not-ready
operator: Exists
effect: NoExecute
- key: node.kubernetes.io/unreachable
operator: Exists
effect: NoExecute
initContainers:
- name: install-cni
image: code.fritzlab.net/fritzlab/flock:latest
imagePullPolicy: Always
command:
- /usr/local/bin/flock-installer
- --src=/usr/local/bin/flock
- --bin=/host/opt/cni/bin/flock
- --conflist=/host/etc/cni/net.d/01-flock.conflist
securityContext:
privileged: true
volumeMounts:
- name: cni-bin
mountPath: /host/opt/cni/bin
- name: cni-conf
mountPath: /host/etc/cni/net.d
- name: seed-bird-config
image: code.fritzlab.net/fritzlab/flock:latest
imagePullPolicy: Always
command: ["/bin/sh", "-c"]
args:
- |
mkdir -p /etc/flock/bird
if [ ! -s /etc/flock/bird/bird.conf ]; then
cp /seed/bird.conf /etc/flock/bird/bird.conf
fi
volumeMounts:
- name: bird-config
mountPath: /etc/flock/bird
- name: bird-seed
mountPath: /seed
containers:
- name: flock-agent
image: code.fritzlab.net/fritzlab/flock:latest
imagePullPolicy: Always
args:
- --node=$(NODE_NAME)
- --state=/var/lib/flock/allocations.json
- --socket=/run/flock/flock.sock
env:
- name: NODE_NAME
valueFrom:
fieldRef:
fieldPath: spec.nodeName
securityContext:
privileged: true
volumeMounts:
- name: lib-flock
mountPath: /var/lib/flock
- name: run-flock
mountPath: /run/flock
- name: bird-config
mountPath: /etc/flock/bird
- name: netns
mountPath: /var/run/netns
mountPropagation: HostToContainer
resources:
requests: { cpu: 25m, memory: 32Mi }
limits: { memory: 256Mi }
- name: bird
image: code.fritzlab.net/fritzlab/flock:latest
imagePullPolicy: Always
command: ["bird", "-c", "/etc/flock/bird/bird.conf", "-s", "/run/flock/bird.ctl", "-f"]
securityContext:
capabilities:
add: ["NET_ADMIN", "NET_RAW", "NET_BIND_SERVICE"]
allowPrivilegeEscalation: false
volumeMounts:
- name: bird-config
mountPath: /etc/flock/bird
- name: run-flock
mountPath: /run/flock
resources:
requests: { cpu: 10m, memory: 16Mi }
limits: { memory: 64Mi }
volumes:
- name: lib-flock
hostPath:
path: /var/lib/flock
type: DirectoryOrCreate
- name: run-flock
hostPath:
path: /run/flock
type: DirectoryOrCreate
- name: cni-bin
hostPath:
path: /opt/cni/bin
type: DirectoryOrCreate
- name: cni-conf
hostPath:
path: /etc/cni/net.d
type: DirectoryOrCreate
- name: netns
hostPath:
path: /var/run/netns
type: DirectoryOrCreate
- name: bird-config
hostPath:
path: /var/lib/flock-bird
type: DirectoryOrCreate
- name: bird-seed
configMap:
name: flock-bird-init
imagePullSecrets:
- name: code-fritzlab-net