#Upgrade Workload Clusters

#Confirm workload-cluster prerequisites

Перед отправкой запроса на обновление убедитесь, что:

• Версия workload cluster ниже текущей версии кластера global.
• Global tier уже достиг целевой версии ACP Distribution Version.
• В средах global DR и standby, и primary global clusters уже достигли этой целевой версии Distribution Version.

#Run preflight checks

Выполните preflight перед отправкой запроса на обновление:

bash upgrade.sh --cluster=<cluster> --preflight

Preflight возвращает две части:

Если preflight не проходит, не отправляйте запрос на обновление, пока все блокирующие элементы не будут устранены.

Паттерны обработки блокировок preflight см. в Handle preflight blocks when needed.

#Request the upgrade

После успешного прохождения preflight выберите один из следующих способов:

• Запустите обновление из workload cluster в Web Console.
• Используйте ACP CLI, если ваша текущая сессия ACP может получить доступ к целевому workload cluster. Чтобы избежать неоднозначности, укажите целевой кластер явно с помощью --cluster.

Если вы впервые работаете с ACP CLI, см. Getting Started with ACP CLI. Для выбора session и cluster см. Managing CLI Profiles.

Если вы используете Web Console, запрос выполняется в два этапа:

• На Step 1 проверьте список RPCH.
• Нажмите Acknowledge, чтобы перейти к Step 2.
• На Step 2 проверьте Current Version и Target Version. На этом этапе страница не отображает список plugin или warning panel.
• Целевая версия — это текущая версия кластера global, и ее нельзя выбрать вручную в Web Console.
• Нажмите Start Upgrade.
• После отправки запроса на странице отображается, что запрос на обновление был отправлен, а действие переходит в состояние in-progress.

Пример ACP CLI:

# Request upgrade to the highest version currently published in availableUpdates
ac adm upgrade --cluster=<cluster> --to-latest

# Request upgrade to a specific target version
ac adm upgrade --cluster=<cluster> --to=4.3.0

ACP CLI отправляет запрошенную целевую версию для указанного workload cluster. Возможность продолжения обновления по-прежнему определяется доступными целями обновления кластера и проверками preflight в upgrade controller. ACP CLI не используется для обновления кластера global.

Полный рабочий процесс обновления в AC CLI (подготовка metadata, available updates, режимы запроса и интерпретация статуса) см. в Upgrading Clusters. Полный синтаксис команд и флагов см. в AC CLI Administrator Command Reference.

#Observe progress

После отправки запроса на обновление используйте cvsh.status, чтобы отслеживать текущую версию, целевую версию, результаты preflight, stages и history:

kubectl get cvsh <cluster> -n cpaas-system
kubectl get cvsh <cluster> -n cpaas-system -o yaml

Если текущий контекст ACP указывает на целевой workload cluster, вы также можете проверить статус, отображаемый CLI:

# Show summary, preflight, and stage progress for the target cluster upgrade
ac adm upgrade status

Подробную семантику вывода ac adm upgrade status (интерпретацию preflight и stages) см. в Upgrading Clusters.

При устранении неполадок сначала проверьте conditions, сведения preflight и history:

kubectl -n cpaas-system get cvsh <cluster> \
  -o jsonpath='{range .status.conditions[*]}{.type}{"\t"}{.status}{"\t"}{.reason}{"\t"}{.message}{"\n"}{end}'

kubectl -n cpaas-system get cvsh <cluster> \
  -o jsonpath='{.status.preflight.observedAt}{"\n"}{range .status.preflight.checks[*]}{.name}{"\t"}{.policy}{"\t"}{.state}{"\t"}{.reason}{"\t"}{.message}{"\n"}{end}'

kubectl -n cpaas-system get cvsh <cluster> \
  -o jsonpath='{range .status.history[*]}{.version}{"\t"}{.state}{"\t"}{.startedTime}{"\t"}{.completionTime}{"\n"}{end}'