Установка Helm на Ubuntu 20.04

Helm — менеджер пакетов для Kubernetes. В этой статье показаны шаги по установке Helm 3 на сервер с Ubuntu 20.04, базовые команды для работы с репозиториями и поиск чартов, а также практичные чек-листы, отладка ошибок и шпаргалка по командам. Требуется отдельный Kubernetes-кластер для установки чартов — здесь мы его не разворачиваем.

Введение

Helm — это пакетный менеджер для Kubernetes. Он упрощает совместное использование, поиск и установку приложений, подготовленных для работы в Kubernetes. Helm помогает управлять релизами приложений, их конфигурациями и зависимостями.

Эта статья фокусируется на установке Helm 3 на Ubuntu 20.04 и демонстрации основных команд. Развёртывание приложений и создание чартов подробно не рассматриваются — для этого есть отдельные материалы.

Важно: Helm 3 сильно отличается от Helm 2 — в основном из‑за удаления компонента Tiller, что упростило модель безопасности и взаимодействие с Kubernetes API.

Ключевые термины (1‑строчные определения)

• Helm chart — пакет Helm с метаданными и шаблонами Kubernetes-манифестов.
• Helm release — экземпляр установленного чарта в кластере (релиз приложения).
• Helm repository — хранилище чарта, доступное по URL.
• Chart.yaml — файл с описанием чарта (имя, версия, указания и т. п.).
• values.yaml — файл со значениями, которые переопределяют поведение чарта.

Что понадобится (пререквизиты)

• Сервер с Ubuntu 20.04 (доступ по SSH).
• Доступ в интернет для загрузки скриптов и репозиториев Helm.
• (Для установки чартов) Действующий Kubernetes-кластер и kubeconfig. В этой статье кластер не обязателен.

План действий

1. Проверить систему и существующую установку Helm.
2. Установить Helm 3 с официального скрипта.
3. Добавить репозитории и выполнить поиск чартов.
4. Показать основные команды, среду и диагностику ошибок.

Проверка ОС и наличия Helm

Сначала убедитесь, что вы на Ubuntu 20.04 и проверьте, не установлен ли уже Helm:

cat /etc/issue
helm version --short || echo "Helm не установлен"

Установка Helm

Самый простой и официальный способ установки Helm — выполнить официальный скрипт установки. Команды последовательные:

# Очистим экран для удобства
clear

# Скачиваем официальный установочный скрипт
curl -fsSL -o get_helm.sh https://raw.githubusercontent.com/helm/helm/master/scripts/get-helm-3

# Делаем скрипт исполняемым
chmod 700 get_helm.sh

# Запускаем установку
./get_helm.sh

После успешной установки выполните:

helm --help
helm version

Important: скрипт устанавливает двоичный файл Helm в системный путь. При необходимости можно скачать бинарник вручную и поместить его в /usr/local/bin.

Базовые операции: поиск и репозитории

Helm поддерживает два основных типа поиска:

• Поиск в глобальном каталоге (hub) — ищет по индексам публичных чартов.
• Поиск по локально добавленным репозиториям (repo).

Поиск по Helm Hub:

helm search hub apache

clear

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

helm search repo apache
# -> Error: no repositories configured

Чтобы добавить общедоступный репозиторий stable (устаревший пример, но часто используемый в статьях):

helm repo add stable https://charts.helm.sh/stable
helm repo update
helm search repo apache

Попытка установки чарта (без кластера)

Пример установки Jenkins из локального репозитория (установка без кластера приведёт к ошибке):

helm search repo jenkins
helm install jenkins stable/jenkins

Если Kubernetes API недоступен (нет кластера или kubeconfig некорректен), вы получите ошибку типа “Kubernetes cluster unreachable”.

Поиск и установка напрямую с Hub:

helm search hub jenkins
# В результатах будет URL чарта. Можно добавить соответствующий репозиторий.
helm repo add bitnami https://charts.bitnami.com/bitnami
helm repo update
helm install my-jenkins bitnami/jenkins

Сведения о среде Helm

Чтобы посмотреть переменные окружения и конфигурацию Helm на машине:

helm env

Когда установка чарта завершится ошибкой: распространённые причины и решения

1. Ошибка: “Kubernetes cluster unreachable”

   • Причина: нет доступа к API Kubernetes или kubeconfig не настроен.
   • Решение: проверьте kubeconfig (~/.kube/config), подключение к кластеру (kubectl get nodes).

2. Ошибка: “no repositories configured”

   • Причина: не добавлен ни один репозиторий.
   • Решение: helm repo add && helm repo update.

3. Несовместимость версий чарта и Kubernetes

   • Причина: чарт рассчитан на другую версию Kubernetes.
   • Решение: изучите Chart.yaml и values; при необходимости используйте совместимые версии или установите нужный кластер.

4. Проблемы с сетевыми прокси и сертификатами

   • Причина: curl или Helm не могут достучаться до репозитория.
   • Решение: настройте переменные окружения HTTP(S)_PROXY или добавьте доверенный сертификат.

Альтернативные способы установки Helm

• Установка бинарного файла вручную: скачать релиз с GitHub Releases и поместить в /usr/local/bin.
• Использовать пакетный менеджер snap/apt (ограниченная актуальность и версии).
• Контейнерный образ для одноразовых задач (helm в Docker-контейнере) — полезно в CI.

Мини‑методология: как безопасно добавить и использовать чарт в продакшне

1. Проверка источника: добавляйте только проверенные репозитории (официальные, Bitnami и т. п.).
2. Локальный аудит чарта: просмотрите шаблоны и values перед установкой.
3. Стадии развертывания: dev → staging → prod, с разными values.yaml.
4. Бэкап: храните версии values и манифестов, используйте систему контроля версий.
5. Мониторинг и откат: определите метрики состояния приложения и протестируйте rollback.

Чек-лист перед установкой чарта

• Проверен kubeconfig и доступ к API (kubectl get nodes).
• Добавлены нужные репозитории (helm repo list).
• Выполнен helm repo update.
• Прочитан Chart.yaml и values.yaml чарта.
• Создан values.override.yaml с нужными значениями для среды.
• Настроен бэкап и мониторинг для релиза.

Роли: что должен сделать DevOps и что — разработчик

DevOps:

• Проверить и подготовить кластер.
• Настроить CI/CD для автоматической установки и отката.
• Управлять секретами и доступами.

Разработчик:

• Предоставить values.yaml с конфигурацией приложения.
• Тестировать чарты в dev-среде.

Шпаргалка по командам (cheat sheet)

# Установить Helm (скрипт)
./get_helm.sh

# Просмотреть версию
helm version

# Список репозиториев
helm repo list
helm repo add  
helm repo update

# Поиск
helm search hub 
helm search repo 

# Установка чарта
helm install   -f my-values.yaml

# Список релизов
helm list

# Удаление релиза
helm uninstall 

# Информация о среде
helm env

Критерии приёмки

• Helm установлен и доступен в PATH.
• helm version возвращает корректную версию 3.x.
• Добавлен хотя бы один репозиторий и выполнен helm repo update.
• Команды поиска и env работают без ошибок (за исключением попыток установки без кластера).

Безопасность и конфиденциальность

• Никогда не храните секреты в открытых values.yaml. Используйте Sealed Secrets, HashiCorp Vault или Kubernetes Secrets.
• Добавляйте только доверенные репозитории и проверяйте шаблоны чарта.
• Разграничивайте права доступа к kubeconfig и используйте RBAC.

Совместимость и замечания для Ubuntu 20.04

• Убедитесь, что curl и ca-certificates обновлены, чтобы скрипт мог загрузиться по HTTPS.
• Для старых версий Ubuntu или air-gapped окружений предпочтительней установка бинарника вручную.

Краткое резюме

В этой статье мы установили Helm 3 на Ubuntu 20.04, разобрали основные команды для поиска и добавления репозиториев, а также показали, почему установка чартов требует наличия Kubernetes-кластера. Приведены чек-листы, рекомендации по безопасности и шпаргалка по командам.

Важно: для развёртывания приложений изучите отдельную статью “Как разворачивать приложения в Kubernetes с помощью Helm”.

Глоссарий (1‑строчные термины)

• Chart — пакет Helm.
• Release — установленный экземпляр чарта.
• Repo — репозиторий чарта.
• values.yaml — файл с параметрами чарта.

Дополнительные ресурсы и заметки:

• Официальная документация Helm: https://helm.sh
• Репозитории чартов: Bitnami, Artifact Hub