升级

流程

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)中指定的时间和日期开始升级。这将启动指定机器池中所有节点的滚动替换，从指定时间开始。

流程

1. 要验证集群的当前版本，请输入以下命令：

   $ rosa describe cluster --cluster=<cluster_name|cluster_id> 1

   1

   将 <cluster_name|cluster_id> 替换为集群名称或集群的 ID。

2. 要验证升级是否可用，请输入以下命令：

   $ rosa list upgrade --cluster=<cluster_name|cluster_id>

   该命令返回一个集群可以升级的版本列表，包括推荐的版本。建议基于条件更新风险。每个已知的风险都可能适用于所有集群，或者只应用到与特定条件匹配的集群。请参阅 OpenShift 发行注记来评估、验证并确定要升级到的适当版本。

3. 要将集群在下一个小时内立即升级到指定版本，请输入以下命令：

   $ rosa upgrade cluster --cluster=<cluster_name|cluster_id> --version <version-id>

   注意

   如果要升级 AWS 安全令牌服务(STS)集群，这个命令会启动一个交互式 IAM Roles/policies 升级模式，验证所选集群的帐户和 Operator 角色策略是否与升级的目标版本兼容。如果策略与所选升级版本不兼容，CLI 会自动以 auto 模式升级它们。

   为集群调度立即升级，如 Scheduled Time 表示。升级将在从调度的时间一小时内开始。

4. 另外，要在以后以 UTC 的方式升级集群，请输入以下命令：

   $ rosa upgrade cluster --cluster=<cluster_name|cluster_id>   \
             --version <version-id>   \
             --schedule-date yyyy-mm-dd \
             --schedule-time HH:mm

5. 要自定义在集群升级过程中要排空的每个节点宽限期，请输入以下命令：

   $ rosa upgrade cluster --cluster=<cluster_name|cluster_id>   \
             --version <version-id>   \
             --node-drain-grace-period 15 minutes

6. 您可以输入以下命令来查看升级的状态，该命令显示状态（调度或启动）和调度的时间。

   $ rosa list upgrade --cluster=<cluster_name|cluster_id>

   输出示例

   VERSION  NOTES
   4.15.14  recommended - scheduled for 2024-06-02 15:00 UTC
   4.15.13

流程

1. 使用以下命令验证集群更新是否已启动：

   $ rosa list upgrades --cluster=<cluster_name|cluster_id>

   输出示例

   VERSION  NOTES
   4.15.14  recommended - scheduled for 2024-06-02 15:00 UTC
   4.15.13

2. 运行以下命令来删除调度的更新：

   $ rosa delete upgrade --cluster=<cluster_name|cluster_id>

3. 在确认提示中输入 Yes 来确认删除。

   输出示例

   I: Successfully canceled scheduled upgrade on cluster 'my-cluster'

流程

1. 登录到 OpenShift Cluster Manager。
2. 选择要升级的集群。
3. 点 Settings 选项卡。

4. 在 Update strategy 窗格中，选择您想要的更新类型：

   • 对于单个更新，您可以立即请求升级（在一小时内启动），或在以后进行升级。

   • 对于周期性更新，请选择重复日期和时间，以自动启动升级到最新 x.y.Z (z-stream)版本。

     重要

     重复更新仅适用于 z-stream 更新。需要手动进行次版本或 y-stream 更新。当有新的 y-stream 更新可用时，您将收到通知。

5. 可选： 在 Node draining 窗格中，从列表中选择一个宽限期间隔。宽限期可让节点在强制 pod 驱除前安全排空。默认值为 1 小时。

   重要

   在开始升级过程后，您无法更改节点排空宽限期。

6. 在 Update strategy 窗格中，点 Save 以应用您的更新策略。

7. 在 Update status 窗格中，查看更新可用信息，然后点更新。

   注意

   只有在升级可用时才启用更新按钮。

8. 此时会打开 Update cluster 对话框。推荐的集群升级会出现在 Select version 窗格中。选择您要将集群升级到的版本，然后点 Next。

9. 可选： 对于使用 AWS 安全令牌服务(STS)的 ROSA 集群，可能需要更新帐户级别和特定于集群的 Operator 角色，具体取决于所选目标版本。

   1. 在 ROSA CLI 中，运行 rosa list account-roles 命令，以列出并验证帐户角色是否与为升级选择的目标次版本兼容。如果角色不兼容，请运行 rosa upgrade account-roles 命令，将帐户角色升级到最新的 OpenShift 版本。
   2. 在 ROSA CLI 中，运行 rosa list operator-roles 命令来列出并验证与集群关联的 Operator 角色是否与为升级选择的目标次版本兼容。如果没有，请运行 rosa upgrade operators-roles 命令，将集群的 Operator 角色升级到最新的 OpenShift 版本。
   3. 如果您选择了需要批准的更新版本，请在提供的字段中键入 Acknowledge 来提供管理员的确认，然后点击 Next。

10. 在 Schedule update 对话框中，调度集群升级。

    • 要在一小时内升级，请选择 Update now 并点下一步。
    • 要稍后升级，请选择 Schedule a different time 并为升级设置时间和日期。点 Next 进入确认对话框。
11. 检查版本和调度概述后，选择 Confirm update。
12. 点 Close 退出 Update cluster 对话框。

流程

1. 登录到 OpenShift Cluster Manager。
2. 选择带有调度的升级的集群。
3. 点 Settings 选项卡。
4. 在 Update status 窗格中，单击 Cancel this update。
5. 检查 Cancel update 对话框中的更新详情，再单击 Cancel this update。