Представляємо втулок Cluster API для Headlamp
Headlamp — це відкритий, розширюваний проєкт Kubernetes SIG UI, призначений для огляду, керування та налагодження ресурсів кластера безпосередньо з вебоглядача.
Cluster API (CAPI) є субпроєктом Kubernetes, який надає декларативні API у стилі Kubernetes для керування життєвим циклом кластерів. Він дозволяє командам платформи створювати, оновлювати та керувати життєвим циклом кластерів Kubernetes за допомогою стандартних обʼєктів Kubernetes, збережених і узгоджених у кластері керування.
Керування ресурсами Cluster API історично вимагало використання команд kubectl та глибокого розуміння ієрархій власності. Втулок Headlamp Cluster API забезпечує візуальну ясність, швидше налагодження та спрощені операції для команд платформи безпосередньо всередині Headlamp.
Що надає цей втулок
Втулок Cluster API додає спеціальний розділ Cluster API до Headlamp і забезпечує повну видимість основних ресурсів CAPI через узгоджені списки та детальні перегляди.
| Можливість | Опис |
|---|---|
| Огляд кластерів | Перегляд кластерів з актуальним станом панелі управління та реплік робочих вузлів. |
| Видимість машин | Перевірка MachineDeployments, MachineSets, Machines та MachinePools зі станом та умовами. |
| Інфопанель Cluster API | Отримання централізованого огляду стану ресурсів Cluster API, активних проблем зі станами, інформації про провайдера та рекомендацій щодо усунення несправностей. |
| Моніторинг панелі управління | Відстеження реплік KubeadmControlPlane, версій та повʼязаних Machines. |
| Масштабування з інтерфейсу | Масштабування MachineDeployments та MachineSets безпосередньо з Headlamp. |
| Ієрархія підлеглих ресурсів | Відстеження взаємозвʼязків між кластерами, розгортаннями, наборами та машинами. |
| Перегляд KubeadmConfig | Перегляд конфігурацій завантаження, файлів, аргументів kubelet та налаштувань приєднання/ініціалізації. |
| Врахування топології | Автоматичне виявлення ресурсів, керованих ClusterClass, і призначення їм міток. |
| Мапа | Візуалізація взаємозвʼязків між Cluster, Control Plane та Worker. |
| Динамічне версіонування API | Підтримка обох версій Cluster API: v1beta1 та v1beta2. |
| Метрики Prometheus | Перегляд метрик наживо з втулка Headlamp Prometheus безпосередньо на сторінках деталей ресурсів Cluster API. |
Огляд втулка
Втулок Headlamp Cluster API надає основні ресурси Cluster API в узгодженому візуальному інтерфейсі всередині Headlamp. Ось деякі з ключових переглядів, включених у перший випуск.
Інфопанель Cluster API
Інфопанель надає централізований огляд ресурсів Cluster API та їх стану в кластері керування.
Огляд підсумовує стан кластерів, Machines, MachineDeployments, MachinePools, MachineSets та панелей управління. Він також виділяє поточні проблеми станів, інформацію про провайдера та кількість шаблонів конфігурацій, щоб допомогти операторам швидко виявляти деградовані або несправні ресурси.
Після вибору кластера відкривається детальний огляд стану, що показує стан панелі управління та робочих вузлів, інформацію про машини, деталі інфраструктури та стани ресурсів. Коли виявляються проблеми, панель надає рекомендації щодо усунення несправностей та діагностичні команди для допомоги у вирішенні проблем.
Забезпечте повну видимість Cluster API в Headlamp
Перегляд списку кластерів показує всі ресурси Cluster у кластері керування, включаючи стан реплік панелі управління та робочих вузлів. Це дає змогу швидко оцінити загальний стан кластера.
Перегляд деталей кластера надає інформацію про статус ресурсів, стани, посилання на інфраструктуру, посилання на панель керування та повʼязані Machines на одній сторінці.
Досліджуйте ресурси Cluster API у візуальному інтерфейсі
Для MachineDeployments, MachineSets, Machines та MachinePools доступні окремі перегляди. Ці сторінки відображають кількість реплік, відносини власності, ідентифікатори провайдерів, версії та стани для підтримки щоденних операцій та налагодження.
Масштабування робочих навантажень безпосередньо з Headlamp
MachineDeployments та MachineSets включають вбудовану дію масштабування, що дозволяє регулювати кількість реплік безпосередньо з Headlamp без використання команд терміналу.
Для кластерів із топологічним керуванням втулок також вказує, коли масштабування слід виконувати на рівні кластера.
Перегляд конфігурації bootstrap без сирого YAML
Конфігурації bootstrap можна переглядати у структурованому форматі, включаючи вбудовані файли, аргументи kubelet, додаткові томи та налаштування join або init. Це усуває необхідність вручну переглядати сирий YAML або Secret.
Візуалізація взаємозвʼязків кластера за допомогою мапи
Візуальна мапа показує взаємозвʼязки між Cluster, панеллю управління та робочими ресурсами. Це забезпечує швидший спосіб розуміння ієрархії власності та загальної структури кластера.
Інтеграція метрик Prometheus
Втулок Cluster API інтегрується з втулком Headlamp Prometheus, щоб показувати метрики безпосередньо на сторінках деталей ресурсів Cluster API.
Коли втулок Prometheus встановлено та налаштовано, метрики вбудовуються безпосередньо на сторінках деталей для Cluster, MachineDeployments, MachineSets та Machines. Ви можете переглядати стан ресурсів та дані про продуктивність разом із станами та відносинами власності, не переходячи на окрему панель.
Це спрощує зіставлення стану інфраструктури з поточними показниками під час налагодження або повсякденної експлуатації кластера — і все це безпосередньо в Headlamp.
Як використовувати
Дивіться plugins/cluster-api/README.md для інструкцій з встановлення та використання.
Розроблено під час програми LFX Mentorship
Цей втулок був розроблений в рамках програми CNCF LFX Mentorship в проєкті Headlamp. Програма наставництва надала можливість тісно співпрацювати зі спільнотою Headlamp під час створення можливостей для покращення керування Cluster API.
Основна увага приділялася не лише впровадженню можливостей, але й розумінню реальних проблем зручності використання під час операцій з Cluster API. Обговорення з наставниками та членами спільноти допомогли визначити напрямок розвитку втулка, покращити досвід використання та пріоритизувати можливості, найкорисніші для команд платформи.
Програма наставництва також надала цінний досвід участі у великих проєктах з відкритим кодом: співпраця із супровідниками, участь у дискусіях щодо дизайну, обробка відгуків про випуски та ітеративне вдосконалення можливостей на основі відгуків спільноти.
Робота над втулком триває, з додатковими покращеннями та можливостями, запланованими після початкового випуску Alpha.
Питання та відгуки
Це випуск Alpha, і відгуки спільноти безпосередньо впливають на подальший розвиток.
- Повідомлення про помилки: Створити issue
- Запити на нові можливості: Почати обговорення
- Внесок: PR вітаються
- Kubernetes Slack: Приєднатися до каналу #headlamp для питань та обговорень