Связаться с намиПодключиться

Управление хостами

Статья создана
Обновлена 17 октября 2024 г.

Важно

Сервис Yandex Managed Service for Elasticsearch недоступен с 11 апреля 2024 года.

Вы можете создать кластер OpenSearch в Yandex Cloud в качестве альтернативы Elasticsearch.

Вы можете получить список хостов в кластере Elasticsearch, а также добавлять и удалять хосты кластера. О том, как перенести хосты кластера в другую зону доступности, читайте в инструкции.

Примечание

Вы можете добавлять и удалять только хосты с ролью Data node.

Получить список хостов в кластере

  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for Elasticsearch.
  2. Нажмите на имя нужного кластера, затем выберите вкладку Хосты.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы получить список хостов в кластере, выполните команду:

yc managed-elasticsearch host list --cluster-name <имя_кластера>

Имя кластера можно запросить со списком кластеров в каталоге.

Чтобы получить список хостов в кластере, воспользуйтесь методом REST API listHosts для ресурса Cluster или вызовом gRPC API ClusterService/ListHosts и передайте в запросе идентификатор кластера в параметре clusterId.

Идентификатор кластера можно получить со списком кластеров в каталоге.

Добавить хосты в кластер

Важно

Включить публичный доступ к хосту после его создания невозможно.

  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for Elasticsearch.

  2. Нажмите на имя нужного кластера, затем выберите вкладку Хосты.

  3. Нажмите кнопку Создать хост.

  4. Укажите параметры хоста:

    • Зону доступности.
    • Подсеть (если нужной подсети в списке нет, создайте ее).
    • Выберите опцию Публичный доступ, если хост должен быть доступен извне Yandex Cloud. Эту настройку нельзя изменить после создания хоста.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы добавить хосты в кластер, выполните команду:

yc managed-elasticsearch host add \
   --cluster-name <имя_кластера> \
   --host zone-id=<зона_доступности>,`
          `subnet-name=<имя_подсети>,`
          `assign-public-ip=<публичный_доступ>,`
          `type=<роль_хоста>

Где:

  • assign-public-ip — публичный доступ к хосту: true или false.
  • type — роль хоста: datanode или masternode.

Имя кластера можно запросить со списком кластеров в каталоге.

Чтобы добавить хост в кластере:

  1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

    О том, как создать такой файл, см. в разделе Создание кластера.

    Полный список доступных для изменения полей конфигурации кластера Managed Service for Elasticsearch см. в документации провайдера Terraform.

  2. Добавьте к описанию кластера Managed Service for Elasticsearch блок host.

    resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" {
  ...
  host {
    name             = "<имя_хоста>"
    zone             = "<зона_доступности>"
    type             = "<роль_хоста>"
    assign_public_ip = <публичный_доступ>
    subnet_id        = "<идентификатор_подсети>"
  }
}

    Где:

    • type — роль хоста: DATA_NODE или MASTER_NODE.
    • assign_public_ip — публичный доступ к хосту: true или false.

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

    2. Выполните команду:

      terraform validate

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  4. Подтвердите изменение ресурсов.

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

    Ограничения по времени

    Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for Elasticsearch:

    • создание, в т. ч. путем восстановления из резервной копии, — 30 минут;
    • изменение — 60 минут;
    • удаление — 15 минут.

    Операции, длящиеся дольше указанного времени, прерываются.

    Как изменить эти ограничения?

    Добавьте к описанию кластера блок timeouts, например:

    resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" {
  ...
  timeouts {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Чтобы добавить хосты в кластер, воспользуйтесь методом REST API addHosts для ресурса Cluster или вызовом gRPC API ClusterService/AddHosts и передайте в запросе:

  • Идентификатор кластера в параметре clusterId.

    Идентификатор кластера можно получить со списком кластеров в каталоге.

  • Настройки нового хоста в одном или нескольких параметрах hostSpecs.

Важно

Если после добавления хоста к нему невозможно подключиться, убедитесь, что группа безопасности кластера настроена корректно для подсети, в которую помещен хост.

Удалить хосты из кластера

При удалении хостов действуют ограничения:

  • Нельзя удалить единственный хост с ролью Data node.
  • Для кластеров, состоящих из нескольких хостов с ролью Data node, нельзя удалить последние два хоста.
  1. В консоли управления перейдите на страницу каталога и выберите сервис Managed Service for Elasticsearch.
  2. Нажмите на имя нужного кластера, затем выберите вкладку Хосты.
  3. Нажмите на значок в строке нужного хоста и выберите пункт Удалить.

Если у вас еще нет интерфейса командной строки Yandex Cloud, установите и инициализируйте его.

По умолчанию используется каталог, указанный в профиле CLI. Вы можете указать другой каталог с помощью параметра --folder-name или --folder-id.

Чтобы удалить хост из кластера, выполните команду:

yc managed-elasticsearch host delete <имя_хоста> --cluster-name <имя_кластера>

Имя хоста можно запросить со списком хостов в кластере, имя кластера — со списком кластеров в каталоге.

Чтобы удалить хост из кластера:

  1. Откройте актуальный конфигурационный файл Terraform с планом инфраструктуры.

    О том, как создать такой файл, см. в разделе Создание кластера.

    Полный список доступных для изменения полей конфигурации кластера Managed Service for Elasticsearch см. в документации провайдера Terraform.

  2. Удалите из описания кластера Managed Service for Elasticsearch блок host, соответствующий удаляемому хосту.

  3. Проверьте корректность настроек.

    1. В командной строке перейдите в каталог, в котором расположены актуальные конфигурационные файлы Terraform с планом инфраструктуры.

    2. Выполните команду:

      terraform validate

      Если в файлах конфигурации есть ошибки, Terraform на них укажет.

  4. Подтвердите удаление ресурсов.

    1. Выполните команду для просмотра планируемых изменений:

      terraform plan

      Если конфигурации ресурсов описаны верно, в терминале отобразится список изменяемых ресурсов и их параметров. Это проверочный этап: ресурсы не будут изменены.

    2. Если вас устраивают планируемые изменения, внесите их:

      1. Выполните команду:

        terraform apply

      2. Подтвердите изменение ресурсов.

      3. Дождитесь завершения операции.

    Ограничения по времени

    Провайдер Terraform ограничивает время на выполнение операций с кластером Managed Service for Elasticsearch:

    • создание, в т. ч. путем восстановления из резервной копии, — 30 минут;
    • изменение — 60 минут;
    • удаление — 15 минут.

    Операции, длящиеся дольше указанного времени, прерываются.

    Как изменить эти ограничения?

    Добавьте к описанию кластера блок timeouts, например:

    resource "yandex_mdb_elasticsearch_cluster" "<имя_кластера>" {
  ...
  timeouts {
    create = "1h30m" # Полтора часа
    update = "2h"    # 2 часа
    delete = "30m"   # 30 минут
  }
}

Чтобы удалить хост, воспользуйтесь методом REST API deleteHosts для ресурса Cluster или вызовом gRPC API ClusterService/DeleteHosts и передайте в запросе:

  • Идентификатор кластера в параметре clusterId.

    Идентификатор кластера можно получить со списком кластеров в каталоге.

  • Имя или массив имен удаляемых хостов в параметре hostNames.

Предыдущая
Остановка и запуск кластера
Следующая
Миграция хостов в другую зону доступности