Кластерные действия

Антон Васильев

Статья описывает действия, которые можно выполнять с кластером ADB ES в пользовательском интерфейсе ADCM.

Обзор

Управление кластером ADB ES осуществляется на странице Clusters.

Страница Clusters
Страница Clusters

Описание страницы Clusters и общих действий на этой странице приведено в документации ADCM.

В столбце Actions показываются иконки для управления кластером:

  • Иконка Actions Иконка Actions — открывает список действий, доступных для работы с кластером.

    Открытие списка кластерных действий ADB ES
    Открытие списка доступных действий

  • Иконка Upgrade — указывает, доступна ли новая версия бандла, и позволяет запустить обновление кластера до новой версии.

  • Иконка Delete — удаляет информацию о кластере из ADCM (не удаляет ADB ES и не производит никаких изменений на хостах, относящихся к кластеру).

ВАЖНО

При обновлении ADB ES важно учесть следующий порядок:

  1. Обновление кластера ADB ES.

  2. Обновление агентов на стороне ADB (см. сервисное действие Reinstall для ADBC agents и ADBM agents).

Набор кластерных действий (доступных при нажатии иконки Иконка Actions Иконка Actions) определяется текущим статусом кластера ADB ES.

Доступные действия в зависимости от статуса ADB ES
Статус Условие Доступные действия

created

Кластер ADB ES создан в ADCM, но еще не установлен

installed

Кластер ADB ES успешно установлен в ADCM

ready to upgrade

Проведена подготовка кластера ADB ES к обновлению. Данный статус доступен после нажатия на иконку Иконка Upgrade и до запуска кластерного действия Upgrade

Действия Precheck и Install описаны в статье Установка кластера. Действия, доступные для уже установленного кластера, приведены ниже.

Check

Действие Check проверяет соответствие настроек хостов, сервисов и компонентов требованиям кластера ADB ES (аналогично действию Precheck). Кроме того, действие проверяет статус каждого из компонентов ADB ES.

Reconfigure Vault integration

Действие Reconfigure Vault integration предназначено для применения изменений к параметрам Vault configuration, редактирование которых доступно на вкладке Configuration на странице кластера. Эти параметры определяют необходимость хранения секретов сервисов ADB ES в HashiCorp Vault.

ВАЖНО

  • Включить переключатель Vault configuration и настроить Vault можно только после установки кластера. Пока кластер находится в состоянии created, секция Vault configuration недоступна для изменения.

  • Перед вводом интеграционных параметров убедитесь, что Vault предварительно установлен и сконфигурирован.

  • После каждого изменения и сохранения значений параметров из секции Vault configuration необходимо запускать кластерное действие Reconfigure Vault integration.

  • В настоящий момент Vault может использоваться для хранения параметров аутентификации сервисов ADB Control и ADBM.

  • При необходимости сохранения в Vault учетных данных для баз данных ADB Control Query DB и Metrics DB эти базы должны быть настроены как внешние.

Manage SSL

Настраивает и включает SSL для всего кластера ADB ES. В открывшемся окне выберите SSL configuration для включения SSL и настройте параметры, описанные ниже.

ВАЖНО

После включения и выключения SSL в ADB ES требуется выполнить действие Reconfigure and restart на стороне сервисов ADBC agents и ADBM agents в кластерах ADB, связанных с текущим ADB ES.
Параметр Описание

Verify system endpoints' certificates

Включает проверку сертификатов системных эндпойнтов. Перед использованием опции с самоподписанными (self-signed) сертификатами убедитесь, что в хранилище доверенных корневых сертификатов ОС добавлены корневой и промежуточные CA-сертификаты. Чтобы использовать опцию Verify system endpoints' certificates с вашими собственными сертификатами, для успешной верификации добавьте IP-адрес ADB Control в поле CN файла san.cnf (SAN), а также исключите DNS из секции alt_names (оставив только IP-адрес)

Postgres server certificate path

Путь к файлу сертификата PostgreSQL (в формате PEM). Требуемые права доступа к файлу: 640, владелец и группа: postgres:postgres. Поле доступно, если используется внутренний тип СУБД в сервисе Database

Postgres server private key path

Путь к файлу закрытого ключа PostgreSQL (в формате PEM). Требуемые права доступа к файлу: 600, владелец и группа: postgres:postgres. Поле доступно, если используется внутренний тип СУБД в сервисе Database

clickhouse ca certificate path

Путь к корневому сертификату CA для ClickHouse (в формате PEM). Требуемые права доступа к файлу: 640, владелец и группа: clickhouse:clickhouse. Поле доступно, если используется внутренний тип СУБД в сервисе Clickhouse

clickhouse server certificate path

Путь к файлу серверного сертификата ClickHouse (в формате PEM). Требуемые права доступа к файлу: 640, владелец и группа: clickhouse:clickhouse. Поле доступно, если используется внутренний тип СУБД в сервисе Clickhouse

clickhouse server private key path

Путь к файлу закрытого ключа сервера ClickHouse (в формате PEM). Требуемые права доступа к файлу: 600, владелец и группа: clickhouse:clickhouse. Поле доступно, если используется внутренний тип СУБД в сервисе Clickhouse

Server truststore path

Путь к truststore-файлу для серверных Java-компонентов: ADB Control, ADBM и AD Eureka. Формат: PKCS #12. Требуемые владелец и группа: adcc:adbes.

Если ADBM установлен на отдельном хосте, то требуемые владелец и группа его truststore-файла: adbm:adbes.

Server truststore password

Пароль, установленный для серверного truststore-файла, указанного в Server truststore path

Server keystore path

Путь к keystore-файлу для серверных Java-компонентов: ADB Control, ADBM и AD Eureka. Формат: PKCS #12. Требуемые владелец и группа: adcc:adbes.

Если ADBM установлен на отдельном хосте, то требуемые владелец и группа его keystore-файла: adbm:adbes.

Server keystore password

Пароль, установленный для серверного keystore-файла, указанного в Server keystore path

Agent truststore path

Путь к truststore-файлу для агентов ADBC/ADBM (на хостах ADB). Формат: PKCS #12. Требуемые владелец и группа: gpadmin:gpadmin

Agent truststore password

Пароль, установленный для truststore-файла агентов, указанного в Agent truststore path

Agents keystore path

Путь к keystore-файлу для агентов. Формат: PKCS #12. Требуемые владелец и группа: gpadmin:gpadmin

Agents keystore password

Пароль, установленный для keystore-файла агентов, указанного в Agents keystore path
ПРИМЕЧАНИЕ

Во время установки ADB ES бандл автоматически создает группу adbes на всех хостах ADB ES и добавляет в нее пользователей adcc и adbm. По умолчанию идентификатор группы — 3033; его можно изменить с помощью параметра ADB ES group GID в конфигурации кластера.
Окно Manage SSL
Окно Manage SSL

Требования к сертификатам

При создании сертификатов необходимо учитывать следующие требования:

  • Если ADB Control, ADBM и AD Eureka установлены на разных хостах, абсолютные пути к файлам keystore и truststore должны быть одинаковыми на всех хостах. Эти пути указываются в параметрах Server keystore path и Server truststore path.

  • Владельцы файлов (перечисленные в таблице выше) должны иметь права на чтение каждой директории в пути к этим файлам.

  • Действие Manage SSL не применяется к внешним базам данных. При их использовании импортируйте сертификаты внешних БД в truststore, указанный в Server truststore path.

Проверка результатов

После успешного выполнения действия Manage SSL компоненты ADB ES начинают взаимодействовать по SSL. Веб-серверы потребуют подключения по TLS, поэтому для доступа к веб-интерфейсам сервисов используйте https при вводе адреса:

  • ADB Control: https://<IP-адрес компонента ADB Control UI>:8890

  • AD Eureka: https://<IP-адрес AD Eureka>:8761

  • Clickhouse: https://<IP-адрес Clickhouse>:8443 (при отключенном SSL используется порт 8123)

Также можно проверить использование TLS в PostgreSQL. Например, для внутренних баз данных ADPG подключитесь к adcc или adbm:

$ sudo su - postgres
$ psql -p 5433 -d adcc

В результате будет отображена версия TLS, подтверждающая использование зашифрованного соединения между базой данных и клиентами:

psql (16.3)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off)
Type "help" for help.

adcc=#

Reinstall

Действие Reinstall переустанавливает кластер ADB ES.

Reinstall statuschecker

Действие Reinstall statuschecker перенастраивает и перезапускает службу проверки состояния (statuschecker) для всех сервисов кластера. Используется в случае миграции кластера под управление нового сервера ADCM.

Start

Действие Start запускает все сервисы кластера ADB ES.

При выборе этого действия в открывшемся окне доступен флаг Apply services configs from ADCM. Выберите его, если требуется применить все изменения в конфигурациях сервисов. В противном случае сервисы будут запущены без применения текущих изменений.

Окно Start
Окно Start

Stop

Действие Stop останавливает все сервисы кластера ADB ES.

Upgrade

Описание действия см. в разделе Обновление ADB ES.

Нашли ошибку? Выделите текст и нажмите Ctrl+Enter чтобы сообщить о ней