name: akhq service_id: 119 service_display_name: Akhq service_short_name: Akhq service_man: '# Инструкция по развертыванию Apache Kafka через платформу

---
## 1. Общая информация
AKHQ — это веб-интерфейс для работы с кластерами Apache Kafka.
Позволяет просматривать топики, consumer group''ы, сообщения, ACL, схему безопасности, состояние брокеров и метаданные.
Поддерживает работу с несколькими кластерами Kafka одновременно, включая внутренние и внешние (TLS) подключения.

## Доступные операции
- **create** — Создание ресурса AKHQ
- **suspend** — Остановка ресурса
- **resume** — Возобновление работы ресурса
- **modify** — Модификация настроек
- **delete** — Удаление ресурса

---
## 2. Параметры развертывания кластера
Ниже перечислены параметры, которые необходимо указать при создании ресурса Kafka:

* **Кластер Kafka к которому нужно настроить подключение**
Для использования AKHQ необходимо предварительно развернуть сервис Kafka. Пример: `kafka-external`.

* **Платформа для развертывания:**
Платформа для развертывания (среда, в которой будет развернут кластер). Пример: `k8s-3.ext.nubes.ru`.

* **Количество узлов в сети:**
Количество узлов для работы Akhq. Пример `2`

* **Квота (megabyte) памяти пода:**
Квота памяти пода в мегабайтах. Пример: `512`

* **Квота (millicore ) ядра пода:**
Квота CPU пода в миликорах (1000 mCPU = 1 vCPU). Пример: `500`

* **Имя домена:**
Dns Имя по которому будет происходить обращение к сервису. Указать необходимо уникальное имя до . ( то есть если необходимо получить dns ui) Пример: `kafka-external`

---
## 4. Выходные параметры
После успешного развертывания ресурса Kafka платформа возвращает ряд параметров.
Ключевым из них является:

**connectionUrl**
Это полное доменное имя (FQDN), по которому будет доступен интерфейс AKHQ. После развёртывания подождите несколько минут — UI станет доступен по HTTPS, как только все сервисы полностью запустятся.

**Учетные данные**
Здесь представлены поля для ввода логина и пароля, с помощью которых вы сможете авторизоваться в сервисе.

---
## 5. Дополнительная информация
Учётные записи, созданные для работы с AKHQ, предоставляют доступ только для просмотра данных. Для управления Kafka, пожалуйста, используйте возможности личного кабинета.
---' lifecycle: suspendOnDestroyDefault: true adoptExistingOnCreateDefault: false operations: - svcOperationId: 175 operation: create kind: instance action: create - svcOperationId: 176 operation: delete kind: instance action: delete - svcOperationId: 180 operation: modify kind: instance action: modify - svcOperationId: 178 operation: resume kind: instance action: resume - svcOperationId: 177 operation: suspend kind: instance action: suspend stateOut: {} cfsParams: - svcOperationCfsParamId: 550 svcOperationCfsParam: resourceRealm dataType: string isRequired: true defaultValue: '' isModifiable: false valueList: - iot-naeel - k8s-3-sandbox-nubes-ru - k8s-4-sandbox-nubes-ru - naeel-test-3 - svcOperationCfsParamId: 551 svcOperationCfsParam: resourceMemory dataType: integer > 0 isRequired: true defaultValue: '512' isModifiable: false - svcOperationCfsParamId: 552 svcOperationCfsParam: resourceCPU dataType: integer > 0 isRequired: true defaultValue: '500' isModifiable: false - svcOperationCfsParamId: 553 svcOperationCfsParam: domain dataType: string isRequired: true defaultValue: '' isModifiable: false - svcOperationCfsParamId: 554 svcOperationCfsParam: resourceInstances dataType: integer > 0 isRequired: true defaultValue: '1' isModifiable: false - svcOperationCfsParamId: 555 svcOperationCfsParam: kafkaUid dataType: uuid isRequired: true defaultValue: '' isModifiable: true - svcOperationCfsParamId: 565 svcOperationCfsParam: kafkaUid dataType: uuid isRequired: true defaultValue: '' isModifiable: true cfsParamsByOp: 175: - 550 - 551 - 552 - 553 - 554 - 555 176: [] 180: - 565 178: [] 177: [] stateParams: resourceRealm: '' resourceMemory: '512' resourceCPU: '500' domain: '' resourceInstances: '1' kafkaUid: ''