OpenShift 4 之获取版本升级路径图

Openshift 4的版本

产品版本规则

OpenShift 4的版本分为3段数字来定义，例如4.2.8。它们分别代表以下含义：

1. 第一个“4”是主版本。OpenShift 4是2019年6月发布的，而OpenShift 3是2016年发布的。主版本升级意味着整个产品架构的巨大变化，通常要审慎决策。
2. 第二个“2”是小版本。OpenShift 4的第一个公开小版本是“4.1”。小版本增加代表有新的功能或原有功能有变化，例如OpenShift 4.2提供了为开发者使用的Developer视图，这个功能在OpenShift 4.1中没有。RedHat一般会每3-4个月发一个新的小版本。
3. 第三个“8”是补丁版本：每个补丁版本代表修正了一些功能bug或安全风险，但没有增加新功能。RedHat一般会每周发一个新的补丁版本。需要注意的是补丁版本可能不是连续的，即例如“4.2.4”后面会直接出“4.2.7”。

版本升级策略

首先因为架构差异较大，因此低主版本不能直接升级到高主版本环境，例如不能将OpenShift 3集群升级（Upgrade）到OpenShift 4的，只能通过迁移（Migrate）的方式将原有部署在OpenShift 3集群中的用重新部署在新的OpenShift 4环境。

在相同的小版本情况下升级补丁版本是比较安全的，例如从“4.2.4”升级“4.2.7”。只要通过oc命令或OpenShift控制台就可进行这种升级。不过不是所有补丁版本都可直接升级，有些只能进行间接升级，例如当前版本是“4.2.1”，希望升级到“4.2.10”。这种情况需要先将“4.2.1”升级到“4.2.7”，然后才能再升级到“4.2.10”。

OpenShift 4支持小版本升级，例如从“4.1.X”升级到“4.2.X”。不过这种小版本之间的升级不是任意的，有些是由升级路径决定的、有些根本就不可以，例如“4.1.22”不可以升级到“4.2.1”（因为“4.1.22”可能比“4.2.1”发布的还晚）。

如何确定OpenShift 4版本升级路径就是本文下面说明的。

OpenShift 4 版本升级通道

从OpenShift 4开始，为了给用户提供升级建议，RedHat引入了升级通道的概念。用户可根据升级策略，从不同升级通道完成OpenShift 4的升级。目前OpenShift 4.2提供的升级通道有三个：fast-4.2、stable-4.2和candidate-4.2。它们分别针对GA版和RC版的OpenShift。

GA版软件升级

已经GA(General Availability)的软件：该版本OpenShift可在生产环境运行并且可获得官方售后的技术支持。用户可从fast或stable通道的版本获得GA版本，两者的区别是如果有新版发布，用户是否需要立即升级，或是让OpenShift控制升级节奏。
fast-4.2：当有新版GA后，fast升级通道会立即升级。例如当有新版本4.2.4发布后，会立即对升级现有版本较低的4.2.3。这种升级方式一般用在预生产环境，或用来测试新特性的试用环境中。
stable-4.2：该升级通道允许用户将升级安排在某个时间点开始，它允许用户在升级前对环境进行评估，例如是否操作系统也需要提现打补丁。这种方式主要用在正式的生产环境中。

RC版软件升级

发布候选RC(Release Candidate)软件: 该版本代表即将GA的版本，它包括软件所有功能。该版本的OpenShift只能从candidate-4.2通道获得。用户可以从小版本较低的RC版升级到新版RC版，但不能从GA升级至RC版。RC版不能获得官方售后的技术支持。通常RC版主要用于新版本的功能性验证和测试。

获得OpenShift 4的版本升级路线图

OpenShift提供了升级建议服务，该服务基于现有版本给出了升级路线。当OpenShift是在线运行，可以从OpenShift的控制台获得升级建议。我们也可以通过本文获得OpenShift提供了升级建议服务升级路线图。

安装graphviz和jq工具

1. 在/etc/yum.repo目录下新建graphviz.repo文件，将以下yum源内容添加到文件中。

[atomic]
name = CentOS / Red Hat Enterprise Linux $releasever - atomic
mirrorlist = http://updates.atomicorp.com/channels/mirrorlist/atomic/centos-$releasever-$basearch
enabled = 1
protect = 0
gpgkey = file:///etc/pki/rpm-gpg/RPM-GPG-KEY.art.txt
        file:///etc/pki/rpm-gpg/RPM-GPG-KEY.atomicorp.txt
gpgcheck = 1

2. 执行命令安装graphviz和jq

$ yum install -y graphviz
$ yum install -y jq

生成OpenShift 4升级路径图

1. 下载以下内容的执行脚本graph.sh

set -e
JQ_SCRIPT='"digraph Upgrades {\n  labelloc=t;\n  rankdir=BT;" as $header |
  (
    [
      .nodes |
      to_entries[] |
      "  " + (.key | tostring) +
             " [ label=\"" + .value.version + "\"" + (
               if .value.metadata.url then " href=\"" + .value.metadata.url + "\"" else "" end
             ) +
             " ];"
    ] | join("\n")
  ) as $nodes |
  (
    [
      .edges[] |
      "  " + (.[0] | tostring) + "->" + (.[1] | tostring) + ";"
    ] | join("\n")
  ) as $edges |
  [$header, $nodes, $edges, "}"] | join("\n")
'
exec jq -r "${JQ_SCRIPT}"

2. 生成OpenShift 4升级路径图脚本

$ chmod +x graph.sh
$ curl -sH 'Accept:application/json' 'https://api.openshift.com/api/upgrades_info/v1/graph?channel=fast-4.2&arch=amd64' | ./graph.sh | dot -Tsvg > graph.svg

3. 确认目录中已经有graph.svg文件。打开可以看到和“fast-4.2”相关的升级路线。