Skip to main content

Подготовка к обновлению Elasticsearch в GitHub Enterprise Server 3.13

В рамках обновления GitHub Enterprise Server до версии 3.13 или более поздней, служба Elasticsearch будет обновлена.

Обзор

Elasticsearch (ES) позволяет выполнять поиск в экземпляре GitHub Enterprise Server. Чтобы повысить производительность и безопасность, при обновлении экземпляра до версии 3.13 или более поздней, версия Elasticsearch на устройстве будет обновлена с 5.6.16 до 8.7.0.

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

  • Обновление временно ухудшает работу функций журнала поиска и аудита.
  • При обновлении экземпляра в конфигурации кластера необходимо запустить скрипт для подготовки кластера к обновлению ES. См. раздел "Обновление кластера".
  • Для резервного копирования все клиенты должны создать моментальный снимок экземпляра после завершения обновления.

Влияние на журналы поиска и аудита

Все индексы поиска будут перестроены после обновления до ES8. Во время перестроения пользователи будут испытывать ухудшение работы поиска, но в противном случае экземпляр будет функциональным и доступным. Процесс перестроения индекса зависит от размера набора данных и может занять несколько часов до дней.

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

Настоятельно рекомендуется выполнить резервное копирование (с помощью резервных копий) сразу после завершения перестроения индекса и использовать этот моментальный снимок для всех будущих восстановления. См. раздел "Настройка резервных копий в экземпляре". При восстановлении резервной копии из экземпляра, на котором выполняется GitHub Enterprise Server 3.11 или 3.12, все содержимое, использующее ES, будет доступно только после переноса и перестроения индексов ES на экземпляре 3.13.

Мониторинг обновления Elasticsearch

Вы можете отслеживать ход обновления ES на панели мониторинга администратора сайта.

  1. В правом верхнем углу любой страницы щелкните .
  2. На левой боковой панели щелкните " Поиск индексов".

После завершения перестроения индекса все индексы поиска должны отображаться зеленым цветом и "100%."

Изменение количества ремонтных работников

По умолчанию число рабочих ролей восстановления индекса устанавливается на число ядер ЦП, разделенных на 8 (с верхней границой 8). Чтобы ускорить перестроение индекса, можно настроить число рабочих ролей. Однако перед этим следует учитывать потенциальное влияние на нагрузку.

  1. SSH в ваш экземпляр GitHub Enterprise Server. Если экземпляр состоит из нескольких узлов, например, если настроен высокий уровень доступности или георепликация, передача осуществляется по SSH в основной узел. При использовании кластера можно использовать для передачи по SSH в любой узел. Замените HOSTNAME именем узла для экземпляра, именем узла или IP-адресом узла. Дополнительные сведения см. в разделе Доступ к административной оболочке (SSH).

    Shell
    ssh -p 122 admin@HOSTNAME
    
  2. Чтобы изменить количество рабочих ролей, введите следующую команду.

    Shell
    ghe-config app.github.es-workers NUMBER-OF-WORKERS
    
  3. Запустите ghe-config-apply.

Вы также можете настроить количество рабочих ролей для перестроения отдельных индексов в разделе "Индексы поиска" панели мониторинга администратора сайта. См. раздел "Мониторинг обновления Elasticsearch".