7.4. 使用 CLI 更新集群

流程

1. 确认集群可用：

   $ oc get clusterversion

   输出示例

   NAME      VERSION   AVAILABLE   PROGRESSING   SINCE   STATUS
   version   4.8.13     True        False         158m    Cluster version is 4.8.13

2. 查看当前的更新频道信息，并确认您的频道已设置为 stable-4.9:

   $ oc get clusterversion -o json|jq ".items[0].spec"

   输出示例

   {
     "channel": "stable-4.9",
     "clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff"
   }

   重要

   对于生产环境中的集群，您必须订阅一个 stable-*, eus-* 或 fast-* 频道。

3. 查看可用更新，记录下要应用的更新的版本号：

   $ oc adm upgrade

   输出示例

   Cluster version is 4.8.13
   
   Updates:
   
   VERSION IMAGE
   4.9.0   quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b

4. 应用更新：

   • 要更新到最新版本：

     $ oc adm upgrade --to-latest=true 1

   • 要更新到一个特定版本：

     $ oc adm upgrade --to=<version> 1

     1 1

     <version>是从上一个命令输出中获取的更新版本。

5. 查看 Cluster Version Operator 的状态：

   $ oc get clusterversion -o json|jq ".items[0].spec"

   输出示例

   {
     "channel": "stable-4.9",
     "clusterID": "990f7ab8-109b-4c95-8480-2bd1deec55ff",
     "desiredUpdate": {
       "force": false,
       "image": "quay.io/openshift-release-dev/ocp-release@sha256:9c5f0df8b192a0d7b46cd5f6a4da2289c155fd5302dec7954f8f06c878160b8b",
       "version": "4.9.0" 1
     }
   }

   1

   如果desiredUpdate中的version值与您指定的值匹配，则更新正在进行中。

6. 查看集群版本状态历史记录以监控更新的状态。这可能需要一些时间才能完成对所有对象的更新。

   $ oc get clusterversion -o json|jq ".items[0].status.history"

   输出示例

   [
     {
       "completionTime": null,
       "image": "quay.io/openshift-release-dev/ocp-release@sha256:b8fa13e09d869089fc5957c32b02b7d3792a0b6f36693432acc0409615ab23b7",
       "startedTime": "2021-01-28T20:30:50Z",
       "state": "Partial",
       "verified": true,
       "version": "4.9.0"
     },
     {
       "completionTime": "2021-01-28T20:30:50Z",
       "image": "quay.io/openshift-release-dev/ocp-release@sha256:b8fa13e09d869089fc5957c32b02b7d3792a0b6f36693432acc0409615ab23b7",
       "startedTime": "2021-01-28T17:38:10Z",
       "state": "Completed",
       "verified": false,
       "version": "4.8.13"
     }
   ]

   历史记录包含了应用于集群的最新版本的列表。当CVO应用更新时，此值将会被相应更新。该列表按日期排序，最新的更新会在列表中第一个显示。如果历史信息中的更新状态为 Completed，则表示部署已完成；如果状态为 Partial，则表示更新失败或还未完成。

7. 更新完成后，可以通过以下方法确认集群已更新为新版本：

   $ oc get clusterversion

   输出示例

   NAME      VERSION     AVAILABLE   PROGRESSING   SINCE     STATUS
   version   4.9.0       True        False         2m        Cluster version is 4.9.0

   注意

   如果 oc get clusterversion 命令在 PROGRESSING 状态为 True 时显示以下错误，您可以忽略这个错误。

   NAME    VERSION AVAILABLE PROGRESSING SINCE STATUS
   version 4.10.26 True      True        24m   Unable to apply 4.11.0-rc.7: an unknown error has occurred: MultipleErrors

8. 如果您要将集群升级到下一个次版本，如从 4.y 升级到 4.(y+1)，建议在部署依赖新功能的工作负载前确认您的节点已升级：

   $ oc get nodes

   输出示例

   NAME                           STATUS   ROLES    AGE   VERSION
   ip-10-0-168-251.ec2.internal   Ready    master   82m   v1.22.1
   ip-10-0-170-223.ec2.internal   Ready    master   82m   v1.22.1
   ip-10-0-179-95.ec2.internal    Ready    worker   70m   v1.22.1
   ip-10-0-182-134.ec2.internal   Ready    worker   70m   v1.22.1
   ip-10-0-211-16.ec2.internal    Ready    master   82m   v1.22.1
   ip-10-0-250-100.ec2.internal   Ready    worker   69m   v1.22.1