Установка и настройка кластера Kubernetes on Cozystack

Использование Talm для инициализации кластера Cozystack

Mon, 01 Jan 0001 00:00:00 +0000

В этом руководстве описано, как установить и настроить Kubernetes в кластере Talos Linux с помощью Talm. После выполнения этого руководства у вас будет кластер Kubernetes, готовый к установке Cozystack.

Talm — Helm-подобная утилита для декларативного управления конфигурацией Talos Linux. Talm был создан Ænix, чтобы сделать конфигурации управления кластером более декларативными и настраиваемыми. Talm поставляется с готовыми пресетами для Cozystack.

Предварительные требования

К началу работы с этим руководством Talos Linux должен быть установлен на нескольких узлах, но еще не инициализирован (bootstrapped). Эти узлы должны находиться в одной подсети или иметь публичные IP-адреса.

Использование скрипта talos-bootstrap для инициализации кластера Cozystack

Mon, 01 Jan 0001 00:00:00 +0000

talos-bootstrap — интерактивный скрипт для инициализации кластеров Kubernetes на Talos OS.

Он был создан разработчиками Cozystack, чтобы упростить установку Talos Linux на bare-metal узлы и сделать ее удобнее.

1. Установка зависимостей

Установите следующие зависимости:

talosctl
dialog
nmap

Скачайте последнюю версию talos-bootstrap со страницы релизов или напрямую из trunk:

curl -fsSL -o /usr/local/bin/talos-bootstrap \
 https://github.com/cozystack/talos-bootstrap/raw/master/talos-bootstrap
chmod +x /usr/local/bin/talos-bootstrap
talos-bootstrap --help

2. Подготовка конфигурационных файлов

Начните с создания каталога конфигурации для нового кластера:
```
mkdir -p cluster1
cd cluster1
```
Создайте файл конфигурационного patch patch.yaml с общими настройками узлов, используя следующий пример:

Использование talosctl для инициализации кластера Cozystack

Mon, 01 Jan 0001 00:00:00 +0000

В этом руководстве описано, как подготовить кластер Talos Linux к развертыванию Cozystack с помощью talosctl — специализированного CLI-инструмента для управления Talos.

Предварительные требования

К началу работы с этим руководством Talos OS должна быть загружена с ISO на нескольких узлах, но еще не инициализирована (bootstrapped). Эти узлы должны находиться в одной подсети или иметь публичные IP-адреса.

В руководстве используется пример, где узлы кластера находятся в подсети 192.168.123.0/24 и имеют следующие IP-адреса:

Инициализация кластера в изолированной среде

Mon, 01 Jan 0001 00:00:00 +0000

Введение

В этом руководстве описаны шаги для инициализации кластера Cozystack в изолированной среде.

Установка в air-gapped среде означает, что кластер не имеет прямого доступа к Интернету. Все необходимые ресурсы, такие как образы и metadata, должны быть доступны в частной сети.

Настройка узлов Talos

Для установки с Talm достаточно один раз внести все указанные изменения в ./templates/_helpers.tpl, а затем собрать фактические конфигурационные файлы узлов с помощью talm template.

Для установки с talosctl изменения нужно внести в patch.yaml и patch-controlplane.yaml.

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

Mon, 01 Jan 0001 00:00:00 +0000

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

No Talos nodes in maintenance mode found!

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

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

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

Развертывание Cozystack на Generic Kubernetes

Mon, 01 Jan 0001 00:00:00 +0000

В этом руководстве описано, как развернуть Cozystack на generic-дистрибутивах Kubernetes, таких как k3s, kubeadm или RKE2. Хотя Talos Linux остается рекомендуемой платформой для production-развертываний, Cozystack поддерживает развертывание на других дистрибутивах Kubernetes с помощью bundle isp-full-generic.

Когда использовать Generic Kubernetes

Рассмотрите использование generic Kubernetes вместо Talos Linux, если:

У вас уже есть кластер Kubernetes, который вы хотите дополнить Cozystack
Ваша инфраструктура не поддерживает Talos Linux (некоторые облачные провайдеры, embedded-системы)
Вам нужны специфические функции или пакеты Linux, недоступные в Talos

Для новых production-развертываний рекомендуется Talos Linux благодаря его преимуществам в безопасности и эксплуатации.

Ubuntu Secure Boot: DRBD prerequisites

Mon, 01 Jan 0001 00:00:00 +0000

This page covers a single prerequisite for installing Cozystack on Ubuntu hosts where UEFI Secure Boot is enabled. If your nodes are Talos Linux, or Ubuntu with Secure Boot disabled, you can skip this page — the default piraeus-operator flow handles those cases.

Why this is needed

Cozystack uses LINSTOR for replicated block storage, which depends on the DRBD 9.x kernel module. The piraeus-operator that ships with Cozystack defaults to compiling DRBD from source on each node at runtime and loading the module via insmod.