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

• Доступ до harbor.bootsman.host для обновления или выгрузки образов в ваш локальный регистри
• Наличие активной лицензии
• Наличие дистрибутивов:
  • bootsmanctl v2.7.0
• Наличие в управляющем кластере 3 мастеров и 3 воркеров.
• Для baremetal обеспечьте как минимум одну свободную ноду.
• Все кластеры должны иметь версию Kubernetes 1.28.4+.
• Все кластеры должны иметь версию Bootsman не ниже v2.6.0.

Обновление до предыдущих версий

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

На странице История изменений вы можете ознакомится с изменениями и перейти на страницу обновления до соответствующей версии.

Подготовка

Загрузка образов

Используйте дистрибутив bootsmanctl для копирования образов в ваше хранилище

(1)./bootsmanctl mirror registry {++REGISTRY_PATH++} -u {++REGISTRY_USERNAME++} -p {++REGISTRY_PASSWORD++} -r v2.7.0

1. REGISTRY_PATH - URL хранилища образов REGISTRY_USERNAME - имя пользователя в вашем хранилище REGISTRY_PASSWORD - пароль пользователя в вашем хранилище

Ошибки передачи данных

В случае появления ошибок передачи, повторите процедуру копирования.

2025/07/17 10:47:21 protocol error: received DATA after END_STREAM
2025/07/17 10:49:12 protocol error: received DATA after END_STREAM

Подготовка конфигурации

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

Внимание

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

yq -i 'del(.addons)' bootsmanctl.config.yaml

Внимание

При обновлении в исполнении baremetal необходимо наличие свободных машин в сети кластера, соответвующих минимальным требованиям, по одной на роли Master и Worker.

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

Обновление управляющего кластера

Для обновления перенесите новый дистрибутив на АРМ администратора в директорию, содержащую данные об установке.

Запустите обновление.

./bootsmanctl management update {++cluster-name++} -c bootsmanctl.config.yaml

1. cluster-name - имя кластера, данное ему при установке.

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

Обновление подчинённого кластера

Web UI

Войдите в Web-интерфейс bootsman и на главной выберете "Manage"

Выберите подчиненный кластер для обновления и откройте его для редактирования

Выберете версию v2.7.0 и нажмите "Apply"

Yaml-манифесты

Обновление подчинённого кластера происходит с помощью kubectl.

Используя kubeconfig управляющего кластера, выполните команды:

Запрос списка всех подчинённых кластеров и воркерпулов:

kubectl get cluster.provisioning.bootsman.tech -A
kubectl get workerpool.provisioning.bootsman.tech -A

Из полученного списка получите имя подчинённого кластера(<mark>cluster_name</mark>) и его неймспейс (<mark>namespace</mark>)

Обновление:

kubectl patch cluster.provisioning.bootsman.tech {++cluster_name++} -n {++namespace++} --type=merge --patch="{\"spec\": {\"bootsmanVersion\": \"v2.7.0\"}}"

Дождитесь завершения обновления подчиненного кластера

kubectl get cluster.provisioning.bootsman.tech {++cluster_name++} -n {++namespace++} -o jsonpath='{.status.conditions[?(@.type=="Ready")].status}'
True