Важно: Данный раздел актуален для Платформы данных в Публичном облаке и On-Premise.
¶ 1. Предварительные условия
Для того, чтобы иметь возможность создавать крон-заданий в RT.WideStore должно быть выполнено следующее:
- Должен быть развернут кластер RT.WideStore с использованием плагина версии не ниже 1.21.7.
- Должен быть установлен компонент ch, выполнена его привязка к хостам провайдера, а выполнена установка программного обеспечения на эти хосты.
¶ 2. Размещение файлов на хосты
Для размещения файлов на хосты необходимо выполнить следующие действия:
- Откройте форму: “Кластеры -> имя_кластера -> ch -> Конфигурация”, в правой части формы выберите вкладку “copy_files”.
- Для параметра “enable_file_copy” установите значение “true”.
- Для параметра “copy_from_url” добавьте строку нажав на соответствующую кнопку (строк можно добавить несколько, для копирования нескольких файлов).
- В левой части добавленной строки введите ссылку на файл с http(s) или ftp ресурса откуда будет выполняться копирование.
- В правой части добавленной строки введите путь куда будет скопирован файл на хост RT.WideStore.
- Для параметра “headers_url” добавьте строку нажав на соответствующую кнопку.
- В левой части добавленной строки введите ключ, в правой части добавленной строки введите значение, которые нужно передать в заголовок страницы http(s) ресурса - например свой токен от GitLab для авторизации, чтобы скачать оттуда файл без ввода логина\пароля.
Пример (см. Рис. 1).
8. Нажмите кнопку “Сохранить” в нижней части формы.
9. Из меню действий запустите "Переконфигурировать".
10. После успешного выполнения действия, проверьте что необходимые файлы появились на хостах RT.WideStore и сам компонент ch перезапустился:
systemctl status clickhouse-server | grep ActiveВ конце строки должно быть время сколько прошло с запуска\рестарта компонента.
Есть список файлов исключений, которые не могут быть перезаписаны при помощи данного сервиса:
- /etc/clickhouse-client/config.xml
- /etc/clickhouse-server/auto_dictionary.xml
- /etc/clickhouse-server/config.xml
- /etc/clickhouse-server/users.xml
- /etc/clickhouse-server/config.d/clickhouse_remote_servers.xml
- /etc/clickhouse-server/config.d/macros.xml
- /etc/clickhouse-server/config.d/zookeeper-servers.xml
При попытке перезаписать файл из списка исключений будет сформировано сообщение об ошибке:
имя_файла - this is default config files. Don't replace it!Примечание:
Если вы хотите разместить на хосты файл из репозитория GitLab, то:
- Левое поле параметра “copy_from_url” будет иметь вид, как в следующем примере:
https://gitlab.example.com/api/v4/projects/:id/repository/files/:file_path/raw?ref=masterгде:
- https://gitlab.example.com/api/v4/ - ссылка до API вашего GitLab.
- :id - цифровой идентификатор или адрес (в URL-кодировке) проекта в GitLab (его можно посмотреть на главной странице проекта).
- :file_path - полный путь к файлу в URL-кодировке внутри проекта (например: app%2Fmodels%2Fconfig.cfg).
- ref=master - название ветки, из которой нужно скопировать файл (в данном случае - master).
2. В правом поле параметра “copy_from_url” укажите полный путь куда нужно скопировать файл на конечной машине кластера (например: /etc/myconfig.cfg).
3. В левом поле параметра “headers_url” указываем название ключа аутентификации (для GitLab это - PRIVATE-TOKEN).
4. В правом поле параметра “headers_url” указываем значение персонального токена для пользователя GitLab , у которого есть права на чтение и просмотр файлов репозитория. Его можно создать здесь - https://gitlab.example.com/-/user_settings/personal_access_tokens.