アップグレード

Verrazzanoをアップグレードする方法

Verrazzanoのインストールは、cert-managerなどのコンポーネントのスタックで構成されます。各コンポーネントには特定のリリース・バージョンがあり、Verrazzano全体のバージョンとは異なる場合があります。Verrazzanoプラットフォーム・オペレータは、Verrazzanoバージョンに関連付けられた各コンポーネントのバージョンを認識しています。最初のVerrazzanoインストールを実行すると、プラットフォーム・オペレータによって各コンポーネントの適切なバージョンがインストールされます。インストール後、1つ以上のコンポーネント・イメージまたはHelmチャートを更新する必要がある場合があります。この更新は、プラットフォーム・オペレータによっても行われ、upgradeと呼ばれます。現在、Verrazzanoはパッチレベルのアップグレードのみを行います。ここでは、コンポーネントに対してhelm upgradeコマンドを発行できます。通常、パッチレベルのアップグレードでは、コンポーネント・イメージが新しいバージョンに置き換えられます。

アプリケーションおよびシステム・ポッドの再起動

Verrazzanoに新しいバージョンのIstioがある場合、Istioプロキシ・サイドカーを含むすべてのポッドを再起動する必要があります。こうすることで、プロキシ・サイドカーの新しいバージョンがポッドに注入されます。Istioプロキシ・サイドカーを含むすべての Verrazzanoポッドが再起動されます。これには、NGINX Ingress ControllerなどのVerrazzanoシステム・ポッドとVerrazzanoアプリケーションが含まれます。WebLogicワークロードの場合、Verrazzanoはすべてのドメインを停止し、アップグレードを実行してから、すべてのドメインを再起動します。他のすべてのワークロードの場合、Verrazzanoはアップグレードの完了時にローリング再起動を実行します。これは、アプリケーションの再起動に関連するユーザーが関与することはなく、アップグレード時に自動的に行われます。

アップグレードのステップ

Verrazzanoプラットフォーム・オペレータの更新とVerrazzanoインストールのアップグレードを区別することが重要です。プラットフォーム・オペレータには、新しいコンポーネント・チャートおよびイメージ・バージョンが含まれるため、インストールをアップグレードする前に更新する必要があります。プラットフォーム・オペレータを更新しても、Verrazzanoインストールのアップグレードが開始されるまで、既存のインストールには影響しません。現在、プラットフォーム・オペレータの更新またはVerrazzanoのインストール・アップグレードをロールバックする方法はありません。

Verrazzanoは、Verrazzano CLIまたはkubectlを使用してアップグレードできます。次の各項を参照してください。

Verrazzanoのアップグレード

1つの簡単なステップで、次のコマンドを使用して、指定したバージョンのVerrazzanoにアップグレードできます

Verrazzanoリソースを希望するバージョンに更新します。

最新バージョンに更新するには(デフォルト):
```
$ vz upgrade
```
特定のバージョンに更新するには(<version>が目的のバージョンです):
```
$ vz upgrade --version <version>
```
アップグレードが完了するまで待ちますアップグレードが完了するか、デフォルトのタイムアウト(30分)に達するまで、アップグレード・ログがコマンド・ウィンドウにストリーミングされます。

既存のVerrazzanoインストールのアップグレードは、次の2ステップのプロセスです:

Verrazzanoプラットフォーム・オペレータの目的のVerrazzanoリリース・バージョンへの更新。
Verrazzanoインストールのアップグレード。

Verrazzanoプラットフォーム・オペレータの更新

既存のVerrazzanoインストールをアップグレードするには、まずVerrazzanoプラットフォーム・オペレータを更新する必要があります。

Verrazzanoプラットフォーム・オペレータを更新します。

ノート: プライベート・コンテナ・レジストリを使用している場合は、プラットフォーム・オペレータを更新するには、プライベート・レジストリの使用の手順に従います。

最新バージョンに更新するには:
```
$ kubectl apply -f https://github.com/verrazzano/verrazzano/releases/download/v1.4.8/verrazzano-platform-operator.yaml
```
特定のバージョンに更新するには(<version>が目的のバージョンです):
```
# To update to version v1.4.0:
$ kubectl apply -f https://github.com/verrazzano/verrazzano/releases/download/<version>/verrazzano-platform-operator.yaml

# To update to a version prior to v1.4.0:
$ kubectl apply -f https://github.com/verrazzano/verrazzano/releases/download/<version>/operator.yaml
```

デプロイが完了するまで待ちます。

$ kubectl -n verrazzano-install rollout status deployment/verrazzano-platform-operator

# Expected response
deployment "verrazzano-platform-operator" successfully rolled out

オペレータ・ポッドが正しく定義され、実行中であることを確認します。

$ kubectl -n verrazzano-install get pods

# Sample output
NAME                                            READY   STATUS    RESTARTS   AGE
verrazzano-platform-operator-59d5c585fd-lwhsx   1/1     Running   0          114s

Verrazzanoのアップグレード

Verrazzanoインストールをアップグレードするには、インストールされているVerrazzanoリソースのバージョンをVerrazzanoプラットフォーム・オペレータでサポートされているバージョンに変更する必要があります。

ノート: アップグレード時、versionフィールドのみ変更できます。現時点では、他のフィールドやコンポーネント構成への変更はサポートされていません。

1つの簡単なステップで、次のコマンドを使用して、指定したバージョンのVerrazzanoにアップグレードできます

$ kubectl patch vz example-verrazzano -p '{"spec":{"version":"v1.4.8"}}' --type=merge

または、次のステップを使用して、Verrazzanoインストールをアップグレードできます

Verrazzanoリソースを希望するバージョンに更新します。

Verrazzanoコンポーネントをアップグレードするには、Verrazzanoリソース仕様のversionフィールドを、アップグレードしたプラットフォーム・オペレータがサポートしているバージョンと一致するように更新し、クラスタに適用する必要があります。

リソース仕様のversionフィールドの値は、有効なVerrazzanoリリース・バージョンに対応するセマンティック・バージョニング値である必要があります。

リソースを更新するには、次のいずれかを行います:

a.Verrazzanoのインストールに使用したYAMLファイルを編集し、versionフィールドを最新バージョンに設定します。

For example, to upgrade to v1.4.8, your YAML file should be edited to add or update the version field.
```
apiVersion: install.verrazzano.io/v1beta1
kind: Verrazzano
metadata:
  name: example-verrazzano
spec:
  profile: dev
  version: v1.4.8
```
次に、リソースをクラスタに適用します(kubectl editを使用してリソースをインプレースで編集していない場合)。
```
$ kubectl apply -f example-verrazzano.yaml
```
b.kubectlを使用してVerrazzanoリソースを直接編集し、次のようにversionフィールドを直接設定します:
```
$ kubectl edit verrazzano example-verrazzano
# In the resource editor, add or update the version field to "version: v1.4.8", then save.
```

アップグレードが完了するまで待ちます

$ kubectl wait \
    --timeout=30m \
    --for=condition=UpgradeComplete verrazzano/example-verrazzano

アップグレードの検証

verrazzano-systemネームスペースのすべてのポッドがRunning状態であることを確認します。アップグレードの進行中は、新しいバージョンのコンポーネントが適用されるため、いくつかのポッドが終了し、再起動する場合があります。次に例を示します:

$ kubectl get pods -n verrazzano-system

# Sample output
coherence-operator-866798c99d-r69xt                1/1     Running   1          43m
fluentd-f9fbv                                      2/2     Running   0          38m
fluentd-n79c4                                      2/2     Running   0          38m
fluentd-xslzw                                      2/2     Running   0          38m
oam-kubernetes-runtime-56cdb56c98-wn2mb            1/1     Running   0          43m
verrazzano-application-operator-7c95ddd5b5-7xzmn   1/1     Running   0          42m
verrazzano-authproxy-594d8c8dcd-llmlr              2/2     Running   0          38m
verrazzano-console-74dbf97fdf-zxvvn                2/2     Running   0          38m
verrazzano-monitoring-operator-6fcf8484fd-gfkhs    1/1     Running   0          38m
verrazzano-operator-66c8566f95-8lbs6               1/1     Running   0          38m
vmi-system-es-master-0                             2/2     Running   0          38m
vmi-system-grafana-799d79648d-wsdp4                2/2     Running   0          38m
vmi-system-kiali-574c6dd94d-f49jv                  2/2     Running   0          41m
vmi-system-kibana-77f8d998f4-zzvqr                 2/2     Running   0          38m
weblogic-operator-7b447fdb47-wlw64                 2/2     Running   0          42m

アプリケーション・ネームスペースのポッドの準備ができていることを確認します。次に例を示します:

$ kubectl get pods -n todo-list

# Sample output
NAME                     READY   STATUS    RESTARTS   AGE
mysql-67575d8954-d4vkm   2/2     Running   0          39h
tododomain-adminserver   4/4     Running   0          39h

アップグレード失敗

Verrazzano 1.3以降では、アップグレードは、成功するまで、あるいはVerrazzano CRを削除するまで実行し続けます。以前のバージョンでは、アップグレードが失敗して、UpgradeFailed状態に移行する可能性があります。これが発生したとき、Verrazzanoプラットフォーム・オペレータを1.3+に更新していた場合には、Verrazzano CRがUpgradePausedに変わります。アップグレードを続行するには、CRバージョンをVerrazzanoプラットフォーム・オペレータの現在のバージョンに変更する必要があります。次のステップでこのシナリオについて説明します:

Verrazzano 1.1.2をインストールします。
Verrazzano CRバージョン・フィールドをv1.2.0に変更して、1.2.0にアップグレードします。
- なんらかの理由でアップグレードが失敗し、Verrazzano CR状態がUpgradeFailedに変わります。
Verrazzanoプラットフォーム・オペレータを1.3.0に更新します。
- Verrazzano CR状態がUpgradePausedに変わります。
Verrazzano CRバージョン・フィールドをv1.3.0に変更します。
- Verrazzano CR状態がUpgradingに変わり、完了するまではその状態ですが、その後UpgradeCompleteに変わります。

アップグレードの詳しい進行状況を確認するには、次のコマンドでログを表示します

$ kubectl logs -n verrazzano-install \
    -f $(kubectl get pod \
    -n verrazzano-install \
    -l app=verrazzano-platform-operator \
    -o jsonpath="{.items[0].metadata.name}") | grep '^{.*}$' \
    | jq -r '."@timestamp" as $timestamp | "\($timestamp) \(.level) \(.message)"'

マルチクラスタVerrazzanoのアップグレード

マルチクラスタVerrazzano環境をアップグレードする方法

フィードバック

このページは役に立ちましたか。

ありがとうございます。お気づきの点がございましたら、お聞かせください。

申し訳ございません。お気づきの点がございましたら、お聞かせください。