I. Предварительные условия
Прежде чем приступить к настройке Kubernetes-кластера с помощью Kubespray, убедитесь, что выполнены следующие предварительные условия:
1. Аппаратные требования
Минимально рекомендуемые аппаратные характеристики каждого узла (мастера и рабочего):
- CPU: минимум 2 ядра
- RAM: минимум 2 ГБ
- Диск: минимум 20 ГБ свободного пространства
- Интернет-подключение (для загрузки образов контейнеров и необходимых файлов)
2. Программные требования
Каждый узел должен иметь установленные следующие компоненты:
- OS: Рекомендуемые дистрибутивы — Ubuntu 20.04 LTS или CentOS/RHEL 8
- Python: версия >= 3.6
- Ansible: последняя доступная версия (>= 2.10)
- Docker или другой контейнерный движок (Containerd или Cri-O)
- SSH-сервер для дистанционного администрирования
- Открытие портов для внутреннего трафика Kubernetes (TCP/UDP)
3. Инфраструктура
Приготовьте несколько серверов (физические или виртуальные машины) для ролей мастеров и рабочих узлов. Для минимального рабочего сценария нужен хотя бы один мастер и два рабочих узла.
Пример распределения ролей:
- Мастер узлы: отвечают за управление кластером (API-сервер, контроллер, scheduler и др.)
- Рабочие узлы: запускают pod'ы и обеспечивают выполнение задач
4. Инвентарный файл
Инвентарный файл Ansible (`inventory.ini`) необходим для описания структуры вашего кластера. Вы можете воспользоваться примером файла, предоставляемым Kubespray проектом, или самостоятельно составить его, исходя из своей инфраструктуры.
II. Шаги по развертыванию
1. Скачайте Kubespray
Используйте следующий код для скачивания последней версии Kubespray:
git clone https://github.com/kubernetes-sigs/kubespray.git
cd kubespray
2. Создайте инвентарный файл
Ваш инвентарный файл (`inventory.ini`) должен содержать следующую структуру:
[kube-master]
master.example.com
[kube-node]
node1.example.com
node2.example.com
[etcd]
master.example.com
[k8s-cluster:children]
kube-master
kube-node
Замените домены (`example.com`) на реальные имена или IP-адреса ваших серверов.
3. Настроечные файлы
Переменные групп и хосты хранятся в файлах `group_vars/*`. Вам понадобится изменить следующие важные параметры:
- Версия Kubernetes (`version`)
- Используемый сетевой провайдер (`kube_network_plugin`)
- Доменное имя кластера (`dns_domain`)
- Авторизация Kubernetes (`auth_method`)
Файл `group_vars/all.yml` должен выглядеть примерно так:
---
kube_version: 'v1.30'
kubeconfig_path: "/home/${USER}/admin.conf"
kube_network_plugin: calico
pod_subnet: "192.168.0.0/16"
service_subnet: "10.96.0.0/12"
cluster_cidr: "192.168.0.0/16"
kubeadm_token: "<your-token>"
auth_method: x509
dns_domain: "cluster.local"
Генерация токена (`kubeadm_token`) выполняется следующей командой:
openssl rand -hex 16
4. Проверьте подключение
Выполните проверку доступности всех серверов перед запуском плейбуков:
ansible all -i inventory.ini -m ping
Команда вернет результат проверки связи с каждым сервером.
5. Начните развертывание
Запустите основной плейбук для развертывания Kubernetes:
ansible-playbook -i inventory.ini cluster.yml
Этот процесс займет некоторое время (обычно десятки минут), в течение которого будут установлены и сконфигурированы все сервисы Kubernetes.
6. Тестирование и проверка статуса
Проверьте состояние ваших узлов и служб Kubernetes:
kubectl get nodes
kubectl get pods --all-namespaces
Все ваши рабочие узлы должны отображаться как "Ready", а сервисные pod'ы — запущенными ("Running").
7. Завершение установки
Поздравляем! Ваш новый Kubernetes-кластер теперь работает. Используйте полученный ранее путь к admin.conf для дальнейших операций с Kubernetes.