Як встановити 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.