## Список изменений (changelog)

Все значимые изменения будут задокументированы в этом файле.

Формат основан на [Keep a Changelog](https://keepachangelog.com/ru/1.0.0/),  
а проект следует [Семантическому Версионированию](https://semver.org/lang/ru/).

## [4.2.0] - 2025-09-12

### Добавлено
- Поддержка Zakroma-Storage версии **2.6.0**
- Поддержка Zakroma-ZDS версии **1.6.2**
- Поддержка авторизации на базе LDAP и с локальными пользователями.
- Плейбук для копирования лицензии на целевые хосты

---

## [4.1.0] - 2025-08-29

### Исправлено
- Ошибки при включении обработки background задач через Kafka

---

## [4.0.1] - 2025-08-13

### Исправлено
-  Ошибки при запуске плейбуков на RedOS 7

---

## [4.0.0] - 2025-08-04

### Добавлено
- Поддержка Keycloak **26** версии

### Удалено
- Поддержка Keycloak **22** версии

---

## [3.5.4] - 2025-08-04

### Добавлено
- Поддержка Zakroma-Storage версии **2.5.4**

---

## [3.5.3] - 2025-07-25

### Добавлено
- Поддержка Zakroma-ZDS версии **1.6.1**

---

## [3.5.2] - 2025-07-10

### Добавлено
- Поддержка Zakroma-Storage версии **2.5.3**

---

## [3.5.1] - 2025-07-07

### Добавлено
- Поддержка Zakroma-Storage версии **2.5.2**
- Поддержка Zakroma-ZDS версии **1.6.0**

---

## [3.5.0] - 2025-07-07

### Добавлено
- Поддержка TLS при подключении к брокерам Kafka
- Поддержка SCRAM-SHA-256/SCRAM-SHA-512 при подключении к брокерам Kafka

---

## [3.4.1] - 2025-06-16

### Добавлено
- Поддержка Zakroma-Storage версии **2.5.1**

---

## [3.4.0] - 2025-06-09

### Добавлено
- Поддержка Zakroma-Storage версии **2.5.0**

---

## [3.3.0] - 2025-05-20

### Добавлено
- Добавлена поддержка ALT Server 10.4 (Mendelevium)

---

## [3.2.2] - 2025-05-14

### Добавлено
- Поддержка Zakroma-ZDS версии **1.5.1** 

---

## [3.2.1] - 2025-04-24

### Добавлено
- Поддержка Zakroma-ZDS версии **1.5.0** - явное указание интерфейса для межнодового взаимодействия ZDS

---


## [3.2.0] - 2025-04-15

### Добавлено
- Поддержка Zakroma-Storage версии **2.4.3**

---

## [3.1.0] - 2025-03-31

### Добавлено
- Добавлены роли для установки и конфигурирования Java, Kafka и Kafka-UI

### Изменено
- Изменение стуктуры файлов с документацией (README.md, docs/README.base-cluster.md, docs/README.multicluster.md, docs/README.prepare.md, docs/README.single-node.md)
- Новая директория playbooks для плейбуков ansible

---

## [3.0.3] - 2025-03-26

### Изменено
- Изменение в роли zakroma-storage (Добавление переменной для явного указания порта для cdn сервиса)  

---

## [3.0.2] - 2025-03-25

### Добавлено
- Поддержка Zakroma-Storage версии **2.4.2**

---

## [3.0.1] - 2025-03-19

### Добавлено
- Поддержка Zakroma-Storage версии **2.4.1**
- Поддержка Zakroma-ZDS версии **1.5.0**

---

## [3.0.0] - 2025-03-17

### Добавлено
- Архив дистрибутива Ansible-ролей `zakroma-roles-<VERSION>.tar.gz` со следующей структурой:
  - `roles/` — основные Ansible-роли для сервисов Zakroma.
  - `collections/` — дополнительные коллекции Ansible.
  - `inventories/` — примеры инвентарей для развертывания Single Node, Base Cluster и Multicluster.
  - `sample-play-*.yml` — примерные плейбуки для развёртывания и конфигурирования сервисов.
  - `docs/` — инструкции по развертыванию (Single Node, Base Cluster, Multicluster).

- Документация:
  - `README.single-node.md` — инструкция по установке односерверной инсталляции.
  - `README.base-cluster.md` — инструкция по установке базового кластера.
  - `README.multicluster.md` — инструкция по установке мультикластера.
  - `README.prepare.md` — руководство по предварительной подготовке окружения.

- Инструкция по подготовке окружения:
  - Отключение SELinux.
  - Настройка DNS-записей для базового и мультикластерного окружения.
  - Генерация и подготовка сертификатов TLS/SSL.
  - Требования к PostgreSQL и ссылка на официальную инструкцию по его настройке.
  - Требования к установке и настройке Keycloak, включая установку Java 17+.
  - Рекомендации по подготовке дисков и точек монтирования для Zakroma-ZDS.
  - Требования к версии Ansible (не ниже 2.15.0).

- Описание требований к Kafka:
  - Конфигурация топиков для базового кластера и мультикластера Zakroma.
  - Минимальные параметры топиков:
    - Количество партиций (8 или 16).
    - replication-factor (минимум 2).
    - retention.ms (604800000 мс, 7 дней).
    - cleanup.policy (delete).
    - min.insync.replicas (2).
  - Назначение топиков и взаимодействие между кластерами.

### Изменено
- Отсутствует.  
  (Первый релиз проекта).

### Исправлено
- Отсутствует.  
  (Первый релиз проекта).

Изменения в архиве поставки

Changelog

BareMetal/VMs


## Таблица соответствия архива поставки с версиями ПО

| Версия архива с Ansible ролями                                                                                          | Zakroma-Storage | Zakroma-ZDS | Kafka | Kafka-UI | Keycloak |     |
| ----------------------------------------------------------------------------------------------------------------------- | --------------- | ----------- | ----- | -------- | -------- | --- |
| [4.2.0](https://zakroma.ru/knowledgeBase/devops/article/installation-options-4-2-0\?version=Закрома.Хранение) | 2.6.0           | 1.6.2       | 3.8.1 | 0.7.2    | 26.3.2   |     |
| [4.1.0](https://zakroma.ru/knowledgeBase/devops/article/installation-options-4-1-0\?version=Закрома.Хранение) | 2.5.4           | 1.6.1       | 3.8.1 | 0.7.2    | 26.3.2   |     |
| [4.0.1](https://zakroma.ru/knowledgeBase/devops/article/installation-options-4-0-1\?version=Закрома.Хранение) | 2.5.4           | 1.6.1       | 3.8.1 | 0.7.2    | 26.3.2   |     |
