From 121d1ddf97e7ff04b8859e7754a4bac06a1226e7 Mon Sep 17 00:00:00 2001 From: Antoine Cotten Date: Sun, 16 Aug 2026 11:01:40 +0200 Subject: [PATCH] nixos/kubernetes: disambiguate kubelet cluster DNS options --- .../services/cluster/kubernetes/kubelet.nix | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/nixos/modules/services/cluster/kubernetes/kubelet.nix b/nixos/modules/services/cluster/kubernetes/kubelet.nix index 9290ba8e7237..b54cde9aa08a 100644 --- a/nixos/modules/services/cluster/kubernetes/kubelet.nix +++ b/nixos/modules/services/cluster/kubernetes/kubelet.nix @@ -129,13 +129,24 @@ in }; clusterDns = mkOption { - description = "Use alternative DNS."; + description = '' + List of DNS resolvers (IP addresses) used inside containers. + + Defaulted to {option}`services.kubernetes.addons.dns.clusterIp` + when {option}`services.kubernetes.addons.dns.enable` is `true`. + + Refer to the list of configuration attributes for [KubeletConfiguration](https://kubernetes.io/docs/reference/config-api/kubelet-config.v1beta1/#kubelet-config-k8s-io-v1beta1-KubeletConfiguration). + ''; default = [ "10.1.0.1" ]; type = listOf str; }; clusterDomain = mkOption { - description = "Use alternative domain."; + description = '' + Search DNS domain used inside containers. + + Refer to the list of configuration attributes for [KubeletConfiguration](https://kubernetes.io/docs/reference/config-api/kubelet-config.v1beta1/#kubelet-config-k8s-io-v1beta1-KubeletConfiguration). + ''; default = config.services.kubernetes.addons.dns.clusterDomain; defaultText = literalExpression "config.${options.services.kubernetes.addons.dns.clusterDomain}"; type = str;