Как установить KubeSphere на Ubuntu

KubeSphere — это платформа управления контейнерами с открытым исходным кодом, которая упрощает развертывание и управление контейнерными приложениями. Построенная на базе Kubernetes, она предоставляет удобный интерфейс и богатый набор функций для разработчиков и команд DevOps. Это руководство проведет вас через пошаговый процесс установки KubeSphere на Ubuntu 24.04 LTS, обеспечивая надежную среду для оркестровки контейнеров.

Системные требования

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

• Процессор: 2 ядра или более
• Оперативная память: Не менее 4 ГБ (рекомендуется 8 ГБ)
• Дисковое пространство: Минимум 20 ГБ свободного места

Требования к программному обеспечению

На вашем компьютере должна быть установлена Ubuntu 24.04 LTS. Кроме того, убедитесь, что у вас есть следующие пакеты программного обеспечения:

• Docker: контейнерная среда выполнения, необходимая для KubeSphere.
• KubeKey: Инструмент для развертывания кластеров Kubernetes.

Права пользователя

Для установки пакетов программного обеспечения и настройки параметров системы у вас должен быть доступ sudo. Если вы вошли в систему не как пользователь root, убедитесь, что ваша учетная запись обладает правами администратора.

Обновление и модернизация системы

Первым шагом в подготовке системы Ubuntu является обновление индекса пакетов и обновление всех установленных пакетов. Откройте терминал и выполните следующие команды:

sudo apt update && sudo apt upgrade -y

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

Установите Docker

Для эффективного управления контейнерами KubeSphere требуется Docker. Чтобы установить Docker, выполните следующую команду:

sudo apt install -y docker.io

После установки включите запуск Docker при загрузке с помощью этой команды:

sudo systemctl enable docker

Вы можете проверить установку Docker, проверив его версию:

docker --version

Установите необходимые пакеты

Вам также может понадобиться установить дополнительные пакеты для управления кластерами Kubernetes. Установите их, используя:

sudo apt install -y curl wget jq vim net-tools

Установка KubeKey

Скачать KubeKey

KubeKey — это легкий инструмент, предназначенный для упрощения установки Kubernetes. Чтобы загрузить KubeKey, выполните следующую команду:

curl -sfL https://get-kk.kubesphere.io | sh -

Эта команда получает и выполняет сценарий установки из официального источника KubeSphere.

Установка исполняемых разрешений

После загрузки необходимо установить разрешения на выполнение для KubeKey:

chmod +x kk

Настройте регион загрузки (если необходимо)

Если вы находитесь в Китае или предпочитаете другой регион загрузки, установите переменную окружения KKZONE соответствующим образом:

export KKZONE=cn

Создание файла конфигурации

Создайте файл конфигурации для вашей установки KubeSphere, выполнив следующую команду:

./kk create config --with-kubernetes

Эта команда генерирует конфигурационный файл YAML на основе указанной вами версии Kubernetes.

Редактирование файла конфигурации

Отредактируйте сгенерированный файл конфигурации с помощью предпочтительного текстового редактора (например, vim или nano), чтобы настроить такие параметры, как сетевые опции или классы хранения, если это необходимо:

nano config.yaml

Этот файл будет сопровождать KubeKey в процессе установки.

Установка KubeSphere

Запустите команду установки

Теперь вы готовы приступить к установке KubeSphere вместе с Kubernetes. Выполните следующую команду, заменив `<kubernetes-version>` и `<kubesphere-version>` на нужные вам версии:

./kk create cluster --with-kubernetes v1.22.12 --with-kubesphere v3.4.1

Эта команда начнет загрузку необходимых образов и конфигурирование кластера на основе ваших настроек YAML.

Мониторинг хода установки

Вы можете следить за ходом установки, проверяя состояние подсистем и сервисов с помощью этих команд:

kubectl get pods -n kubesphere-system
kubectl get svc -n kubesphere-system

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

Доступ к инструментальной панели KubeSphere

После завершения установки откройте панель KubeSphere через веб-браузер. По умолчанию обычно используется URL-адрес http://your-IP-address:30880/. Войдите в систему, используя стандартные учетные данные:

• Пользователь: admin
• Пароль: P@88w0rd

Вы можете изменить эти учетные данные после входа в систему в целях безопасности.

Шаги после установки

Проверка установки

Последний шаг — проверка правильности работы KubeSphere. Используйте эту команду, чтобы проверить, все ли стручки запущены:

kubectl get pods -n kubesphere-system

Если все стручки показывают статус «Running», поздравляем! Ваша установка KubeSphere прошла успешно.

Учетные данные по умолчанию для входа в систему

Учетные данные по умолчанию, указанные выше, следует изменить сразу после первого входа в систему для повышения безопасности. Перейдите в раздел «Настройки учетной записи» на панели управления, чтобы обновить пароль.

Устранение общих проблем

Если вы столкнулись с проблемами во время установки или эксплуатации, воспользуйтесь этими общими советами по устранению неполадок:

• PODS Not Starting: Если какие-либо капсулы застряли в статусе «Pending», проверьте, соответствует ли ваша система требованиям к ресурсам или нет ли проблем с сетью.
• Демон Docker не запускается: Если Docker не запускается, убедитесь, что он включен и запущен с помощью:

sudo systemctl start docker
sudo systemctl enable docker

• Kubernetes API Unreachable: Если вы не можете получить доступ к Kubernetes API, проверьте, запущен ли kube-apiserver:

kubectl get pods -n kube-system | grep apiserver

• Приборная панель KubeSphere недоступна: Если вы не можете получить доступ к приборной панели, проверьте настройки брандмауэра или убедитесь, что порт 30880 открыт.
• Сообщения об ошибках во время установки: Если во время установки вы столкнулись с определенными сообщениями об ошибках, обратитесь к официальной документации или форумам сообщества для поиска решений.
• Ошибка «Нет доступных ресурсов»: Если эта ошибка возникает при создании стручка, следует увеличить доступные ресурсы или изменить конфигурацию в файле YAML.
• Проблемы с постоянными томами: Если постоянные тома не связываются корректно, проверьте конфигурацию классов хранения и убедитесь, что на бэкендах хранилищ установлены правильные разрешения.
• POD Crash Looping:
  Если поды аварийно повторяются, проверьте журналы с:

kubectl logs

Это позволит выяснить, что может быть причиной сбоев.

Поздравляем! Вы успешно установили KubeSphere. Для получения дополнительной помощи или полезной информации мы рекомендуем вам посетить официальный сайт KubeSphere.