Состав поставки для установки через Ansible

Компоненты системы

КомпонентОписание
Zakroma-ArchiveОсновное пакет приложения Закрома.Архив.
KeycloakСистема управления аутентификацией и авторизацией (используется для Admin UI и доступа к Zakroma).
NginxProxy-сервер, выступающий в качестве фронтенда для Zakroma-Archive.
PostgreSQLСУБД для метаданных и Keycloak.
Kafka (опционально)Система обмена сообщениями, используемая сервисами Zakroma (требуется для различных служебных операций, опционально).
Kafka-UI
(опционально)
Интерфейс управления и мониторинга Kafka-кластером через веб-приложение.

Компоненты, устанавливаемые с помощью Ansible ролей

НазваниеПоддерживаемые версии
Zakroma-Archive1.4.0
Keycloak26
Nginxв зависимости от дистрибутива Linux
(устанавливается из стандартных репозиториев хостовой операционной системы)
Javaв зависимости от дистрибутива Linux
(устанавливается из стандартных репозиториев хостовой операционной системы)
Kafka3.8.1
Kafka-UI0.7.2

Поддерживаемые дистрибутивы Linux

НазваниеПоддерживаемые версии
Debian10, 11, 12
Ubuntu20, 22, 24
AlmaLinux8, 9
RedOs7, 8
RHEL8, 9
ALT Server10.4 (Mendelevium)

Структура дистрибутива

Дистрибутив поставляется архивом видаzakroma-roles-<ВЕРСИЯ_РЕЛИЗА_АРХИВА_С_ANSIBLE_РОЛЯМИ>.tar.gz

1. 2├── ansible.cfg 3├── CHANGELOG.md 4├── collections 5│   └── ansible_collections 6├── files 7│   └── realm.json 8├── inventories 9│   └── single-node 10│   ├── group_vars 11│   │   ├── certificates.yml 12│   │   ├── java.yml 13│   │   ├── kafka-ui-nginx.yml 14│   │   ├── kafka-ui.yml 15│   │   ├── kafka.yml 16│   │   ├── keycloak.yml 17│   │   ├── zakroma-archive.yml 18│   │   └── zakroma-storage-nginx.yml 19│   └── hosts 20├── playbooks 21│   ├── sample-play-copy-certificates.yml 22│   ├── sample-play-java.yml 23│   ├── sample-play-kafka-ui-nginx.yml 24│   ├── sample-play-kafka-ui.yml 25│   ├── sample-play-kafka.yml 26│   ├── sample-play-keycloak-copy-realm.yml 27│   ├── sample-play-keycloak.yml 28│   ├── sample-play-zakroma-archive.yml 29│   ├── sample-play-copy-licence-file.yaml 30│   └── sample-play-zakroma-storage-nginx.yml 31├── README.md 32└── roles

  • ansible.cfg
    Файл конфигурации Ansible, в котором задаются параметры работы (например, пути к инвентарям, настройки подключения, параметры логирования и т.д.).
  • CHANGELOG.md
    Журнал изменений проекта. Здесь фиксируются версии, внесённые правки, улучшения и исправления ошибок.
  • collections/
    Каталог, содержащий Ansible collections – наборы ролей, плагинов и модулей, объединённых в пакеты для удобного повторного использования и распространения.
  • files/realm.json
    JSON-файл, содержащий сконфигурированный REALM для Keycloak.
  • inventories/
    Каталог с инвентарями Ansible, разделёнными по различным сценариям развёртывания:
    • single-node/
      Инвентарь для развёртывания на одном узле:
      • group_vars/ – файлы с переменными для одиночного узла. Отличительной особенностью является наличие файла * zakroma-zds-fs.yml* (нижний слой хранения без Erasure Coding).
      • hosts – файл с описанием единственного узла.
  • playbooks/
    Каталог с playbook’ов, необходимых для применение ролей или выполнение конкретных задач:
    • sample-play-copy-licence-file.yaml – playbook для копирования файла лицензии.
    • sample-play-copy-certificates.yml – playbook для копирования сертификатов.
    • sample-play-java.yml – playbook для установки Java.
    • sample-play-kafka-ui-nginx.yml – playbook для установки и конфигурирования Nginx для Kafka-UI.
    • sample-play-kafka-ui.yml – playbook для установки и конфигурирования Kafka UI.
    • sample-play-kafka.yml – playbook для установки и конфигурирования Kafka.
    • sample-play-keycloak-copy-realm.yml – playbook для копирования realm-конфигурации в Keycloak.
    • sample-play-keycloak.yml – playbook для установки и конфигурирования Keycloak.
    • sample-play-zakroma-archive.yml – playbook для установки и конфигурирования Zakroma-Archive.
    • sample-play-zakroma-storage-nginx.yml – playbook для установки и конфигурирования Nginx для Zakroma-Storage.
    • sample-play-zakroma-storage.yml – playbook для установки и конфигурирования Zakroma-Storage.
    • sample-play-zakroma-zds-fs.yml – playbook для установки и конфигурирования Zakroma-ZDS в режиме FS (без Erasure Coding).
  • README.md
    Основной файл с описанием проекта, содержащий обзор, инструкции по установке, использованию и общую информацию о проекте.
  • roles/
    Каталог, где располагаются Ansible роли.