25 ダウンストリームクラスタ #

左上隅で、☰ → ［Continuous Delivery (継続的デリバリ)］に移動します。

［Git Repos (Gitリポジトリ)］→［ Add Repository (リポジトリの追加)］に移動します。

Repository URL (リポジトリのURL) - https://github.com/suse-edge/fleet-examples.git

［Watch (ウォッチ)］→［Revision (リビジョン)］ - 使用するsuse-edge/fleet-examplesリポジトリのリリースタグを選択します(release-3.0.1など)。

［Paths (パス)］の下に、system-upgrade-controllerへのパスを、リリースタグ - fleets/day2/system-upgrade-controllerのとおりに追加します。

［Next (次へ)］を選択して、ターゲットの設定セクションに移動します。

system-upgrade-controllerをデプロイするクラスタのみを選択します。 設定に問題がなければ、［Create (作成)］をクリックします。

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 (継続的デリバリ)］に移動します。

［Advanced (詳細)］>［Bundles (バンドル)］ に移動します。

［Create from YAML (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 Repos (Gitリポジトリ)］→［ Add Repository (リポジトリの追加)］に移動します。

Repository URL (リポジトリのURL) - https://github.com/suse-edge/fleet-examples.git

［Watch (ウォッチ)］ → ［Revision (リビジョン)］ - 使用するsuse-edge/fleet-examplesリポジトリのリリースタグを選択します。

［Paths (パス)］に、使用するOSパッケージ更新用のFleetのパスfleets/day2/system-upgrade-controller-plans/os-pkg-updateを追加します。

［Next (次へ)］を選択してターゲットの設定セクションに移動します。アップグレードするノードのパッケージを含むクラスタのみを選択してください。

作成します

OSのSUC更新Planの適用元にする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 (継続的デリバリ)］をクリックします。

［Advanced (詳細)］>［Bundles (バンドル)］ に移動します。

［Create from YAML (YAMLから作成)］を選択します。

ここから次のいずれかの方法でバンドルを作成できます。

バンドルのターゲットクラスタを次のように変更します。

［Create (作成)］を選択します。

OSパッケージの更新SUC Planの適用元にする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 Repos (Gitリポジトリ)］→［ Add Repository (リポジトリの追加)］に移動します。

Repository URL (リポジトリのURL) - https://github.com/suse-edge/fleet-examples.git

［Watch (ウォッチ)］ → ［Revision (リビジョン)］ - 使用するsuse-edge/fleet-examplesリポジトリのリリースタグを選択します。

［Paths (パス)］の下に、KubernetesディストリビューションのアップグレードFleetへのパスを、リリースタグに表示されているとおりに追加します。

［Next (次へ)］を選択し、ターゲットの設定セクションに移動します。目的のKubernetesディストリビューションをアップグレードするクラスタのみを選択します

作成します

Kubernetes SUCアップグレードPlanを適用する目的の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 (継続的デリバリ)］をクリックします。

［Advanced (詳細)］>［Bundles (バンドル)］ に移動します。

［Create from YAML (YAMLから作成)］を選択します。

ここから次のいずれかの方法でバンドルを作成できます。

バンドルのターゲットクラスタを次のように変更します。

作成します

Kubernetes SUCアップグレードPlanを適用する目的の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

チャートのFleetリソースを、使用するEdgeリリースタグから取得します。

このワークフローでは最初に、チャートのアップグレード先にする新しいHelmチャートアーカイブをユーザがプルします。

続いて、アーカイブをエンコードし、関連するSUC PlanのFleetディレクトリにあるeib-chart-upgrade-user-data.yamlファイルに設定として渡す必要があります。これは、アップグレード手順(25.5.3.3.2項 「アップグレード手順」)のセクションで詳しく説明しています。

ユーザは次の操作に進み、必要なすべてのリソース(SUC Plan、シークレットなど)をダウンストリームクラスタに配布するGitRepoリソースを設定してデプロイします。

Fleet (第6章 「Fleet」)はデプロイされたリソースを検出し、設定されているすべてのリソースを指定のダウンストリームクラスタにデプロイします。デプロイされたリソースには次のようなものがあります。

eib-chart-upgrade SUC Planがデプロイされると、SUCは、アップグレードPodをデプロイするジョブを選択して作成します。

デプロイされると、アップグレードPodは、eib-chart-upgrade-scriptシークレットとeib-chart-upgrade-user-dataシークレットをマウントし、eib-chart-upgrade-scriptシークレットによって配布されるアップグレードスクリプトを実行します。

アップグレードスクリプトは以下を実行します。

アップグレードスクリプトが正常に実行されると、RKE2/K3sのHelm統合が変更を検出し、Helmチャートのアップグレードを自動的にトリガします。

Helmチャートアップグレードのロジックのコピー元のEdge リリースタグを特定します。

fleets/day2/system-upgrade-controller-plans/eib-chart-upgrade Fleetを、FleetでGitOpsを行うために使用するリポジトリにコピーします。

アップグレード先のHelmチャートアーカイブをプルします。

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

プルしたチャートアーカイブをエンコードします。

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

手順2でコピーしたeib-chart-upgrade Fleetにあるeib-chart-upgrade-user-data.yamlシークレットを設定します。

チャートアップグレードのfleetを配布するGitRepoリソースを設定します。GitRepoの詳細については、「GitRepo Resource (GitRepoリソース)」を参照してください。

アップグレードロジックを取得するEdgeリリースタグを特定します。たとえば、この例では、サポートされているLonghornバージョンが1.6.1であるrelease-3.0.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チャートリポジトリを追加します。

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

Longhornチャートバージョン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でエンコードされた長い1行の文字列で出力されます。

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"

これにより、マニフェストのバックアップは、/tmpではなく/rootディレクトリに保存されます。

これで必要な設定はすべて完了したので、後はGitRepoリソースを作成するだけです。この例では、Rancher UIを使用してGitRepoリソースを作成します。

アップグレード手順(25.5.3.3.2項 「アップグレード手順」)で説明されている手順に従い、次の項目を実行しました。

「SUC Planの監視」(25.2.2.2項 「SUC Planの監視」)のセクションの指示に従い、アップグレードPodのステータスを確認します。

アップグレードPodが正常に完了した後は、Helmコントローラによって作成されるPodについても待機して監視する必要があります。これらのPodは、アップグレードPodがHelmChartマニフェストファイルに加えたファイルの変更に基づいて、実際のアップグレードを行います。

クラスタ上で、［More Resources (追加のリソース)］ → ［Helm］ → ［HelmCharts］に移動し、longhorn HelmChartリソースをdefaultネームスペース内で検索する必要があります。

図 25.14: longhorn-single-k3のアップグレードされたLonghornバージョン #

 

図 25.15: longhorn-ha-rke2のアップグレードされたLonghornバージョン #