1.5. 使用 ROSA CLI 升级整个集群

流程

1. 运行以下命令，验证集群的当前版本：

   $ rosa describe cluster --cluster=<cluster_name_or_id> 1

   1

   将 <cluster_name_or_id > 替换为集群名称或集群 ID。

2. 运行以下命令，列出您可以将 control plane 升级到的版本：

   $ rosa list upgrade --cluster=<cluster_name_or_id>

   该命令返回一个可用更新列表，包括推荐的版本。

   输出示例

   VERSION  NOTES
   4.14.8   recommended
   4.14.7
   4.14.6

3. 运行以下命令升级集群的托管 control plane：

   $ rosa upgrade cluster -c <cluster_name_or_id> --control-plane [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>

   • 要调度立即升级到指定版本，请运行以下命令：

     $ rosa upgrade cluster -c <cluster_name_or_id> --control-plane --version <version_number>

     您的托管的 control plane 会被调度立即升级。

   • 要计划在以后的版本中升级到指定版本的升级，请运行以下命令：

     $ rosa upgrade cluster -c <cluster_name_or_id> --control-plane --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version=<version_number>

     您的托管 control plane 在协调通用时间(UTC)中指定的时间进行升级。

流程

1. 运行以下命令，验证集群的当前版本：

   $ rosa describe cluster --cluster=<cluster_name_or_id> 1

   1

   将 <cluster_name_or_id > 替换为集群名称或集群 ID。

   输出示例

   OpenShift Version:     4.14.8

2. 运行以下命令，列出您可以将机器池升级到的版本：

   $ rosa list upgrade --cluster <cluster-name> --machinepool <machinepool_name>

   该命令返回一个可用更新列表，包括推荐的版本。

   输出示例

   VERSION  NOTES
   4.14.5   recommended
   4.14.4
   4.14.3

   重要

   不要将机器池升级到比 control plane 高的版本。如果要移至更高的版本，请首先将 control plane 升级到那个版本。

3. 运行以下命令，验证您要升级的机器池的升级行为：

   $ rosa describe machinepool --cluster=<cluster_name_or_id> <machinepool_name>

   输出示例

   Replicas: 5
   Node drain grace period:   30 minutes
   
   Management upgrade:
   - Type: Replace
   - Max surge: 20%
   - Max unavailable: 20%

   在示例中，这些设置允许机器池置备一个超额节点（最多 20% 的副本），并在升级过程中最多不可用一个节点（最多 20% 的副本）。 因此，这个机器池可以一次升级两个节点，方法是在超过副本数的情况下置备一个新节点，并使一个节点不可用并替换它。如果需要保护 pod 中断预算的工作负载，节点升级可能会延迟最多 30 分钟(node-drain-grace-period 为 30 分钟)。

4. 运行以下命令来升级机器池：

   $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> [--schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm>] --version <version_number>

   您可以为您要升级的每个机器池运行这个命令来同时升级多个机器池。

   • 调度机器池的立即升级：

     $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --version <version_number>

     机器池被调度立即升级，它会启动指定机器池中所有节点的滚动替换。

   • 调度升级以在以后启动：

     $ rosa upgrade machinepool -c <cluster_name> <machinepool_name> --schedule-date=<yyyy-mm-dd> --schedule-time=<HH:mm> --version <version_number>

     机器池计划在协调通用时间(UTC)中指定的时间和日期开始升级。这将启动指定机器池中所有节点的滚动替换，从指定时间开始。