Требования к обновлению

Рекомендации

• Включите как можно меньше обновлений в процесс обновления. Например, вместо обновления до GitHub Enterprise3.213.203.19 , вы можете выполнить обновление до .GitHub Enterprise3.193.21 Помощник по обновлению Используйте для поиска пути обновления из текущей версии выпуска.
• Если вы находитесь в нескольких версиях, выполните обновление ваш экземпляр GitHub Enterprise Server как можно дальше с каждым этапом процесса обновления. Использование самой актуальной версии в каждом обновлении позволяет использовать преимущества повышенной производительности и исправления ошибок. Например, можно обновить с 2.7 до 2.8 до 2.10, но обновление с GitHub EnterpriseGitHub Enterprise 2.7 до 2.9 до 2.10 использует более позднюю версию во втором шаге.
• При обновлении используйте последний выпуск исправлений. Перейдите на страницу выпусков GitHub Enterprise Server. Рядом с выпуском, до которого вы обновляетесь, нажмите кнопку Скачать, а затем перейдите на вкладку Обновление.
• Используйте промежуточный экземпляр для проверки шагов обновления. Дополнительные сведения см. в разделе Настройка промежуточного экземпляра.
• При выполнении нескольких обновлений убедитесь, что задачи миграции данных и обновления, выполняемые в фоновом режиме, полностью завершены, прежде чем переходить к следующему обновлению компонентов. Чтобы проверить состояние этих процессов, можно использовать ghe-migrations служебные программы и ghe-check-background-upgrade-jobs программы командной строки. Дополнительные сведения см. в разделе Служебные программы командной строки.
• Создайте моментальный снимок перед обновлением виртуальной машины. Дополнительные сведения см. в разделе Создание моментального снимка. После создания моментального снимка отключите автоматические моментальные снимки, чтобы избежать возможных последствий производительности во время обновления.
• Убедитесь, что у вас есть последняя успешная резервная копия экземпляра. Дополнительные сведения см. в GitHub Enterprise Server Backup Utilities файле README.md.

Требования

• Необходимо выполнить проверку емкости. Дополнительные сведения см. в разделе Проверка емкости системы перед обновлением.
• Необходимо выполнить обновление выпуска, версия которого отстает не более, чем на две версии. Например, чтобы выполнить обновление GitHub Enterprise3.21до , необходимо включить GitHub Enterprise3.20 или 3.19выполнить обновление.
• При обновлении с помощью пакета обновления запланируйте период обслуживания для GitHub Enterprise Server конечных пользователей.
• Вы можете обновить GitHub Enterprise Server до последней версии исправления с помощью горячего исправления.

Для обновления до следующего выпуска исправлений можно использовать горячее исправление, но не выпуск с новыми функциями. Например, можно обновить с версии 2.10.1 до версии 2.10.5, так как они находятся в одной серии признаков, но не с 2.10.9 до 2.11.0, так как они находятся в другой серии признаков.

Горячие патчи не всегда требуют перезагрузки. При установке горячего исправления вы увидите сообщение в терминале, если для завершения обновления потребуется перезагрузка пакетов. Вы можете запланировать эту перезагрузку в удобное время, но мы рекомендуем перезагрузить как можно скорее практически, особенно если есть какие-либо исправления безопасности.

Хотпатчи требуют выполнения конфигурации, что может привести к кратковременному периоду ошибок или неотзывчивости некоторых или всех сервисов на ваш экземпляр GitHub Enterprise Server. Вам не требуется включить режим обслуживания во время установки hotpatch, но это гарантирует, что пользователи увидят страницу обслуживания вместо ошибок или времени ожидания. См . раздел AUTOTITLE.

• Для горячего исправления может потребоваться время простоя, если затрагиваемые службы (например, ядро, MySQL или Elasticsearch) требуют перезагрузки виртуальной машины или перезапуска службы. Вы получите уведомление о необходимости перезагрузки или перезапуска. Вы можете выполнить перезагрузку или перезапуск позднее.
• Дополнительное корневое хранилище должно быть доступно при обновлении посредством горячего исправления, так как при этом до завершения обновления будет установлено несколько версий определенных служб. По результатам предварительной проверки вы получите уведомление в случае, если у вас недостаточно пространства корневого дискового хранилища.
• При обновлении посредством горячего исправления экземпляр нельзя слишком загружать, так как это может повлиять на процесс горячего исправления.
• Обновление до GitHub Enterprise Server версии 2.17 переносит журналы аудита из Elasticsearch в MySQL. Эта миграция также увеличивает время и место на диске, необходимое для восстановления моментального снимка. Перед миграцией проверьте число байтов в индексах журнала аудита Elasticsearch с помощью следующей команды:

curl -s http://localhost:9201/audit_log/_stats/store | jq ._all.primaries.store.size_in_bytes

Используйте это число для оценки объема дискового пространства, необходимого для журналов аудита MySQL. Скрипт также отслеживает свободное место на диске в процессе импорта. Отслеживать это число особенно полезно, если свободное место на диске близко к объему дискового пространства, необходимого для миграции.

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

Следующие шаги

После просмотра этих рекомендаций и требований можно обновить GitHub Enterprise Server. Дополнительные сведения см. в разделе Обзор процесса обновления.