Диски репозиториев#
Диск репозитория подключает сетевую папку к хранилищу RuDesktop. Файлы остаются на сетевом ресурсе и становятся доступны через выбранный репозиторий после подключения и синхронизации списка
Как это работает#
Диск подключается на сервере только для чтения. RuDesktop получает список файлов и создаёт для них записи в разделе «Файлы», которые можно выбирать в политиках и других сценариях
Примечание
Синхронизация обновляет эти записи, а не отправляет изменения обратно на сетевой ресурс
Для загрузки, изменения или удаления исходных файлов использовать сам сетевой ресурс, затем синхронизировать диск в RuDesktop
Для обычной загрузки файлов через браузер использовать отдельный репозиторий без подключённого диска
Подготовка#
Создать пустой пользовательский репозиторий
Служебные репозитории и репозитории с файлами для подключения не подходят
Обеспечить серверу доступ к сетевому ресурсу и подготовить учётные данные
Выдать пользователю права на просмотр и изменение дисков репозиториев, а также необходимые права на репозиторий и файлы
Важно
К одному репозиторию подключается один диск. После создания диска выбрать для него другой репозиторий нельзя
Добавление и подключение#
Открыть «Хранилище → Диски репозиториев» и добавить запись
Задать уникальное «Название» и выбрать пустой «Репозиторий»
Выбрать «Тип» и заполнить «Сетевой путь» по таблице ниже
Указать «Имя пользователя» и «Пароль», если ресурс требует авторизации
Для Samba и SFTP эти поля обязательны
На вкладке «Синхронизация» проверить «Синхронизировать по расписанию» и «Расписание синхронизации» - по умолчанию каждые 30 минут
Сохранить запись и выполнить «Подключить»
Дождаться результата на вкладке «Состояние», затем открыть «Файлы» и отфильтровать их по выбранному репозиторию
Тип |
Пример сетевого пути |
Учётные данные |
|---|---|---|
Samba |
|
Пользователь и пароль, при необходимости |
SFTP |
|
Пользователь и пароль |
WebDAV |
|
Пользователь и пароль, если требуется авторизация |
В пути можно указать порт сервера. Для Samba без явно заданного порта используется 445, для SFTP - 22. Учётные данные вводятся отдельными полями, их нельзя включать в сетевой путь
Подсказка
Сохранение записи ещё не подключает диск. После успешного подключения первая синхронизация запускается автоматически. Для обновления списка без ожидания расписания выполнить «Синхронизировать»
Действия доступны в меню строки диска и в его карточке при наличии прав. Они ставятся в очередь - уведомление о запуске ещё не означает завершение. Обновить страницу и проверить состояние, время и результат синхронизации. Если расписание отключено, первая синхронизация при подключении всё равно выполняется, а последующие обновления можно запускать вручную
Состояние и результаты#
«Состояние» описывает подключение: «Отключён», «Подключён» или «Ошибка»
«Статус синхронизации» описывает последний обход файлов: «Ещё не запускалась», «Синхронизация», «Успешно» или «Ошибка»
Проверять оба поля — подключение диска не гарантирует успешного чтения всего списка
В «Результате синхронизации» показано количество добавленных, обновлённых и удалённых записей, а также пропущенные файлы и сохранённые используемые записи
Новые файлы добавляются в список
Изменения определяются по размеру и времени изменения файла
Исчезнувшие файлы удаляются из списка только после получения полного списка
Если запись защищена ссылками из других объектов, она сохраняется
При неполном списке удаление отсутствующих записей пропускается
Причину неполной синхронизации смотреть в «Последней ошибке»
Обход включает вложенные папки выбранного сетевого пути. Папки не становятся отдельными записями файлов
Важно
Переименование или перенос файла в другую подпапку рассматривается как исчезновение прежнего пути и появление нового. Ссылки политик на старую запись автоматически на новую не переключаются. Если содержимое заменили, сохранив прежние размер и время изменения, синхронизация не обнаружит замену по этим признакам. Для новой версии установщика удобнее использовать новое имя файла, затем явно выбрать его в нужной политике
Пропускаются пути с символами ?, #, %, обратной косой чертой и управляющими символами, а также
слишком длинные пути. Если файл пропущен, изменить его имя или сократить вложенность папок на сетевом ресурсе
и повторить синхронизацию. Статус «Успешно» не исключает пропущенных файлов - проверять счётчики
Если в результате указано «Не удалось обновить содержимое точки монтирования», список записей уже мог обновиться, но доступ к новым файлам требует проверки. Повторить синхронизацию, затем проверить скачивание нужного файла. Если сообщение сохраняется, передать его администратору сервера. Сохранённая запись отсутствующего файла не восстанавливает сам файл
Если он нужен политике или другому объекту, восстановить его на сетевом ресурсе либо выбрать другой файл
Изменение подключения и ключ SFTP#
Чтобы изменить путь, тип, пользователя или пароль, сначала выполнить «Отключить» и дождаться состояния «Отключён». После изменения сохранить запись и подключить диск снова
Подсказка
Пустое поле пароля при редактировании сохраняет прежний пароль
При первом подключении SFTP сервер сохраняет ключ хоста. Если ключ сервера изменился, подключение может завершиться ошибкой. После проверки нового ключа у администратора SFTP отключить диск, выполнить «Сбросить ключ хоста SFTP» и подключить снова
Отключение и удаление#
«Отключить» прекращает доступ через подключённый диск и его плановую синхронизацию, но сохраняет запись диска и список файлов. После повторного подключения расписание возобновляется, если включён параметр «Синхронизировать по расписанию»
Удаление диска убирает его запись, связанные записи файлов и расписание. Исходные файлы сетевого ресурса не удаляются, репозиторий остаётся
Если файлы защищены ссылками из других объектов, удаление отклоняется. Проверить «Последнюю ошибку» и сначала заменить или убрать эти ссылки
Если файлы не появились#
Проверить, выполнено ли «Подключить», а не только сохранена запись
Проверить путь, учётные данные и доступ к ресурсу именно с сервера RuDesktop
Открыть «Последнюю ошибку» и «Результат синхронизации»
Если подключение работает, выполнить «Синхронизировать» и дождаться результата
В «Файлах» проверить фильтр репозитория
Если сообщение об ошибке указывает на невозможность запуска службы подключения, передать его администратору сервера
Пошаговый пример с общей папкой установщиков приведён в кейсе Подключение сетевой папки с установщиками