Примечания к релизам

В этом документе содержится хронологически упорядоченный список изменений, внесенных в Ansible Tarantool Enterprise. Формат журнала изменений основан на документе Keep a Changelog, а версионирование следует правилам Semantic Versioning.

ATE 2.0.0 – первый выпуск новой мажорной версии коллекции. Коллекция ориентирована только на Tarantool 3.x и продукты на его основе: поддержка Tarantool Cartridge и Tarantool 2.x из нее удалена и остается в версиях ATE 1.x.

По функциональности ATE 2.0.0 соответствует ATE 1.22.1 – все возможности и исправления, доступные в 1.22.1, есть и в 2.0.0. Изменения касаются того, как устроена коллекция и как с ней работать: структуры ролей и плейбуков, имен переменных и способа запуска сценариев. Основные изменения:

• для установки всех продуктов используется плейбук install.yml, для переключения лидера – плейбук switch_leader.yml;
• переменные cartridge_* переименованы в tarantool_*, подключение к хранилищу конфигурации задается двумя переменными вместо пяти;
• значения по умолчанию коллекции больше не перекрывают переменные из инвентаря;
• поддержка Tarantool Cartridge удалена, она остается в версиях ATE 1.x.

• Переменные cartridge_* переименованы в tarantool_*. Суффикс остается прежним, например cartridge_systemd_dir → tarantool_systemd_dir. Префикс cartridge_ остался от Tarantool Cartridge, при этом переменные с таким префиксом использовались и для развертывания Tarantool 3.x.

• Подключение к хранилищу конфигурации задается двумя переменными вместо пяти. Вместо tarantool_etcd_host, tarantool_etcd_port, tarantool_etcd_schema_definition, tarantool_etcd_endpoints и tarantool_etcd_prefix используются tarantool_config_storage_endpoints и tarantool_config_storage_prefix. Адрес хранилища теперь указывается одной строкой вида <схема>://<хост>:<порт>. Раньше адрес и префикс задавались пятью переменными, значения которых объединялись в одно. Учетные данные и параметры TLS также переименованы – полное соответствие старых и новых имен приведено в разделе Общие изменения инвентаря.

• Значения по умолчанию больше не перебивают переменные из инвентаря. Из коллекции удалены все playbooks/group_vars. Значения по умолчанию теперь задает роль prepare: она подготавливает их для всей коллекции и сохраняет в служебный словарь shared_facts. Раньше у group_vars был высокий приоритет, поэтому значения по умолчанию коллекции могли перекрыть переменные, заданные в инвентаре.

• Переработана система ролей. Роли разделены на продуктовые (cluster_manager, tcf, tcs, tqe, cdc, tdb_worker) и служебные (prepare, common, cluster_ops, tarantool_config, systemd и другие). Задачи служебной роли вызываются перечислением в списке <имя_роли>_actions, например:

   
  - name: Generate and send config to etcd  ansible.builtin.include_role:    name: tarantool.enterprise.tarantool_config  vars:    tarantool_config_actions:      - generate      - send

• Единая точка входа для установки – плейбук install.yml. Раньше для каждого продукта был свой плейбук установки (install_3_0.yml, tcm/install.yml, tcf/install.yml, cdc_install.yml и др.). Теперь все продукты устанавливаются и обновляются одним плейбуком install.yml. Прежние плейбуки установки будут удалены в следующих релизах (подробнее – в разделе Единая точка входа: install.yml).

• Единый плейбук для переключения лидера набора реплик – switch_leader.yml. Он сам определяет режим аварийного переключения (election или supervised) и выполняет переключение нужным способом. Раньше для этого использовались два плейбука: promote_leader.yml и tt_failover_switch.yml. Теперь они являются обертками над switch_leader.yml и выводят предупреждение об устаревании.

• Новые имена плейбуков для Tarantool 3.x. Плейбуки с суффиксом _3_0 и _3x заменены плейбуками без суффикса:

  Плейбук 1.x	Плейбук 2.x
  etcd_3_0.yml	configure.yml
  check_3_0.yml	check.yml
  set_force_recovery_3x.yml	set_force_recovery.yml

• Переменная ate_instance_type – тип экземпляра, который коллекция разворачивает. По этому типу install.yml определяет, какой продукт устанавливать на хост. Возможные значения: tarantool (по умолчанию), tcm, tqe-grpc, tcs-scheduler, tcf-gateway, tcf-destination, cdc. Генератор инвентаря задает переменную автоматически по секции components. В статическом инвентаре ее нужно указать вручную для всех экземпляров, кроме экземпляров Tarantool.

• Описаны все плейбуки, роли и переменные коллекции, а также добавлена инструкция по миграции с ATE 1.x.

• Поддержка Tarantool Cartridge и Tarantool 2.x. Удалены роль cartridge и плейбуки для Cartridge и Tarantool 2.x. Для управления такими кластерами продолжайте использовать ATE 1.x.
• Переменные tarantool_etcd_host, tarantool_etcd_port, tarantool_etcd_schema_definition, tarantool_etcd_endpoints, tarantool_etcd_prefix – вместо них используются tarantool_config_storage_endpoints и tarantool_config_storage_prefix.
• Переменная tarantool_3_0_version_support.
• Каталог playbooks/group_vars.