Sherpa Orchestrator(docker)#

Подготовка Sherpa Orchestrator (скачивание файлов)#

На этом этапе вы скачаете все необходимые компоненты для установки Sherpa Orchestrator: клиентские файлы и Docker-образы.

Скачивание всех необходимых файлов#

Скачивание клиентских файлов#

# Скачайте архив с клиентскими файлами через командную строку
curl -L -OJ \
https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator-client-files/latest
💡 Комментарии к скачиванию клиентских файлов

curl -L -OJ - скачивает файл с сервера

  • -L - следует редиректам
  • -O - сохраняет файл с оригинальным именем
  • -J - использует имя файла предоставленное сервером

Скачивание Docker-образов#

Скачайте следующие файлы через командную строку или браузер:

Основные Docker-образы:

  • orchestrator_*.tar.gz - основной веб-сервер оркестратора с API и интерфейсом
  • orchestrator-db_*.tar.gz - база данных MariaDB/MySQL (скачивать, если используете профиль mariadb)
  • orchestrator-pg_*.tar.gz - база данных PostgreSQL (скачивать, если используете профиль pg)
  • orchestrator-nginx_*.tar.gz - nginx сервер
  • orchestrator-websocket_*.tar.gz - websocket сервер
  • orchestrator-vnc-proxy_*.tar.gz - прокси-сервер для VNC подключений (опционально)
  • orchestrator-vault_*.tar.gz - Vault для хранения секретов (опционально, профиль vault)

Правило выбора образов:

  • Всегда скачивайте: orchestrator, orchestrator-nginx, orchestrator-websocket
  • При встроенной БД скачайте только один подходящий образ: orchestrator-db (MariaDB) или orchestrator-pg (PostgreSQL). При подключении к внешней БД образ БД Оркестратора не нужен.
  • orchestrator-vnc-proxy скачивайте только если нужен VNC-доступ
  • orchestrator-vault скачивайте только если используете профиль vault

WINDOWS: если скачиваете с браузера, перейдите по ссылкам ниже и скачивание начнется автоматически, не выполняя команду curl

Ссылки для скачивания:

# Основные Docker-образы
curl -L -OJ  https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator/latest
curl -L -OJ https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator-nginx/latest
curl -L -OJ https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator-websocket/latest
# Выберите ОДИН вариант БД:
# Вариант 1 (mariadb): MariaDB/MySQL
curl -L -OJ https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator-db/latest


# Вариант 2 (pg): PostgreSQL
curl -L -OJ https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator-pg/latest


# Опционально: только если нужен VNC proxy
curl -L -OJ https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator-vnc-proxy/latest


# Опционально: только если нужен Vault (profile vault)
curl -L -OJ https://downloads.sherparpa.ru/SherpaOrchestrator/docker/orchestrator-vault/latest

Ожидаемый результат: В текущей директории появятся все необходимые файлы для установки Sherpa Orchestrator.

Ожидаемое время: 10-30 минут в зависимости от скорости интернет-соединения.

Возможные проблемы при скачивании:#

  • Ошибка скачивания: Проверьте интернет-соединение и корректность URL
  • Недостаточно места: Архивы могут быть большими (от 500 МБ до 5+ ГБ), убедитесь в наличии свободного места
  • Поврежденные файлы: Если скачивание прервалось, попробуйте скачать файл снова
  • Права доступа: Убедитесь, что у пользователя есть права на запись в текущую директорию

Проверка успешности скачивания:#

# Проверьте наличие всех файлов
ls -la *.tar.gz *.tar *.tgz 2>/dev/null | wc -l


# Проверьте размеры файлов (должны быть больше 0)
ls -lh *.tar.gz *.tar *.tgz 2>/dev/null


# Проверьте целостность архивов (опционально)
file *.tar.gz *.tar *.tgz
💡 Комментарии к проверке скачивания

**ls -la *.tar.gz .tar .tgz 2>/dev/null | wc -l - подсчитывает количество скачанных файлов

  • ls -la - показывает подробную информацию о файлах
  • *.tar.gz *.tar *.tgz - шаблоны для поиска архивов
  • 2>/dev/null - скрывает ошибки если файлы не найдены
  • | wc -l - подсчитывает количество строк (файлов)

**ls -lh *.tar.gz .tar .tgz 2>/dev/null - показывает размеры файлов

  • -l - длинный формат
  • -h - человеко-читаемый формат размеров

**file *.tar.gz .tar .tgz - определяет типы файлов

  • Проверяет, что файлы являются корректными архивами

Перенос файлов на целевой сервер#

После успешного скачивания всех файлов необходимо передать их на целевой Linux сервер, где будет выполняться установка Sherpa Orchestrator.

Способы передачи файлов#

Используйте любой удобный способ передачи файлов на целевой сервер:

  • SFTP/SCP клиент: FileZilla, WinSCP, Cyberduck
  • Командная строка: bash # Скопировать файлы на удаленный сервер scp *.tar.gz *.tar *.tgz user@target-server:/path/to/installation/directory/

💡 Комментарии к передаче файлов через командную строку

**scp *.tar.gz .tar .tgz user@target-server:/path/to/installation/directory/ - копирует файлы на удаленный сервер - scp - secure copy (безопасное копирование) - *.tar.gz *.tar *.tgz - шаблоны файлов для копирования - user@target-server - учетные данные для подключения - /path/to/installation/directory/ - путь назначения на сервере

  • Копирование через сетевую папку: Если сервер доступен по SMB/CIFS
  • USB-накопитель: Физическая передача носителя
  • Облачное хранилище: Google Drive, Dropbox, OneDrive с последующей загрузкой на сервер

Проверка передачи файлов#

После передачи файлов на целевой сервер убедитесь в их целостности:

# Подключитесь к целевому серверу
ssh user@target-server


# Перейдите в директорию с файлами
cd /path/to/installation/directory


# Проверьте наличие всех файлов
ls -la *.tar.gz *.tar *.tgz 2>/dev/null | wc -l


# Проверьте размеры файлов
ls -lh *.tar.gz *.tar *.tgz 2>/dev/null


# Проверьте свободное место на диске
df -h .
💡 Комментарии к проверке передачи файлов

ssh user@target-server - подключается к удаленному серверу по SSH

  • ssh - secure shell
  • user@target-server - учетные данные для подключения

cd /path/to/installation/directory - переходит в директорию с файлами

**ls -la *.tar.gz .tar .tgz 2>/dev/null | wc -l - подсчитывает количество переданных файлов

**ls -lh *.tar.gz .tar .tgz 2>/dev/null - проверяет размеры файлов

df -h . - показывает свободное место на диске

  • -h - человеко-читаемый формат
  • . - текущая директория

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