Управление плагинами OpenSearch
При создании кластера в Managed Service for OpenSearch вы можете указать желаемый список плагинов, и они будут автоматически установлены в кластер. Полный список доступных плагинов приведен в разделе Дополнительные плагины.
Получить список установленных плагинов
- В консоли управления
перейдите на страницу каталога и выберите сервис Managed Service for OpenSearch. - Нажмите на имя нужного кластера.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы получить список установленных плагинов, запросите информацию о кластере OpenSearch:
yc managed-opensearch cluster get <имя_или_идентификатор_кластера>
Список плагинов указан в параметре config.opensearch.plugins
.
Имя и идентификатор кластера можно запросить со списком кластеров в каталоге.
Чтобы получить список установленных плагинов, воспользуйтесь методом REST API get для ресурса Cluster или вызовом gRPC API ClusterService/Get и передайте в запросе идентификатор кластера в параметре clusterId
.
Включенные плагины будут перечислены в списке config.opensearch.plugins
.
Идентификатор кластера можно получить со списком кластеров в каталоге.
Изменить список установленных плагинов
- В консоли управления
перейдите на страницу каталога и выберите сервис Managed Service for OpenSearch. - Выберите кластер и нажмите кнопку
Редактировать на панели сверху. - В блоке Базовые параметры укажите плагины, которые должны быть установлены.
- Нажмите кнопку Сохранить.
Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.
По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name
или --folder-id
.
Чтобы изменить список установленных плагинов OpenSearch, выполните команду:
yc managed-opensearch cluster update <имя_или_идентификатор_кластера> \
--plugins <плагины>
В параметре --plugins
перечислите нужные плагины через запятую. Чтобы сохранить плагины, которые были установлены ранее, также укажите их параметре --plugins
.
Имя и идентификатор кластера можно запросить со списком кластеров в каталоге.
-
Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.
О том, как создать такой файл, см. в разделе Создание кластера.
Полный список доступных для изменения полей конфигурации кластера Managed Service for OpenSearch см. в документации провайдера Terraform
. -
Измените в описании кластера список плагинов для параметра
plugins
в блокеconfig
. Если такого параметра нет, добавьте его.resource "yandex_mdb_opensearch_cluster" "<имя_кластера>" { ... config { plugins = ["<список_имен_плагинов>"] ... } }
-
Проверьте корректность настроек.
-
В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.
-
Выполните команду:
terraform validate
Если в файлах конфигурации есть ошибки, Terraform на них укажет.
-
-
Подтвердите изменение ресурсов.
-
Выполните команду для просмотра планируемых изменений:
terraform plan
Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.
-
Если вас устраивают планируемые изменения, внесите их:
-
Выполните команду:
terraform apply
-
Подтвердите изменение ресурсов.
-
Дождитесь завершения операции.
-
-
Чтобы изменить список установленных плагинов, воспользуйтесь методом REST API update для ресурса Cluster или вызовом gRPC API ClusterService/Update и передайте в запросе:
-
Идентификатор кластера в параметре
clusterId
.Идентификатор кластера можно получить со списком кластеров в каталоге.
-
Список плагинов в параметре
configSpec.opensearchSpec.plugins
. Плагины, не указанные в списке, будут выключены.
Важно
Метод API переопределит все параметры изменяемого объекта, которые не были явно переданы в запросе, на значения по умолчанию. Чтобы избежать этого, перечислите настройки, которые вы хотите изменить, в параметре updateMask
(одной строкой через запятую).