You are viewing documentation for Cozystack v1.2. For the latest version, see the v1.4 documentation.

Устранение неполадок при установке Kubernetes

Инструкции по решению типовых проблем, которые могут возникнуть при установке Kubernetes с помощью talm, talos-bootstrap или talosctl.

На этой странице приведены инструкции по решению типовых проблем, которые могут возникнуть при установке Kubernetes с помощью talm, talos-bootstrap или talosctl.

No Talos nodes in maintenance mode found!

Если скрипт talos-bootstrap не обнаруживает узлы, выполните следующие шаги для диагностики и устранения проблемы:

  1. Проверьте сетевой сегмент

    Убедитесь, что скрипт запускается в том же сетевом сегменте, что и узлы. Это критически важно, чтобы скрипт мог взаимодействовать с узлами.

  2. Используйте Nmap для обнаружения узлов

    Проверьте, может ли nmap обнаружить узел, выполнив следующую команду:

    nmap -Pn -n -p 50000 192.168.0.0/24
    

    Эта команда сканирует сеть на наличие узлов, которые слушают порт 50000. В выводе должны быть перечислены все узлы в сетевом сегменте, слушающие этот порт; это означает, что они доступны.

  3. Проверьте подключение talosctl

    Затем убедитесь, что talosctl может подключиться к конкретному узлу, особенно если узел находится в maintenance mode:

    talosctl -e "${node}" -n "${node}" get machinestatus -i
    

    Ошибка вида ниже обычно означает, что локальный бинарный файл talosctl устарел:

    rpc error: code = Unimplemented desc = unknown service resource.ResourceService
    

    Обновление talosctl до последней версии должно решить проблему.

  4. Запустите talos-bootstrap в debug mode

    Если предыдущие шаги не помогли, запустите talos-bootstrap в debug mode, чтобы получить больше диагностической информации.

    Выполните скрипт с опцией -x, чтобы включить debug mode:

    bash -x talos-bootstrap
    

    Обратите внимание на последнюю команду, показанную перед ошибкой; часто она указывает на команду, которая завершилась неудачно, и помогает в дальнейшей диагностике.

Исправление ext-lldpd на узлах Talos

Ожидание runtime service в Talos может привести к тому, что узел останется в состоянии booting в консоли Talos. Если вы хотите использовать lldpd, можно применить patch к узлам. Продолжайте, если у вас есть подключение через talosctl.

cat > lldpd.patch.yaml <<EOF
apiVersion: v1alpha1
kind: ExtensionServiceConfig
name: lldpd
configFiles:
  - content: |
      configure lldp status disabled
    mountPath: /usr/local/etc/lldp/lldpd.conf
EOF

Чтобы применить patch к конкретному узлу, выполните:

talosctl patch mc -p @lldpd.patch.yaml -n <node> -e <node>

Проверьте, на каких узлах установлен lldpd:

node_net='192.168.100.0/24'
nmap -Pn -n -T4 -p50000 --open -oG - $node_net  | awk '/50000\/open/ { system("talosctl get extensions -n "$2" -e "$2" | grep lldpd") }'

Если хотите применить patch ко всем узлам:

nmap -Pn -n -T4 -p50000 --open -oG - $node_net  | awk '/50000\/open/ {print "talosctl patch mc -p @lldpd.patch.yaml -n "$2" -e "$2" "}'

Проверьте состояние в консоли Talos:

talosctl dashboard -n $(nmap -Pn -n -T4 -p50000 --open -oG - $node_net | awk '/50000\/open/ {print $2}' | paste -sd,)
Last modified 2026-04-22: DOCS: update gs and install (8b18a96)