この文書は自動機械翻訳技術を使用して翻訳されています。 正確な翻訳を提供するように努めておりますが、翻訳された内容の完全性、正確性、信頼性については一切保証いたしません。 相違がある場合は、元の英語版 英語 が優先され、正式なテキストとなります。

これは未公開の文書です SUSE® Storage 1.12 (Dev).

Longhorn Managerのアップグレード

アップグレードを実行する前に、Longhornシステムバックアップを作成することをお勧めします。これにより、ボリュームやバックイメージなどの重要なリソースがバックアップされ、問題が発生した場合に復元できるようになります。

v1.10.xからのアップグレード

SUSE Storageはv1.10.xからv1.12へのアップグレードのみをサポートしています。他のバージョンについては、まずv1.10.xにアップグレードしてください。

SUSE StorageがRancherアプリとしてインストールされている場合、エアギャップアップグレードのために、イメージ名を変更し、レジストリURL部分を削除する必要があります。

SUSE StorageがRancherアプリとしてインストールされている場合、エアギャップ(された)アップグレードのために、イメージ名を変更し、レジストリURL部分を削除する必要があります。例えば、イメージ`registry.example.com/longhorn/longhorn-manager:v1.12.0`はLonghornイメージセクションで`longhorn/longhorn-manager:v1.12.0`に変更されます。詳細については、エアギャップインストール手順をこちらでご覧ください。

アップグレードの準備

現在のデフォルトのStorageClassには、以下のパラメータがあります：

parameters:
  numberOfReplicas: <user specified replica count, 3 by default>
  staleReplicaTimeout: "30"
  fromBackup: ""
  baseImage: ""

アップグレード

アップグレードする前に、常にボリュームをバックアップしてください。何か問題が発生した場合、バックアップを使用してボリュームを復元できます。

SUSE Rancher Prime UIを使用してアップグレード

SUSE Rancher Primeによって管理されているKubernetesクラスターの場合、リポジトリを更新して新しいHelmチャートバージョンを参照することで、SUSE Storageアプリをアップグレードできます。

以下の手順では、SUSE StorageアプリをSUSE Rancher Primeでアップグレードする方法について説明します。

  1. *アプリ > リポジトリ*に移動します。

  2. ［作成］をクリックします。

  3. ターゲットとして*OCIリポジトリ*を選択します。

  4. リポジトリの名前を指定してください。例えば、suse-storage。

  5. *OCIリポジトリホストURL*フィールドに入力してください：

    oci://dp.apps.rancher.io/charts/suse-storage

    リポジトリを追加

  6. ［Create］ボタンをクリックします。

  7. リポジトリが正常に追加されたことを確認してください。

    リポジトリが追加されました

  8. *アプリ > チャート*に移動し、`suse-storage`チャートを見つけてください。

    チャートを見つける

  9. チャートをクリックし、次に*インストール*をクリックしてください。

    チャートをインストール

  10. 次のページで、`global.imagePullSecrets`を`application-collection`に設定し、次に*インストール*をクリックしてください。

    資格情報の設定については、 認証ドキュメントを参照してください。

    global:
  cattle:
    windowsCluster:
      defaultSetting:
        systemManagedComponentsNodeSelector: kubernetes.io/os:linux
        taintToleration: cattle.io/os=linux:NoSchedule
      enabled: false
      nodeSelector:
        kubernetes.io/os: linux
      tolerations:
        - effect: NoSchedule
          key: cattle.io/os
          operator: Equal
          value: linux
  imagePullSecrets: [application-collection]
  imageRegistry: ''

  11. これにより、suse-storage`が1.12`にアップグレードされます。

    更新リポジトリ

  12. アップグレード後、*アプリ > リポジトリ*に移動してください。

    v2.13より前のSUSE Rancher Primeバージョンの場合は、次の手順に従ってください：

    1. `suse-storage`リポジトリを選択し、縦3点リーダメニューをクリックして、*設定を編集*を選択してください。

    2. *解決策:*バージョンが検出されるように、URLを`oci://dp.apps.rancher.io/charts/suse-storage:1.12.0`に更新してください。

    3. リポジトリは正常に更新されるはずです。

      更新リポジトリ

    4. *アプリ > インストール済みアプリ*に移動してください。

    5. longhorn-system`ネームスペースの*アップグレード可能*列で、黄色でハイライトされた1.12.0`ラベルを探してください。

      アップグレード可能なバージョン

    6. 黄色の`1.12.0`ラベルをクリックして、アップグレードページを開いてください。

      アップグレードページ

    7. 次へ をクリックします。

    8. `global.imagePullSecrets`が`application-collection`に設定されていることを確認し、次に*アップグレード*をクリックしてください。

      アップグレード進行状況

  13. *アプリ > チャート*に移動し、`suse-storage`チャートを選択してください。

  14. *チャートバージョン*パネルから希望のアップグレードバージョンを選択してください。

    Rancher 2.13+での更新リポジトリ

  15. *このバージョンにアップグレード*をクリックしてください。

  16. アップグレードが完了したら、suse-storage`チャートバージョンが1.12.0`に更新されていることを確認してください。

    アップグレード成功

Helmでのアップグレード

SUSE Storage Helmチャートのアップグレードには、デプロイメントを新しいバージョンに更新するか、LonghornコミュニティイメージとSUSE Storageイメージの間で切り替えることが含まれます。

アップグレードのための一般的なHelmコマンドは次のとおりです：

helm upgrade longhorn oci://dp.apps.rancher.io/charts/suse-storage \
  --namespace longhorn-system \
  --version <version> \ # Replace with the version you would like to upgrade to
  --set global.imagePullSecrets=<PULL_IMAGE_SECRET> \
  -f values.yaml

シークレットを作成するには、 AppCoのドキュメントに従ってください。

または、特定の`values.yaml`ファイルなしでアップグレードし、バージョンのみを変更する場合：

helm upgrade longhorn oci://dp.apps.rancher.io/charts/suse-storage \
  --namespace longhorn-system \
  --version <version> \ # Replace with the version you would like to upgrade to
  --set global.imagePullSecrets=<PULL_IMAGE_SECRET>

  • アップグレードパス：特定のバージョン間のアップグレードパス、前提条件、およびアップグレード後の検証手順については、公式のSUSE Storageアップグレードドキュメントを参照してください。これは、スムーズなアップグレードとデータの整合性を確保するために重要です。

  • 設定の変更：カスタム設定がある場合は、それらを新しいチャートバージョンに移行し、デフォルトの変更と統合してください。

Fleetでアップグレード

GitOpsリポジトリの`helm.version` YAMLファイル内の`fleet`の値を更新してください。

helm:
  repo: https://charts.longhorn.io
  chart: longhorn
  version: v1.12.0 # Replace with the SUSE Storage version you would like to upgrade to
  releaseName: longhorn

Fluxでアップグレード

GitOpsリポジトリの`spec.chart.spec.version` YAMLファイル内の`HelmRelease`の値を更新してください。

spec:
  chart:
    spec:
      chart: longhorn
      reconcileStrategy: ChartVersion
      sourceRef:
        kind: HelmRepository
        name: longhorn
      version: v1.12.0 # Replace with the SUSE Storage version you would like to upgrade to

Argo CDでアップグレード

GitOpsリポジトリの`targetRevision` YAMLファイル内の`Application`の値を更新してください。

spec:
  project: default
  sources:
    - chart: longhorn
      repoURL: https://charts.longhorn.io
      targetRevision: v1.12.0 # Replace with the SUSE Storage version you would like to upgrade to

すべてのポッドが実行中になり、SUSE Storage UIが動作するのを待ってください。次に例を示します。

$ kubectl -n longhorn-system get pod
NAME                                                  READY   STATUS    RESTARTS      AGE
engine-image-ei-4dbdb778-nw88l                        1/1     Running   0             4m29s
longhorn-ui-b7c844b49-jn5g6                           1/1     Running   0             75s
longhorn-manager-z2p8h                                1/1     Running   0             71s
instance-manager-b34d5db1fe1e2d52bcfb308be3166cfc     1/1     Running   0             65s
longhorn-driver-deployer-6bd59c9f76-jp6pg             1/1     Running   0             75s
engine-image-ei-df38d2e5-zccq5                        1/1     Running   0             65s
csi-snapshotter-588457fcdf-h2lgc                      1/1     Running   0             30s
csi-resizer-6d8cf5f99f-8v4sp                          1/1     Running   1 (30s ago)   37s
csi-snapshotter-588457fcdf-6pgf4                      1/1     Running   0             30s
csi-provisioner-869bdc4b79-7ddwd                      1/1     Running   1 (30s ago)   44s
csi-snapshotter-588457fcdf-p4kkn                      1/1     Running   0             30s
csi-attacher-7bf4b7f996-mfbdn                         1/1     Running   1 (30s ago)   50s
csi-provisioner-869bdc4b79-4dc7n                      1/1     Running   1 (30s ago)   43s
csi-resizer-6d8cf5f99f-vnspd                          1/1     Running   1 (30s ago)   37s
csi-attacher-7bf4b7f996-hrs7w                         1/1     Running   1 (30s ago)   50s
csi-attacher-7bf4b7f996-rt2s9                         1/1     Running   1 (30s ago)   50s
csi-resizer-6d8cf5f99f-7vv89                          1/1     Running   1 (30s ago)   37s
csi-provisioner-869bdc4b79-sn6zr                      1/1     Running   1 (30s ago)   43s
longhorn-csi-plugin-b2zzj                             2/2     Running   0             24s

次に、Longhorn Engineをアップグレードします。