--- metadata: - name: generator content: Diplodoc Platform v5.50.6 - property: og:title content: Установка пользовательской версии CHYT - property: og:description content: Статья содержит информацию о версиях CHYT, о том, в каких случаях устанавливают отличные от дефолтной версии, и инструкцию, как это сделать. - property: og:type content: article - property: og:url content: https://ytsaurus.tech/docs/ru/user-guide/data-processing/chyt/how-to-guides/custom-chyt-version - property: article:tag content: clique-instruction - property: article:modified_time content: '2026-05-27T20:00:00+03:00' - property: article:author content: Татьяна Андриянова alternate: - https://ytsaurus.tech/docs/en/user-guide/data-processing/chyt/how-to-guides/custom-chyt-version.md - https://ytsaurus.tech/docs/ru/user-guide/data-processing/chyt/how-to-guides/custom-chyt-version.md --- > **Documentation Index:** Fetch the complete configuration index at https://ytsaurus.tech/docs/ru/llms.txt # Установка пользовательской версии CHYT По умолчанию при запуске клики автоматически устанавливается последняя стабильная версия CHYT. Но вы можете вручную зафиксировать другую необходимую версию — это позволит контролировать обновления и избежать проблем с совместимостью и стабильностью. В этом разделе вы найдёте информацию о том, в каких ситуациях важно указывать версию вручную, где найти список доступных версий и как указать пользовательскую версию. ## Когда стоит указывать версию вручную { #manual } Иногда автоматическая установка последней стабильной версии не подходит, и тогда необходимо самостоятельно выбрать версию CHYT. Ниже перечислены возможные причины таких ситуаций: 1. Совместимость. Некоторые интеграции или сервисы работают только с конкретной версией CHYT. Если не зафиксировать версию, при обновлении они могут работать некорректно (например, при изменении формата обработки JSON). 1. Правила обновления. ПО в организациях часто обновляется только после проверки (аудита) и в заранее оговорённые периоды (вне пиковых нагрузок). 1. Тестирование. Можно создать отдельную клику с новой версией CHYT, чтобы проверить функциональность без риска для рабочих процессов или сравнить результаты со старой версией и не затронуть при этом работу сервиса. ## Формат версии CHYT { #schema } Версия CHYT имеет формат: `ytserver-clickhouse-2.17.16028654~22a615876d+sb`, где: - `2.17` — базовая версия; - `16028654~22a615876d+sb` — идентификатор обновления. ## Где посмотреть доступные версии CHYT { #versions } Все доступные версии CHYT хранятся в бинарных файлах в [Кипарисе](https://ytsaurus.tech/docs/ru/overview/about.md#cypress) ы по адресу `//sys/bin/ytserver-clickhouse`. Помимо бинарных файлов со сборками CHYT, директория содержит симлинки (файлы, которые хранят ссылки на бинарные файлы) для *последней стабильной* и *последней базовой* версии. ## Варианты указания версий CHYT { #types } От выбранного варианта зависит, как будет происходить обновление версии. Доступно три подхода: 1. При строгом указании версии — например, `ytserver-clickhouse-2.17.16028654~22a615876d+sb` — обновление полностью отключено. Это полезно, если нужна абсолютная стабильность и предсказуемость работы системы. 1. При нестрогом указании версии — например, только её базовой части `ytserver-clickhouse-2.17` — система будет обновлять версию в пределах версии `2.17`. Подходит, если допустимо получать мелкие исправления, но важно избежать крупных изменений. 1. Если версия не указана, система при запуске клики установит последнюю стабильную версию CHYT. Этот способ удобен для тестовых сред или систем, где не критична стабильность. {% note warning %} Обновление до более высокой стабильной версии происходит только при перезапуске клики. Это касается клик без указания версии и клик с указанной базовой версией. Пример. Новая клика запущена без указания точной версии. Система автоматически установила последнюю стабильную версию CHYT `2.17.some_id`. Клика работает непрерывно, при выходе нового обновления `2.17.some_new_id` или новой базовой версии CHYT `2.18.yet_another_id` автоматическое обновление не происходит. Только после перезапуска клики версия автоматически обновится до новой стабильной версии `2.17.some_new_id` или `2.18.yet_another_id`. {% endnote %} ## Как установить пользовательскую версию { #instruction } 1. Перейдите в Кипарис по пути `//sys/bin/ytserver-clickhouse`. 1. В списке доступных версий выберите нужную версию CHYT или симлинку. 1. Скопируйте название версии (например, `ytserver-clickhouse-2.17`). 1. Откройте интерфейс клики, как описано в разделе [Как перейти в интерфейс клики](https://ytsaurus.tech/docs/ru/user-guide/data-processing/chyt/cliques/ui.md#where). 1. Нажмите ![edit speclet](../../../../../images/edit-btn.png){width=24 height=24} в правом верхнем углу, в блоке [Кнопки действий](https://ytsaurus.tech/docs/ru/user-guide/data-processing/chyt/cliques/ui.md#ui), или кнопку **Edit speclet** на вкладке **Speclet** на [Панели вкладок](https://ytsaurus.tech/docs/ru/user-guide/data-processing/chyt/cliques/ui.md#ui). 1. Слева выберите раздел **Advanced**. 1. В поле *Chyt version* вставьте скопированное название версии (например, `ytserver-clickhouse-2.17`). Полезные ссылки: [Веб-интерфейс клики в YTsaurus](https://ytsaurus.tech/docs/ru/user-guide/data-processing/chyt/cliques/ui.md) [Получение версий CHYT и ClickHouse](https://ytsaurus.tech/docs/ru/user-guide/data-processing/chyt/how-to-guides/versions.md)