Upgrade Chef Infra Server — Chef 16

Матрица обновления сервера Chef Infra

Текущая версия	Версия обновления	Лицензия	Поддержка версии
13	14	Да	Да
12.17.15	14	Да	Да
12.3.0	12.17.15	Нет	Нет
11	12.3.0	Нет	Нет

Лицензия: Сервер Chef Infra 13 и 14 регулируются лицензией Chef. При первом использовании сервера Chef Infra 13 или 14 вам потребуется принять эти условия, введя Yes при запросе.
Поддержка версии: Серверы Chef Infra 13 и 14 поддерживаются дистрибутивами Chef Software. Более ранние версии больше не поддерживаются. Дополнительную информацию о поддерживаемых дистрибутивах Chef Software см. в документации Поддерживаемые версии.

Обновление до сервера Chef Infra

Существует три сценария обновления для перехода с сервера Chef Infra 12.17.15 на сервер Chef Infra 13 или 14:

Сервер Chef Infra 14

Предупреждение

Не обновляйте сервер в режиме production. Сначала обновите сервер в режиме test, а затем - в production.

Сервер Chef Infra 14 использует Elasticsearch в качестве индекса поиска. Процесс обновления сервера Chef Infra 14 требует временной остановки сервера, установки нового пакета и последующего обновления сервера, что включает автоматическое переиндексирование Elasticsearch для существующих пользователей Solr. Ожидается, что переиндексирование займет 2 минуты на каждые 1000 узлов, но оно может занять больше времени в зависимости от аппаратного обеспечения вашего сервера и сложности данных Chef.

Обновление сервера Chef Infra 14 не переиндексирует существующие внешние установки Elasticsearch.

Сервер Chef Infra 12.17.15 или более поздние версии

Предупреждение

Обновите сервер Chef Infra и все дополнения до совместимых версий перед установкой insecure_addon_compat на false.

Начиная с версии 12.14, сервер Chef Infra по умолчанию отображает пароли внутри каталога /etc/opscode. Если вы используете сервер Chef Infra без дополнений или используете последние версии дополнений, вы можете установить insecure_addon_compat на false в `/etc/opscode/chef-server.rb`. В этом случае сервер Chef Infra будет записывать все учетные данные в одно место.

Дополнительную информацию о генерации паролей, включая список поддерживаемых версий дополнений, см. в разделе Управление учетными данными сервера Chef Infra.

Обновление по отдельности

Процесс обновления сервера Chef Infra 14 требует временной остановки сервера, установки нового пакета и последующего обновления сервера, что включает автоматическое переиндексирование Elasticsearch для существующих пользователей Solr. Ожидается, что переиндексирование займет 2 минуты на каждые 1000 узлов, но оно может занять больше времени в зависимости от аппаратного обеспечения вашего сервера и сложности данных Chef.

Шаги обновления по отдельности

Создайте резервную копию данных сервера Chef Infra перед началом процесса обновления, используя knife-ec-backup.
Убедитесь, что службы сервера Chef Infra работают:
```
chef-server-ctl reconfigure
```
Загрузите нужную версию сервера Chef Infra со страницы Загрузки сервера Chef Infra.
Остановите сервер:
```
chef-server-ctl stop
```
Установите пакет сервера Chef Infra:

Для установки с использованием dpkg:
```
dpkg -i /path/to/chef-server-core-<version>.deb
```
Для установки с помощью RPM Package Manager:
```
rpm -Uvh --nopostun /path/to/chef-server-core-<version>.rpm
```
Обновите сервер и примите лицензию Chef Software, введя Yes в запросе:
```
chef-server-ctl upgrade
```
Для принятия лицензии и обновления одной командой:
```
CHEF_LICENSE='accept' chef-server-ctl upgrade
```
Запустите сервер Chef Infra:
```
chef-server-ctl start
```
Обновите все дополнения сервера Chef Infra.
После завершения процесса обновления проверьте работоспособность сервера.
Очистите сервер, удалив старые данные:
```
chef-server-ctl cleanup
```

Обновление сервера Chef

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

Для обновления вашей установки сервера Chef см. Высокая доступность: Обновление до сервера Chef Backend 2.

Поэтапное обновление

В этом разделе описывается процесс обновления в конфигурации сервера с несколькими уровнями.

Примечание

Эти инструкции предназначены для пользователей топологии сервера Chef Infra tier. Для получения последней информации о настройке кластера сервера высокой доступности см. Высокая доступность: кластер Backend.

Шаги поэтапного обновления

Для обновления сервера Chef Infra в конфигурации с несколькими уровнями выполните следующие действия:

Создайте резервную копию данных сервера Chef Infra перед началом процесса обновления, используя knife-ec-backup.
Убедитесь, что службы сервера Chef Infra работают:
```
chef-server-ctl reconfigure
```
Загрузите нужную версию сервера Chef Infra со страницы Загрузки сервера Chef Infra, затем скопируйте ее на каждый сервер.
Остановите все фронтэнд-серверы:
```
chef-server-ctl stop
```
Установите пакет сервера Chef Infra на все серверы:

Для установки с использованием dpkg:
```
dpkg -i /path/to/chef-server-core-<version>.deb
```
Для установки с помощью RPM Package Manager:
```
rpm -Uvh --nopostun /path/to/chef-server-core-<version>.rpm
```
Остановите бэкэнд-сервер:
```
chef-server-ctl stop
```
Обновите сервер и примите лицензию Chef Software, введя Yes в запросе:
```
chef-server-ctl upgrade
```
Для принятия лицензии и обновления одной командой:
```
CHEF_LICENSE='accept' chef-server-ctl upgrade
```
Скопируйте весь каталог /etc/opscode с бэкэнд-сервера на все фронтэнд-серверы:
```
scp -r /etc/opscode <each server's IP>:/etc
```
Обновите каждый из фронтэнд-серверов:
```
chef-server-ctl upgrade
```
Выполните следующую команду как на фронтэнд-, так и на бэкэнд-серверах:
```
chef-server-ctl start
```
Обновите все дополнения сервера Chef Infra.
После завершения процесса обновления проверьте работоспособность сервера.
Очистите сервер, удалив старые данные:
```
chef-server-ctl cleanup
```

Обновление дополнений

Сервер Chef Infra 13 и 14 поддерживает Chef Manage и Push Jobs. Оба этих дополнения устарели. Push Jobs достигнут окончания жизненного цикла 31 декабря 2020 года, а Chef Manage — 31 декабря 2021 года. После обновления сервера Chef Infra переустановите дополнение, а затем переконфигурируйте сервер Chef Infra и дополнение.

Chef Manage: Chef Manage устарел и достигнет окончания жизненного цикла 31 декабря 2021 года. Chef Manage — это консоль управления для пакетов данных, атрибутов, списков выполнения, ролей, сред и кулинарных книг из веб-интерфейса.
Push Jobs: Push Jobs устарел и достигнет окончания жизненного цикла 31 декабря 2020 года. Push Jobs Chef — это расширение сервера Chef Infra, которое позволяет запускать задачи на узлах независимо от выполнения клиента Chef Infra.

Использование загрузок

Подкоманда install по умолчанию загружает пакеты из https://downloads.chef.io. Для систем, не находящихся за брандмауэром (и имеющих подключение к https://downloads.chef.io), эти пакеты можно установить, как описано ниже.

Установка дополнений

Установите Chef Manage с помощью:
```
sudo chef-server-ctl install chef-manage
```
Установите Push Jobs с помощью:
```
sudo chef-server-ctl install opscode-push-jobs-server-ctl
```
Переконфигурация сервера
```
sudo chef-server-ctl reconfigure
```
Переконфигурация дополнений

Переконфигурируйте Chef Manage с помощью:
```
sudo chef-manage-ctl reconfigure
```
Переконфигурируйте Push Jobs с помощью:
```
sudo opscode-push-jobs-server reconfigure
```

Наконец, примите лицензию Chef:

sudo chef-manage-ctl reconfigure --accept-license

Использование локальных пакетов

Используйте подкоманду install с опцией --path для установки дополнений Chef Manage (chef-manage) и Push Jobs (opscode-push-jobs-server) для сервера Chef Infra.

sudo chef-server-ctl install PACKAGE_NAME --path /path/to/package/directory

Например:

sudo chef-server-ctl install chef-manage --path /root/packages

Команда chef-server-ctl установит первый найденный пакет chef-manage в каталоге /root/packages.