Сервер обновлений Linux

Получение скрипта

Для получения файлов, необходимых на сервере обновлений, мы предлагаем использовать Bash-скрипт. Вы можете скачать его из браузера или из терминала:

curl

curl -O https://repos.passwork.ru/repository/linux/scripts/get_desktops.sh

wget

wget -O get_desktops.sh https://repos.passwork.ru/repository/linux/scripts/get_desktops.sh

Преимущества использования

• Скачивает из нашего репозитория только нужную версию — согласованную с бэкендом. Удалённый репозиторий используется как источник файлов, но не как источник версии: в нём располагаются все версии десктопного приложения. Какую именно XXYY скачивать, скрипт определяет из API или локального файла.
• Поддерживает прокси (HTTP_PROXY / HTTPS_PROXY), что важно в закрытых сетях с выходом в интернет через прокси.
• Можно запускать по расписанию (cron / Task Scheduler), чтобы сервер обновлений содержал актуальную для вашего бэкенда версию.

Откуда берётся версия (какой XXYY качать):

1. API бэкенда — если задан PASSWORK_DOMAIN, скрипт запрашивает доступную версию десктопа через API вашего сервера Пассворк и скачивает соответствующий XXYY.
2. Локальный файл — файл LOCAL_VERSIONS_FILE содержит строку с версией.

Других источников версии нет: репозиторий с файлами используется только для скачивания, не для определения версии.

За один запуск скачивается только одна версия XXYY. Если бэкенд переключился на новую версию — при следующем запуске скрипт получит новый XXYY (из API или обновлённого файла) и скачает файлы обновлений.

Основные переменные

Переменная	Описание
REPO_BASE_URL	URL репозитория с собранными десктопами (источник файлов).
OUTPUT_DIR	Каталог для сохраняемых файлов (корень сервера обновлений или его копия).
PASSWORK_DOMAIN	URL бэкенда для запроса версии через API (рекомендуется, если есть доступ).
LOCAL_VERSIONS_FILE	Путь к файлу версий, если API не используется.
HTTP_PROXY	Прокси для исходящих запросов (например http://proxy:3128).
LOG_FILE	Путь к файлу лога (необязательно).
STATUS_FILE	Путь к файлу статуса для мониторинга (необязательно, см. раздел «Мониторинг»).
KEEP_RELEASES	Сколько старых каталогов XXYY хранить в OUTPUT_DIR (по умолчанию 2).
LOCK_FILE	Файл блокировки для предотвращения параллельного запуска (cron); пустая строка — отключить.

Тестовый запуск

shell

./get_desktops.sh --dry-run

Запуск

shell

# Один раз или по cron
export PASSWORK_DOMAIN="https://your-backend.example.com"
export OUTPUT_DIR="/var/www/updates"
export HTTP_PROXY="http://proxy.example.com:3128"   # при необходимости
./get_desktops.sh

Скрипт проверяет место на диске, при необходимости создаёт блокировку, чтобы не запускались два экземпляра скрипта одновременно (например, из cron), сравнивает манифесты с уже скачанными и качает только при изменениях.

Мониторинг

Чтобы проверять, что синхронизация отработала и контент актуален:

1. Код выхода скрипта

   • 0 — успех, обновление не требовалось или успешно выполнено, либо режим --dry-run.
   • 1 — ошибка (сеть, репозиторий, место на диске и т.д.).
     Системы мониторинга (cron + скрипт проверки, Zabbix, Prometheus и т.п.) могут анализировать коды выходы скрипта.

2. Файл статуса (STATUS_FILE)
   Если задана переменная STATUS_FILE, скрипт после каждого запуска перезаписывает этот файл строками формата key=value:

   • status — ok или error;
   • version — актуальная версия XXYY (или пусто при ошибке до определения версии);
   • timestamp — время в UTC (ISO);
   • message — краткое сообщение (например «Update complete for version 0002» или «All latest YAML unchanged»).

   Пример содержимого после успешного запуска:

shell

status=ok
version=0002
timestamp=2025-02-17T12:00:00Z
message=Update complete for version 0002

При ошибке (в том числе до определения версии) скрипт пишет status=error и при необходимости message=exit N. Проверка в мониторинге: читать STATUS_FILE, убедиться, что status=ok, и при желании проверить актуальность по timestamp или наличие каталога OUTPUT_DIR/<version>/latest.yml.

3. Лог (LOG_FILE)
   Если задан LOG_FILE, туда пишутся все сообщения скрипта. Можно анализировать лог на наличие ошибок или строк вроде «Update complete» / «Repository unreachable».

Пример проверки для мониторинга (Bash):

shell

STATUS_FILE="/var/www/updates/.sync_status"
export STATUS_FILE
./get_desktops.sh

# Проверка после запуска (или из другого скрипта по расписанию):
grep -q '^status=ok$' "$STATUS_FILE" && echo "Sync OK" || echo "Sync FAIL"

# или по актуальности (например, не старше 25 часов):
ts=$(grep '^timestamp=' "$STATUS_FILE" | cut -d= -f2)

Версия для LLM