Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Настраивая конфигурацию узла, можно настроить параметры операционной системы (ОС) или параметры kubelet в соответствии с потребностями рабочих нагрузок. При создании кластера AKS или добавлении пула узлов в кластер можно настроить подмножество часто используемых параметров ОС и kubelet. Чтобы настроить параметры за пределами этого подмножества, используйте DaemonSet, чтобы внести необходимые настройки, не теряя поддержку AKS для своих узлов.
Prerequisites
По мере того как в службе добавляется поддержка новых настроек и параметров kubelet, может потребоваться регистрация флага предварительной функции. Если требуется флаг предварительной версии, ссылка на параметры конфигурации пользовательского узла вызывает ее.
Параметры kubelet kubeReserved, hardEvictionThreshold, softEvictionGracePeriod, softEvictionThreshold и evictionMaxPodGracePeriodInSeconds находятся в предварительной версии и требуют флага функции CustomNodeConfigPreview. Эти параметры позволяют настраивать резервирование ресурсов и пороговые значения вытеснения, которые также настраиваются с помощью AKS Node Hardening. Инструкции по регистрации, значения по умолчанию и примеры см. в разделе "Усиление защиты узлов" (предварительная версия) в AKS.
Создание пользовательских файлов конфигурации узлов для пулов узлов AKS
Чтобы изменить конфигурацию операционной системы и kubelet, создайте новый файл конфигурации с нужными вам параметрами и настройками. Если значение параметра не указано, используется значение по умолчанию.
Примечание.
В следующих примерах показаны распространенные параметры конфигурации. Измените параметры в соответствии с требованиями рабочей нагрузки. Полный список поддерживаемых пользовательских параметров конфигурации см. в разделе "Параметры конфигурации пользовательского узла" для AKS.
Конфигурация Kubelet
Создайте файл linuxkubeletconfig.json со следующим содержимым.
{
"cpuManagerPolicy": "static",
"cpuCfsQuota": true,
"cpuCfsQuotaPeriod": "200ms",
"imageGcHighThreshold": 90,
"imageGcLowThreshold": 70,
"topologyManagerPolicy": "best-effort",
"allowedUnsafeSysctls": [
"kernel.msg*",
"net.*"
],
"failSwapOn": false
}
Сведения о настройке зарезервированных ресурсов kube и пороговых значений вытеснения в пулах узлов Linux см. в разделе «Настройка параметров защиты узлов».
Конфигурация ОС
Создайте файл linuxosconfig.json со следующим содержимым.
{
"transparentHugePageEnabled": "madvise",
"transparentHugePageDefrag": "defer+madvise",
"swapFileSizeMB": 1500,
"sysctls": {
"netCoreSomaxconn": 163849,
"netIpv4TcpTwReuse": true,
"netIpv4IpLocalPortRange": "32000 60000"
}
}
Создание кластера AKS с помощью пользовательских файлов конфигурации
Примечание.
При создании нового кластера AKS следует учитывать следующие сведения при использовании пользовательских файлов конфигурации:
- Если при создании кластера указать конфигурацию, конфигурация применяется только к узлам в начальном пуле узлов. Кластер сохраняет значения по умолчанию для любых параметров, не настроенных в JSON-файле.
-
CustomLinuxOsConfigне поддерживается для типа ОС Windows. - Параметры kubelet для предварительного просмотра
kubeReservedи порога вытеснения поддерживаются только для пулов узлов Linux и требуют включения флага функцииCustomNodeConfigPreview. Инструкции по регистрации см. в разделе "Укрепление узлов" (предварительная версия) в AKS.
Создайте новый кластер с помощью пользовательских файлов конфигурации, выполнив az aks create команду и указав файлы конфигурации для --kubelet-config параметров и --linux-os-config параметров. В следующем примере команды создается новый кластер с пользовательскими ./linuxkubeletconfig.json и ./linuxosconfig.json файлами:
az aks create --name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json --linux-os-config ./linuxosconfig.json
Добавление пула узлов с помощью пользовательских файлов конфигурации
Примечание.
При использовании пользовательских файлов конфигурации следует учитывать следующие сведения, чтобы добавить новый пул узлов в существующий кластер AKS:
- При добавлении пула узлов Linux в существующий кластер можно указать конфигурацию kubelet, конфигурацию ОС или оба. При добавлении пула узлов Windows в существующий кластер можно указать только конфигурацию kubelet. Если при добавлении пула узлов указать конфигурацию, конфигурация применяется только к узлам в новом пуле узлов. Пул узлов сохраняет значения по умолчанию для любых параметров, не настроенных в JSON-файле.
-
CustomKubeletConfigподдерживается для пулов узлов Linux и Windows. - Параметры kubelet preview
kubeReservedи порога вытеснения поддерживаются только для пулов узлов Linux и требуют флага функцииCustomNodeConfigPreview. Инструкции по регистрации см. в разделе "Укрепление узлов" (предварительная версия) в AKS.
Создайте новый пул узлов Linux с помощью команды az aks nodepool add и укажите файлы конфигурации в параметрах --kubelet-config и --linux-os-config. Следующая команда создает новый пул Linux-узлов с кастомизированным файлом ./linuxkubeletconfig.json.
az aks nodepool add --name <node-pool-name> --cluster-name <cluster-name> --resource-group <resource-group-name> --kubelet-config ./linuxkubeletconfig.json
Были применены параметры подтверждения
После применения настраиваемой конфигурации узла можно подтвердить применение параметров к узлам, подключившись к узлу и убедившись sysctl , что изменения конфигурации были внесены в файловую систему.
Просмотр поддерживаемых пользовательских параметров конфигурации
Полный список поддерживаемых параметров конфигурации kubelet и ОС Linux, допустимых значений, значений по умолчанию и описаниям см. в параметрах конфигурации пользовательского узла для AKS.
Рекомендации по настройке пользовательских узлов
При настройке конфигурации узла следует учитывать следующие рекомендации.
- Обновления образа узла повторно применяют пользовательские конфигурации узла.
- Операции горизонтального масштабирования сохраняют пользовательские конфигурации узлов.
- AKS не выполняет предварительную валидацию каждого параметра или значения настраиваемой конфигурации узла. Убедитесь, что указанные параметры и значения конфигурации пользовательского узла поддерживаются и допустимы, чтобы избежать потенциальных проблем с узлами кластера.
- Параметры kubelet предварительного просмотра
kubeReservedи порога вытеснения доступны только в пулах узлов Linux. При настройке используйте поддерживаемые диапазоны, единицы и правила связывания в справочнике по параметрам конфигурации пользовательского узла. - Значения по умолчанию для параметров конфигурации пользовательских узлов часто изменяются с новыми версиями операционной системы. При применении пользовательских конфигураций узлов просмотрите значения по умолчанию для параметров, которые вы настраиваете, чтобы убедиться, что пользовательские параметры подходят для версии ОС узлов кластера.
- Ограничение числа пользователей, имеющих разрешения на изменение конфигурации пользовательского узла, чтобы предотвратить непредвиденные последствия для стабильности кластера и производительности. Рекомендуется использовать авторизацию идентификатора Microsoft Entra для API Kubernetes , чтобы ограничить доступ к параметрам конфигурации кластера.
- Отделяйте пулы узлов с настраиваемыми конфигурациями от тех, кто не настраивает конфигурации, чтобы предотвратить непредвиденные последствия для рабочих нагрузок, которые могут быть чувствительны к определенным изменениям конфигурации. Например, если у вас есть критическая рабочая нагрузка, требующая определенных параметров kubelet, рассмотрите возможность изоляции рабочей нагрузки в выделенном пуле узлов с необходимой настраиваемой конфигурацией kubelet.
Связанный контент
- Узнайте, как настроить кластер AKS.
- Узнайте, как обновить образы узлов в кластере.
- Сведения о том, как обновить кластер до последней версии Kubernetes, см. в статье Обновление кластера Службы Azure Kubernetes (AKS).
- Посмотрите список часто задаваемых вопросов об AKS, чтобы найти ответы на некоторые распространенные вопросы об AKS.