25 下游群集 #

在左上角，选择 ☰ → Continuous Delivery（持续交付）

转到 Git 储存库 → 添加储存库

储存库 URL - https://github.com/suse-edge/fleet-examples.git

Watch（监视）→ Revision（修订版）- 为要使用的 suse-edge/fleet-examples 储存库选择版本标记，例如 release-3.0.1。

在路径下，添加版本标记中显示的系统升级控制器路径 - fleets/day2/system-upgrade-controller

选择下一步转到目标配置部分

请仅选择您要为其部署系统升级控制器的群集。如果您对配置感到满意，请单击创建

选择您要从中部署 SUC GitRepo 的所需 Edge 版本标记（在下文中用 ${REVISION} 表示）。

提取 GitRepo 资源：

curl -o system-upgrade-controller-gitrepo.yaml https://raw.githubusercontent.com/suse-edge/fleet-examples/{REVISION}/gitrepos/day2/system-upgrade-controller-gitrepo.yaml

编辑 GitRepo 配置，在 spec.targets 下指定所需的目标列表。默认情况下，suse-edge/fleet-examples 中的 GitRepo 资源不会映射到任何下游群集。

将 GitRepo 资源应用于管理群集：

kubectl apply -f system-upgrade-controller-gitrepo.yaml

查看 fleet-default 名称空间下创建的 GitRepo 资源：

kubectl get gitrepo system-upgrade-controller -n fleet-default

# Example output
NAME                        REPO                                               COMMIT       BUNDLEDEPLOYMENTS-READY   STATUS
system-upgrade-controller   https://github.com/suse-edge/fleet-examples.git   release-3.0.1   0/0

在左上角，选择 ☰ → Continuous Delivery（持续交付）

转到高级 > 捆绑包

选择从 YAML 创建

此处可通过以下方式之一创建捆绑包：

更改捆绑包的目标群集：

创建

选择您要从中部署 SUC 捆绑包的所需 Edge 版本标记（在下文中用 ${REVISION} 表示）。

提取捆绑包资源：

curl -o controller-bundle.yaml https://raw.githubusercontent.com/suse-edge/fleet-examples/${REVISION}/bundles/day2/system-upgrade-controller/controller-bundle.yaml

编辑捆绑包目标配置，在 spec.targets 下提供所需的目标列表。默认情况下，suse-edge/fleet-examples 中的捆绑包资源不会映射到任何下游群集。

将捆绑包资源应用于管理群集：

kubectl apply -f controller-bundle.yaml

查看 fleet-default 名称空间下创建的捆绑包资源：

kubectl get bundles system-upgrade-controller -n fleet-default

# Example output
NAME                        BUNDLEDEPLOYMENTS-READY   STATUS
system-upgrade-controller   0/0

在左上角，选择 ☰ → Continuous Delivery（持续交付）

转到 Git 储存库 → 添加储存库

储存库 URL - https://github.com/suse-edge/fleet-examples.git

监视 → 修订版 - 为要使用的 suse-edge/fleet-examples 储存库选择版本标记

在路径下，添加您要使用的操作系统软件包更新 Fleet 的路径 - fleets/day2/system-upgrade-controller-plans/os-pkg-update

选择下一步转到目标配置部分。请仅选择您要升级其节点软件包的群集

创建

选择您要从中应用操作系统 SUC 更新计划的所需 Edge 版本标记（在下文中用 ${REVISION} 表示）。

提取 GitRepo 资源：

curl -o os-pkg-update-gitrepo.yaml https://raw.githubusercontent.com/suse-edge/fleet-examples/${REVISION}/gitrepos/day2/os-pkg-update-gitrepo.yaml

编辑 GitRepo 配置，在 spec.targets 下指定所需的目标列表。默认情况下，suse-edge/fleet-examples 中的 GitRepo 资源不会映射到任何下游群集。

将 GitRepo 资源应用于管理群集：

kubectl apply -f os-pkg-update-gitrepo.yaml

查看 fleet-default 名称空间下创建的 GitRepo 资源：

kubectl get gitrepo os-pkg-update -n fleet-default

# Example output
NAME            REPO                                              COMMIT         BUNDLEDEPLOYMENTS-READY   STATUS
os-pkg-update   https://github.com/suse-edge/fleet-examples.git   release-3.0.1  0/0

在左上角，单击 ☰ → Continuous Delivery（持续交付）

转到高级 > 捆绑包

选择从 YAML 创建

此处可通过以下方式之一创建捆绑包：

更改捆绑包的目标群集：

选择创建

选择您要从中应用操作系统软件包更新 SUC 计划的所需 Edge 版本标记（在下文中用 ${REVISION} 表示）。

提取捆绑包资源：

curl -o pkg-update-bundle.yaml https://raw.githubusercontent.com/suse-edge/fleet-examples/${REVISION}/bundles/day2/system-upgrade-controller-plans/os-pkg-update/pkg-update-bundle.yaml

编辑捆绑包目标配置，在 spec.targets 下提供所需的目标列表。默认情况下，suse-edge/fleet-examples 中的捆绑包资源不会映射到任何下游群集。

将捆绑包资源应用于管理群集：

kubectl apply -f pkg-update-bundle.yaml

查看 fleet-default 名称空间下创建的捆绑包资源：

kubectl get bundles os-pkg-update -n fleet-default

# Example output
NAME            BUNDLEDEPLOYMENTS-READY   STATUS
os-pkg-update   0/0

在左上角，选择 ☰ → Continuous Delivery（持续交付）

转到 Git 储存库 → 添加储存库

储存库 URL - https://github.com/suse-edge/fleet-examples.git

监视 → 修订版 - 为要使用的 suse-edge/fleet-examples 储存库选择版本标记

在路径下，添加版本标记中显示的 Kubernetes 发行版升级 Fleet 路径：

选择下一步转到目标配置部分。请仅选择您要升级其中的所需 Kubernetes 发行版的群集

创建

选择您要从中应用 Kubernetes SUC 升级计划的所需 Edge 版本标记（在下文中用 ${REVISION} 表示）。

提取 GitRepo 资源：

编辑 GitRepo 配置，在 spec.targets 下指定所需的目标列表。默认情况下，suse-edge/fleet-examples 中的 GitRepo 资源不会映射到任何下游群集。

将 GitRepo 资源应用于管理群集：

# RKE2
kubectl apply -f rke2-upgrade-gitrepo.yaml

# K3s
kubectl apply -f k3s-upgrade-gitrepo.yaml

查看 fleet-default 名称空间下创建的 GitRepo 资源：

# RKE2
kubectl get gitrepo rke2-upgrade -n fleet-default

# K3s
kubectl get gitrepo k3s-upgrade -n fleet-default

# Example output
NAME           REPO                                              COMMIT          BUNDLEDEPLOYMENTS-READY   STATUS
k3s-upgrade    https://github.com/suse-edge/fleet-examples.git   release-3.0.1   0/0
rke2-upgrade   https://github.com/suse-edge/fleet-examples.git   release-3.0.1   0/0

在左上角，单击 ☰ → Continuous Delivery（持续交付）

转到高级 > 捆绑包

选择从 YAML 创建

此处可通过以下方式之一创建捆绑包：

更改捆绑包的目标群集：

创建

选择您要从中应用 Kubernetes SUC 升级计划的所需 Edge 版本标记（在下文中用 ${REVISION} 表示）。

提取捆绑包资源：

编辑捆绑包目标配置，在 spec.targets 下提供所需的目标列表。默认情况下，suse-edge/fleet-examples 中的捆绑包资源不会映射到任何下游群集。

将捆绑包资源应用于管理群集：

# For RKE2
kubectl apply -f rke2-plan-bundle.yaml

# For K3s
kubectl apply -f k3s-plan-bundle.yaml

查看 fleet-default 名称空间下创建的捆绑包资源：

# For RKE2
kubectl get bundles rke2-upgrade -n fleet-default

# For K3s
kubectl get bundles k3s-upgrade -n fleet-default

# Example output
NAME           BUNDLEDEPLOYMENTS-READY   STATUS
k3s-upgrade    0/0
rke2-upgrade   0/0

从您要使用的 Edge 版本标记中获取 Chart 的 Fleet 资源

该工作流程的第一个步骤是用户提取其 chart 要升级到的新 Helm chart 存档。

然后对存档进行编码，并将其作为配置传递到位于相关 SUC 计划的 Fleet 目录下的 eib-chart-upgrade-user-data.yaml 文件中。“升级步骤”（第 25.5.3.3.2 节 “升级步骤”）一节会进一步解释此过程。

然后，用户继续配置并部署 GitRepo 资源，用于将全部所需的资源（SUC 计划、密钥等）传送到下游群集。

Fleet（第 6 章 “Fleet”）检测部署的资源，并将配置的所有资源部署到指定的下游群集。部署的资源包括：

部署 eib-chart-upgrade SUC 计划后，SUC 将拾取该计划并创建一个用于部署升级 Pod 的作业。

部署后，升级 Pod 将挂载 eib-chart-upgrade-script 和 eib-chart-upgrade-user-data 密钥，并执行 eib-chart-upgrade-script 密钥附带的升级脚本。

升级脚本执行以下操作：

成功执行升级脚本后，RKE2/K3s 的 Helm 集成将拾取更改并自动触发 Helm chart 的升级。

确定您要从中复制 Helm chart 升级逻辑的 Edge 版本标记。

将 fleets/day2/system-upgrade-controller-plans/eib-chart-upgrade Fleet 目录复制到将由 Fleet 用来执行 GitOps 的储存库。

提取您要升级到的 Helm chart 存档：

helm pull [chart URL | repo/chartname]

# Alternatively if you want to pull a specific version:
# helm pull [chart URL | repo/chartname] --version 0.0.0

对提取的 chart 存档进行编码：

# Encode the archive and disable line wrapping
base64 -w 0 <chart-archive>.tgz

配置您在步骤 2 中复制的 eib-chart-upgrade Fleet 目录下的 eib-chart-upgrade-user-data.yaml 密钥：

配置一个 GitRepo 资源用于传送 chart 升级 fleet。有关 GitRepo 的详细信息，请参见 GitRepo 资源。

确定我们要从中获取升级逻辑的 Edge 版本标记。例如，此示例将使用 release-3.0.1 版本标记，它支持的 Longhorn 版本为 1.6.1。

克隆 release-3.0.1 版本标记，并将 fleets/day2/system-upgrade-controller-plans/eib-chart-upgrade 目录复制到我们自己的储存库。

为简单起见，本节将根据 suse-edge/fleet-examples 储存库的某个分支介绍操作步骤，因此目录结构是相同的，但您可以将 eib-chart-upgrade Fleet 目录放入您的储存库中的任何位置。

目录结构示例：

.
...
|-- fleets
|   `-- day2
|       `-- system-upgrade-controller-plans
|           `-- eib-chart-upgrade
|               |-- eib-chart-upgrade-script.yaml
|               |-- eib-chart-upgrade-user-data.yaml
|               |-- fleet.yaml
|               `-- plan.yaml
...

添加 Longhorn chart 储存库：

helm repo add longhorn https://charts.longhorn.io

提取 Longhorn chart 版本 1.6.1：

helm pull longhorn/longhorn --version 1.6.1

这会将 Longhorn 作为名为 longhorn-1.6.1.tgz 的存档来提取。

对 Longhorn 存档进行编码：

base64 -w 0 longhorn-1.6.1.tgz

这会输出该存档的采用 base64 编码的单行字符串。

现在我们已准备好全部所需的数据，可以配置 eib-chart-upgrade-user-data.yaml 文件。文件配置应如下所示：

apiVersion: v1
kind: Secret
metadata:
  name: eib-chart-upgrade-user-data
type: Opaque
stringData:
  # <name>|<version>|<base64_encoded_archive>
  chart_upgrade_data.txt: |
    longhorn|1.6.1|H4sIFAAAAAAA/ykAK2FIUjBjSE02THk5NWIzV...

我们还确定不要在 /tmp 中保留清单备份，因此在 plan.yaml 文件中添加了以下配置：

apiVersion: upgrade.cattle.io/v1
kind: Plan
metadata:
  name: eib-chart-upgrade
spec:
  ...
  upgrade:
    ...
    # For when you want to backup your chart
    # manifest data under a specific directory
    #
    envs:
    - name: MANIFEST_BACKUP_DIR
      value: "/root"

这可以确保将清单备份保存在 /root 目录而不是 /tmp 中。

完成全部所需的配置后，剩下的操作就是创建 GitRepo 资源。此示例通过 Rancher UI 创建 GitRepo 资源。

根据“升级步骤”（第 25.5.3.3.2 节 “升级步骤”）中所述的步骤，我们已经：

按照“监控 SUC 计划”（第 25.2.2.2 节 “监控 SUC 计划”）一节中的指导，检查升级 Pod 的状态。

升级 Pod 成功完成后，我们还需要等待 Helm 控制器创建 Pod 并监控这些 Pod。这些 Pod 将根据升级 Pod 对 HelmChart 清单文件所做的文件更改执行实际升级。

在群集上，转到更多资源 → Helm → HelmChart，然后在 default 名称空间中搜索 longhorn HelmChart 资源：

图 25.14︰ longhorn-single-k3s 上已升级的 Longhorn 版本 #

 

图 25.15︰ longhorn-ha-rke2 上已升级的 Longhorn 版本 #