Purpose: For platform engineers, lists every variable and inventory group used by the collection with types, defaults, and which role consumes them.
Required inventory groups
| Group | Used by | Purpose |
|---|---|---|
| windows_workers | Both roles | Target hosts for Windows worker node setup. |
| oc_controlplane_nodes | win-kubeadm | Delegates to groups['oc_controlplane_nodes'][0] for join token generation and kube-dns Service creation. |
Connection variables
Set these on the windows_workers group:
| Variable | Recommended value | Description |
|---|---|---|
| ansible_connection | ssh | Connection plugin. ssh or winrm. |
| ansible_shell_type | powershell | Required for SSH connections to Windows. |
| ansible_user | Administrator | Must have local admin privileges. |
Role variables
Required (no defaults)
| Variable | Type | Consumed by | Description |
|---|---|---|---|
| containerd_version | string | win-containerd | ContainerD version (e.g., 1.7.13). |
| crictl_version | string | win-containerd | crictl version (e.g., 1.29.0). |
| kube_version | string | win-kubeadm | Kubernetes version (e.g., 1.29.0). The v prefix is added automatically if missing. |
| k8s_internal_ip | string | win-kubeadm | Control plane IP or load balancer VIP. Written to the hosts file. |
Optional (have defaults)
| Variable | Default | Consumed by | Description |
|---|---|---|---|
| skip_hypervisor_support_check | false | win-containerd | Skip standard Hyper-V features; use DISM instead. |
| cni_bin_path | c:/opt/cni/bin | win-containerd | CNI binary directory in ContainerD config. |
| cni_config_path | c:/etc/cni/net.d | win-containerd | CNI config directory in ContainerD config. |
| containerd_path | {{ ansible_env.ProgramFiles }}\containerd | win-containerd | ContainerD installation directory. |
| hostname_override | {{ ansible_hostname }} | win-kubeadm | Kubelet --hostname-override value. |
| kubernetes_path | C:\k | win-kubeadm | Directory for kubelet, kubeadm, StartKubelet.ps1. |
| kubelet_log_path | C:\var\log\kubelet | win-kubeadm | Kubelet log directory (managed by NSSM). |
| nssm_install_directory | C:\Program Files\nssm | win-kubeadm | NSSM installation directory. |
Ansible facts used
| Fact | Used by | Purpose |
|---|---|---|
| ansible_env.ProgramFiles | win-containerd | Resolves default containerd_path. |
| ansible_env.USERPROFILE | win-containerd | Location for ~/.crictl/crictl.yaml. |
| ansible_hostname | win-kubeadm | Default hostname_override. |
| ansible_host | win-kubeadm | Passed to kubelet --node-ip. |
| ansible_architecture | win-kubeadm | Determines NSSM binary architecture (win64 or win32). |