Установка Rancher на Ubuntu 22.04

Схема развертывания Rancher и Kubernetes

Что такое Rancher

Rancher — бесплатная open-source платформа для оркестрации и централизованного управления множеством Kubernetes-кластеров. Простыми словами: это веб-панель и набор сервисов, которые упрощают развертывание, безопасность и управление кластерами по всему ландшафту — на bare metal, в частных и публичных облаках или на vSphere.

Ключевые функции (кратко):

Кросс-хост сетевые возможности
Балансировка нагрузки контейнеров
Постоянное хранилище (Persistent Storage)
Сервис-дискавери и обновления сервисов
Управление ресурсами
Мультиарендность и управление пользователями
Поддержка нескольких движков оркестрации

Важно: в примере используется rancher/rancher:v2.4.18 — это конкретная версия для демонстрации. Перед продакшн-развёртыванием рекомендуем проверить совместимость и рассмотреть актуальную LTS-версию Rancher.

Требования

Сервер с Ubuntu 22.04 (root-доступ).
Минимум 4 ГБ оперативной памяти (рекомендовано 8 ГБ для продакшна).
Открытые порты 80 и 443 (или настроенный прокси/балансировщик).
Действительный сертификат TLS для публичного доступа (рекомендуется).

Начало работы — обновление системы

Перед установкой обновите пакеты:

apt update
apt upgrade -y

После обновления можно переходить к установке Docker CE.

Установка Docker CE

На Ubuntu 22.04 Docker доступен в репозитории: установите пакет docker.io:

apt install docker.io -y

Проверьте версию:

docker version

Ожидаемый пример вывода (зависит от версии вашего пакета):

Client:
 Version:           20.10.12
 API version:       1.41
 Go version:        go1.17.3
 Git commit:        20.10.12-0ubuntu4
 Built:             Mon Mar  7 17:10:06 2022
 OS/Arch:           linux/amd64
 Context:           default
 Experimental:      true

Server:
 Engine:
  Version:          20.10.12
  API version:      1.41 (minimum version 1.12)
  Go version:       go1.17.3
  Git commit:       20.10.12-0ubuntu4
  Built:            Mon Mar  7 15:57:50 2022
  OS/Arch:          linux/amd64
  Experimental:     false
 containerd:
  Version:          1.5.9-0ubuntu3
  GitCommit:
 runc:
  Version:          1.1.0-0ubuntu1
  GitCommit:
 docker-init:
  Version:          0.19.0
  GitCommit:

Управление службой Docker

Docker управляется systemd. Запустите и включите автозапуск:

systemctl start docker
systemctl enable docker

Проверка статуса:

systemctl status docker

Пример вывода статуса (сокращённо):

? docker.service - Docker Application Container Engine
     Loaded: loaded (/lib/systemd/system/docker.service; enabled; vendor preset: enabled)
     Active: active (running) since Sun 2022-07-24 05:09:45 UTC; 24s ago
TriggeredBy: ? docker.socket
       Docs: https://docs.docker.com
   Main PID: 115654 (dockerd)
      Tasks: 7
     Memory: 30.5M
        CPU: 356ms
     CGroup: /system.slice/docker.service

Если служба не запускается — проверьте логи journalctl -u docker.

Установка Rancher на Ubuntu 22.04

Запустите контейнер Rancher из Docker Hub:

docker run -d --name=rancher-server --restart=unless-stopped -p 80:80 -p 443:443 --privileged rancher/rancher:v2.4.18

Пример вывода при загрузке образа и создании контейнера:

Unable to find image 'rancher/rancher:v2.4.18' locally
v2.4.18: Pulling from rancher/rancher
11323ed2c653: Pull complete 
... (пропущено)
Status: Downloaded newer image for rancher/rancher:v2.4.18
51405105eee8eed48dcaf7589ef253295275c941fc3963a2ca9e9c43d844b410

Проверьте образ:

docker images

Проверьте запущенные контейнеры:

docker ps

Ожидаемая строка с Rancher в выводе:

CONTAINER ID   IMAGE                     COMMAND           CREATED          STATUS          PORTS                                                                      NAMES
2d32d612b497   rancher/rancher:v2.4.18   "entrypoint.sh"   23 seconds ago   Up 21 seconds   0.0.0.0:80->80/tcp, :::80->80/tcp, 0.0.0.0:443->443/tcp, :::443->443/tcp   rancher-server

Доступ к веб-интерфейсу Rancher

Откройте браузер и перейдите по адресу https:// или по настроенному DNS-имени. Вас перенаправит на экран приветствия.

Экран приветствия Rancher

Установите пароль администратора, затем задайте адрес сервера и подтвердите сбор анонимной телеметрии (опционально).

Настройка пароля

Настройка URL сервера

После завершения настроек вы увидите дашборд Rancher:

Дашборд Rancher

Управление контейнером Rancher

Просмотр логов:

docker container logs rancher-server

Пример строки лога (сокращённо):

2022/07/24 05:13:27 [INFO] kontainerdriver azurekubernetesservice listening on address 127.0.0.1:39997
... (пропущено)
time="2022-07-24 05:19:08" level=info msg="Telemetry Client v0.5.14"

Остановка / запуск / приостановка / удаление контейнера:

docker container stop rancher-server
docker container start rancher-server
docker container pause rancher-server
docker container remove rancher-server

Альтернативные подходы и совместимость

Развернуть Rancher не в Docker, а с помощью официальных Helm-чартов в Kubernetes (подходит для HA-сценариев).
Рассмотреть RKE2 или k3s для создания лёгких кластеров, которыми затем будет управлять Rancher.
На современных дистрибутивах контейнерная runtime рекомендована containerd; Docker (docker.io) всё ещё поддерживается, но проверьте совместимость с вашей версией Rancher.

Отказоустойчивость и отладка — частые проблемы

Когда что-то не работает:

Контейнер не стартует: проверьте docker container logs rancher-server и journalctl -u docker.
Порт 443 занят: выясните процесс ss -ltnp | grep 443.
Проблемы с TLS: проверьте имя в сертификате и URL, который вы указали в интерфейсе Rancher.
Низкая память: при <4 ГБ возможны ошибки; увеличьте ресурсы.

Короткий чек диагностики:

docker ps — контейнер Up?
docker logs — ошибки при инициализации?
curl -vk https://<ваш-хост> — TLS и редиректы
Проверить диск и память: df -h, free -m

Чек-лист по ролям

Администратор инфраструктуры:

Проверил сетевые правила и открытые порты
Настроил TLS-сертификат и DNS
Настроил бэкапы и мониторинг хоста

DevOps/Оператор кластера:

Проверил подключение рабочих узлов к Rancher
Создал политики RBAC и проекты
Настроил CI/CD интеграции (при необходимости)

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

Импортировал/создал кластер и проверил деплой приложения
Проверил логирование и мониторинг приложения через Rancher

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

Rancher UI доступен по HTTPS
Администратор может войти и задать URL
Создание/импорт кластера проходит без ошибок
Есть резервная копия конфигурации

Мини-методология развёртывания (SOP)

Подготовить сервер: Ubuntu 22.04, минимум 4–8 ГБ RAM.
Обновить систему и установить Docker.
Пропустить тестовый запуск Rancher в Docker (одиночный контейнер).
Настроить TLS и DNS.
Перевести в HA с помощью Helm/конфигурации (при необходимости).
Настроить мониторинг и бэкапы.

Краткая справка (глоссарий)

Rancher — платформа управления Kubernetes.
Docker CE — контейнерная платформа для запуска образов.
TLS — протокол шифрования для HTTPS.
HA — высокая доступность.

Пример диаграммы принятия решения

flowchart TD
  A[Начало] --> B{Нужен ли HA?}
  B -- Да --> C[Развернуть Rancher в Kubernetes с Helm]
  B -- Нет --> D[Запустить rancher/rancher в Docker]
  C --> E[Настроить сертификаты и бэкап]
  D --> E
  E --> F[Подключить кластеры и политики]

Заключение

Вы успешно установили Rancher в одиночном режиме на Ubuntu 22.04 и научились базовым операциям: установка Docker, запуск контейнера, доступ к интерфейсу, управление контейнером и базовые рекомендации по безопасности. Для продакшна рассмотрите развёртывание в режиме высокой доступности и использование актуальных версий Rancher и runtime. Если нужны конкретные шаги для HA, Helm-чартов или миграции существующих кластеров — спрашивайте.