Требования к серверу Sherpa Orchestrator

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

• ОС: рекомендуется Ubuntu 20.04+, однако с другими дистрибутивами Linux как правило не возникает никаких проблем.

• CPU: x86_64, минимум 2 ядра

• RAM: 4 ГБ минимум, 8 ГБ+ рекомендуется

• Диск: 20 ГБ+ свободного места

• Сеть: Стабильное интернет-соединение

• Доступ: sudo права для установки

Важно:

• Установка занимает время из-за скачивания Docker-образов

• После установки интернет не требуется для работы

Подготовка сервера

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

Далее используется синтаксис Ubuntu, если команда не подходит, вам необходимо изменить синтаксис в зависимости от вашей ОС

# Проверьте системные ресурсы
df -h          # Дисковое пространство
free -h        # Оперативная память
lscpu | grep -E "^CPU\(s\)|Model name"  # Информация о процессоре

💡 Комментарии к проверке ресурсов

df -h - показывает использование дискового пространства в человеко-читаемом формате free -h - показывает информацию об оперативной памяти lscpu - показывает информацию о процессоре

Рекомендуемые минимальные значения:

• Диск: минимум 20 ГБ свободного места

• RAM: минимум 4 ГБ

• CPU: минимум 2 ядра

Установка базовых инструментов

# Обновите систему и установите инструменты
sudo apt update
sudo apt install -y ca-certificates curl tar

💡 Комментарии к установке базовых инструментов

sudo apt update - обновляет список доступных пакетов из репозиториев sudo apt install -y ca-certificates curl tar - устанавливает необходимые инструменты:

• ca-certificates - корневые сертификаты для проверки SSL

• curl - инструмент для скачивания файлов

• tar - утилита для работы с архивами

• -y - автоматическое подтверждение установки

Установка Docker (обязательно)

Sherpa Orchestrator работает исключительно в Docker-контейнерах.

Установка Docker CE

# Добавьте официальный GPG-ключ Docker
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Добавьте репозиторий Docker
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

# Установите Docker
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

💡 Комментарии к установке Docker

Добавление GPG-ключа:

• sudo install -m 0755 -d /etc/apt/keyrings - создает директорию для ключей с правильными правами

• sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc - скачивает GPG-ключ Docker

• sudo chmod a+r /etc/apt/keyrings/docker.asc - устанавливает права чтения для всех

Добавление репозитория:

• echo "deb [...] - добавляет официальный репозиторий Docker в список источников APT

• Использует переменные окружения для определения архитектуры и версии Ubuntu

Установка пакетов:

• sudo apt update - обновляет список пакетов после добавления нового репозитория

• sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin - устанавливает Docker и компоненты

Настройка и проверка

# Добавьте пользователя в группу docker (опционально)
sudo usermod -aG docker $USER

# Запустите и включите Docker
sudo systemctl start docker
sudo systemctl enable docker

# Проверьте установку
docker --version
docker compose version

💡 Комментарии к настройке Docker

sudo usermod -aG docker $USER - добавляет текущего пользователя в группу docker

• -a - append (добавляет к существующим группам)

• -G docker - добавляет в группу docker

• $USER - переменная с именем текущего пользователя

sudo systemctl start docker - запускает Docker daemon sudo systemctl enable docker - включает автозапуск Docker при загрузке системы

docker --version - показывает версию Docker docker compose version - показывает версию Docker Compose

Ожидаемый результат: Docker успешно запускает тестовый контейнер.

Проверка портов

Sherpa Orchestrator использует следующие порты:

• 443 - HTTPS веб-интерфейс (обязательно)

• 5000 - API VNC прокси

• 6080-6100 - диапазон портов для VNC подключений

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

# Проверьте, заняты ли необходимые порты
sudo netstat -tlnp | grep -E ":443 |:5000 |:608[0-9] |:609[0-9] |:6100 " || echo "Порты свободны"

💡 Комментарии к проверке портов

sudo netstat -tlnp - показывает все прослушиваемые TCP порты и процессы

• -t - TCP порты

• -l - только прослушиваемые порты

• -n - числовой формат (без разрешения имен)

• -p - показывает PID и имя процесса

Ожидаемый результат:

• Если порты свободны, команда выведет "Порты свободны"

• Если порты заняты, будут показаны процессы, которые их используют

Проверка конфигурации

Финальная проверка перед запуском

# Проверьте Docker
docker --version && docker compose version

# Проверьте переменные окружения
cat .env

# Проверьте доступность портов
sudo netstat -tlnp | grep -E ":443 |:5000 |:608[0-9] |:609[0-9] |:6100 " || echo "Все порты свободны"

# Проверьте дисковое пространство
df -h /var/lib/docker || echo "Docker storage driver не настроен"

echo "Если все проверки пройдены успешно, можно запускать Sherpa Orchestrator"

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