Initial import: phase docs, configs, Claude conventions

Phase 1-3 runbooks and design notes, version pins, config templates,
project-history conventions, cluster-inspector read-only credentials setup.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

configs/capi/clusterctl.yaml.example

@@ -0,0 +1,26 @@
+# copy to ~/.cluster-api/clusterctl.yaml — never commit the real file
+## controller
+PROXMOX_URL: "https://192.168.0.8:8006"
+PROXMOX_TOKEN: "capmox@pve!capi"
+PROXMOX_SECRET: "<secret>"
+
+## workload defaults
+PROXMOX_SOURCENODE: "pv1-1"               # node holding the template
+TEMPLATE_VMID: "<vmid of ubuntu-2404-kube-v1.35.9>"
+ALLOWED_NODES: "[pv1-1]"                  # more nodes only with shared storage
+VM_SSH_KEYS: "ssh-ed25519 AAAA..."
+
+## network (VLAN 4 on vmbr0 — add `vlan: 4` to the network device in ProxmoxMachineTemplates)
+CONTROL_PLANE_ENDPOINT_IP: "<free IP in VLAN 4>"
+NODE_IP_RANGES: "[<first>-<last>]"
+GATEWAY: "<gw>"
+IP_PREFIX: "24"
+DNS_SERVERS: "[<dns>]"
+BRIDGE: "vmbr0"
+
+## sizing defaults (workers overridden in lab1.yaml)
+BOOT_VOLUME_DEVICE: "scsi0"
+BOOT_VOLUME_SIZE: "40"
+NUM_SOCKETS: "1"
+NUM_CORES: "2"
+MEMORY_MIB: "4096"

configs/cluster-autoscaler/values.yaml

@@ -0,0 +1,17 @@
+# helm install ca autoscaler/cluster-autoscaler --version 9.59.0 -n default -f values.yaml
+# must be installed in the same namespace as the <cluster>-kubeconfig secret
+cloudProvider: clusterapi
+clusterAPIMode: kubeconfig-incluster      # workload via kubeconfig, management in-cluster
+clusterAPIKubeconfigSecret: lab1-kubeconfig
+autoDiscovery:
+  clusterName: lab1
+  namespace: default
+image:
+  tag: v1.35.2                            # chart default appVersion is 1.35.0
+extraArgs:
+  expander: least-waste
+  scale-down-unneeded-time: 5m
+  scale-down-delay-after-add: 5m
+  scale-down-utilization-threshold: "0.5"
+  balance-similar-node-groups: true
+  v: 4

configs/image-builder/proxmox-lab.json.example

@@ -0,0 +1,8 @@
+{
+  "disk_format": "raw",
+  "kubernetes_semver": "v1.35.9",
+  "kubernetes_series": "v1.35",
+  "kubernetes_deb_version": "1.35.9-1.1",
+  "iso_file": "local:iso/ubuntu-24.04.4-live-server-amd64.iso",
+  "iso_url": ""
+}

configs/test/inflate.yaml

@@ -0,0 +1,18 @@
+# apply to the workload cluster; scale replicas to trigger scale-up (≈2 pods per 4 vCPU / 8 GiB worker)
+apiVersion: apps/v1
+kind: Deployment
+metadata:
+  name: inflate
+spec:
+  replicas: 0
+  selector:
+    matchLabels: { app: inflate }
+  template:
+    metadata:
+      labels: { app: inflate }
+    spec:
+      containers:
+        - name: pause
+          image: registry.k8s.io/pause:3.10
+          resources:
+            requests: { cpu: "1500m", memory: "2Gi" }