Обновление StarVault

Это общие инструкции по обновлению StarVault для установок без высокой доступности (не‑HA) и с высокой доступностью (HA). Обязательно ознакомьтесь также с примечаниями к конкретной версии, которые можно найти в боковой панели.

Всегда создавайте резервную копию данных перед обновлением! StarVault не гарантирует обратной совместимости хранилища данных.

1. Обновление в режиме без высокой доступности

Для обновления выполните следующие шаги:

Остановите StarVault на узле.
```
sudo systemctl stop starvault
```
Обновите StarVault на узле.
```
sudo dnf update -y starvault
```
Запустите узел.
```
sudo systemctl start starvault
```
Распечатайте узел с помощью ключа.
```
starvault operator unseal
```
После ввода команды вам будет предложено ввести ключ распечатки. Повторите команду столько раз, сколько требуется ключей (обычно 3-5).
Убедитесь, что StarVault упешно распечатан и в выводе указана новая версия.
```
starvault status
```

Приведенные команды являются примерами для систем с systemd и менеджером пакетов dnf. В других окружениях используйте соответствующие команды управления службами и пакетами (например, apt для Debian/Ubuntu, yum для CentOS, или прямое копирование бинарника).

2. Обновление в режиме высокой доступности

Перед применением описанных шагов оцените особенности вашей конфигурации высокой доступности (HA). Конфигурации HA могут различаться по использованию балансировщика нагрузки, адресам, которые получают клиенты для подключения к StarVault (резервные узлы + ведущий, только ведущий или обнаружение через сервис-дискавери), и другим параметрам.

Независимо от используемого метода не допускайте переключения с более новой версии StarVault на более старую. Предлагаемая процедура обновления предотвращает это.

StarVault не позволяет выполнить обновление без остановки работы, однако при соблюдении процедуры время простоя будет минимальным — от долей секунды до нескольких секунд в зависимости от скорости работы хранилища.

После обновления по умолчанию StarVault будет запечатан. Убедитесь, что у вас есть ключ для распечатки.

Для обновления на каждом резервном узле выполните шаги указанные в инструкции. Повторите шаги инструкции для каждого узла. Обновление кластера не завершится, пока один из обновленных резервных узлов не станет активным.

Для завершения обновления кластера по инструкции обновите активный узел.

Важно корректно завершить работу узла перед обновлением. Это приведет к снижению уровня и снятию блокировки высокой доступности, что позволит резервному узлу взять на себя управление с очень небольшой задержкой. Если вы завершите работу StarVault, не дождавшись снятия блокировки, резервный узел не сможет взять на себя управление до истечения периода ожидания блокировки. Это зависит от бэкэнда, но может составлять десять секунд или более.

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

Обязательно ознакомьтесь следуйте инструкциям в примечаниях к конкретной версии.

3. Тестирование обновления

Убедитесь, что обновление прошло успешно в вашем окружении. Для этого создайте снимок данных и загрузите его в тестовый кластер. Однако если вы выдаете секреты сторонним ресурсам (учетные данные облачных сервисов, базы данных и т.д.), убедитесь, что во время тестирования нет внешнего сетевого подключения, чтобы избежать истечения срока действия учетных данных. Это предотвратит попытки тестового кластера отозвать эти ресурсы вместе с рабочим кластером.