Версионирование

Политика версионирования продукта

Picodata как программный продукт использует формат обозначения версий, основанный на семантике CalVer с отдельными элементами SemVer. Номер версии имеет следующий формат:

YY.MINOR.PATCH[-N-gHASH]

Пример:

25.5.1-1-g8065ebc2

где:

• YY — год выпуска версии
• MINOR — порядковый номер выпуска в году
• PATCH — порядковый номер исправления
• N — количество коммитов с последнего git-тега (для отладочных версий)
• HASH — хеш коммита (для отладочных версий)

Разработка новых функций и исправлений ведется в ветке master нашего Git-репозитория.

Мы придерживаемся следующего распорядка при разработке:

• Версия из двух чисел YY.MINOR определяет набор функций, запланированных на данную серию выпусков
• Версия из трех чисел YY.MINOR.PATCH описывает конкретный выпуск с исправлениями
• Версия в полном формате YY.MINOR.PATCH-N-gHASH описывает отладочную сборку на конкретном git-коммите

Текущая политика версионирования применяется с версии 24.1.

См. также:

• Gitlab — Changelog
• Gitlab — Tags

Версионирование инстансов и кластера

Версии отдельных инстансов Picodata в кластере могут различаться максимум на 1 минорное значение. Например, в кластере могут одновременно работать инстансы с Picodata 25.4 и 25.5. Если различие больше, то такие инстансы не смогут образовать единый кластер.

Версия Picodata

Для получения текущей версии исполняемого файла picodata, введите в терминале команду:

picodata --version

Команда вернёт информацию о версиях и типах сборки для Picodata и Tarantool. Пример вывода:

picodata 25.5.0-1906-gcb60b488d, static, debug
tarantool 2.11.5-323-g4a3879c19, RelWithDebInfo

См. также:

• Аргументы командной строки

Версия кластера

Версия кластера — это версия наиболее старого инстанса в кластере. Узнать версию кластера можно, подключившись к Picodata и введя следующий SQL-запрос:

SELECT * FROM _pico_property WHERE key='cluster_version';

Пример вывода:

+-----------------+------------------------+
| key             | value                  |
+==========================================+
| cluster_version | 25.5.0-1906-gcb60b488d |
+-----------------+------------------------+
(1 rows)

Отслеживать это значение полезно при обновлении Picodata: кластер перейдёт на новую версию только после того как все инстансы обновятся на неё.

См. также:

• Обновление кластера

Версия системного каталога

Системный каталог — совокупность системных таблиц кластера с префиксом _pico. Содержимое системного каталога определяет то, какие объекты доступны в СУБД.

Узнать версию системного каталога можно, подключившись к Picodata и введя следующий SQL-запрос:

SELECT * FROM _pico_property WHERE key='system_catalog_version';

Пример вывода:

+------------------------+--------+
| key                    | value  |
+=================================+
| system_catalog_version | 26.1.0 |
+------------------------+--------+
(1 rows)

Важно помнить:

• версия системного каталога — служебное значение, которое обычно не совпадает с версией кластера или основного продукта
• изменение версии системного каталога означает модификацию системных таблиц и схемы данных СУБД. Соответственно, инстансы с разной версией системного каталога не смогут объединиться в один кластер.