Apigee ハイブリッドのバージョン 1.9 へのアップグレード

この手順では、Apigee ハイブリッドバージョン 1.8.x から Apigee ハイブリッドバージョン 1.9.4 へのアップグレードと、ハイブリッド 1.9.x の以前のリリースからバージョン 1.9.4 へのアップグレードについて説明します。

マイナーバージョンのアップグレード（バージョン 1.8 から 1.9 など）とパッチリリースアップグレード（1.9.0 から 1.9.4 など）にも同じ手順を使用します。

Apigee ハイブリッドのバージョン 1.7 以前からアップグレードする場合は、ハイブリッドのバージョン 1.9.4 にアップグレードする前に、まずバージョン 1.8 にアップグレードする必要があります。Apigee ハイブリッドバージョン 1.8 へのアップグレードの手順をご覧ください。

バージョン 1.9.0 以降、Apigee ハイブリッドは Ingress レイヤとして Apigee Ingress ゲートウェイのみをサポートしています。

バージョン 1.9.4 へのアップグレードの概要

Apigee ハイブリッドのバージョン 1.9 へのアップグレードには、ダウンタイムが発生する場合があります。

Apigee コントローラをバージョン 1.9.4 にアップグレードすると、すべての Apigee デプロイでローリング再起動が行われます。本番環境ハイブリッド環境のダウンタイムを最小限に抑えるには、少なくとも 2 つのクラスタ（同じまたは異なるリージョン / データセンター）を実行している必要があります。本番環境のすべてのトラフィックを 1 つのクラスタに戻し、オフラインでアップグレードしようとしているクラスタを取得して、アップグレードプロセスを続行します。この手順をクラスタごとに繰り返します。

Apigee では、本番環境への影響の可能性を軽減するため、すべてのクラスタをできるだけ早くアップグレードすることをおすすめします。最初のクラスタをアップグレードした後に、残りのすべてのクラスタをいつアップグレードする必要があるかについては、時間制限はありません。ただし、残りのクラスタがすべてアップグレードされるまで、次に示すオペレーションが影響を受けます。

Cassandra のバックアップと復元は、混在バージョンでは機能しません。たとえば、ハイブリッド 1.8 のバックアップは、ハイブリッド 1.9 インスタンスの復元には使用できません。
Cassandra データストリーミングは、ハイブリッドの混合バージョンでは機能しません。したがって、Cassandra クラスタを水平スケーリングすることはできません。
リージョンの拡張とデコミッションが影響を受けます（これらのオペレーションは Cassandra データストリーミングに依存しています）。

以降のセクションでは、Apigee ハイブリッドのアップグレード手順を次の順番で説明します。

アップグレードを準備する。
ハイブリッドランタイムのバージョン 1.9.4 をインストールする。

前提条件

以下のアップグレード手順は、Apigee ハイブリッドバージョン 1.8.x がインストールされており、バージョン 1.9.4 にアップグレードすることを前提としています。それ以前のバージョンから更新する場合は、Apigee ハイブリッドバージョン 1.8 へのアップグレードをご覧ください。
Apigee ハイブリッドバージョン 1.8 では、Anthos Service Mesh に代わる Ingress レイヤとして Apigee Ingress ゲートウェイが導入されました。バージョン 1.9.0 以降の Apigee ハイブリッドでは、Apigee Ingress ゲートウェイを使用する必要があり、Ingress に Anthos Service Mesh は使用できません。アップグレード元のインストールで Anthos Service Mesh を使用している場合は、まず Apigee Ingress ゲートウェイを使用するように移行してからバージョン 1.9.4 にアップグレードする必要があります。
Apigee Ingress ゲートウェイでは、Ingress ゲートウェイ用に Anthos Service Mesh 機能の小さなサブセットを使用します。これらの機能の管理とアップグレードは、Apigee ハイブリッドによって自動的に処理されます。したがって、Apigee ハイブリッド Ingress ゲートウェイのインストール、アップグレード、管理を行うために Anthos Service Mesh の専門知識は必要ありません。

手順については、ハイブリッド v1.8 ドキュメントの Apigee Ingress ゲートウェイへの移行をご覧ください。

バージョン 1.9 へのアップグレードを準備する

ハイブリッドインストールをバックアップする（推奨）

この手順では、apigeectl をインストールしたファイルシステム内のディレクトリを環境変数 APIGEECTL_HOME で表しています。必要に応じて、ディレクトリを apigeectl ディレクトリに変更し、次のコマンドで変数を定義します。
Linux
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
macOS
```
export APIGEECTL_HOME=$PWD
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
echo %APIGEECTL_HOME%
```
バージョン 1.8 の $APIGEECTL_HOME/ ディレクトリのバックアップを作成します。次に例を示します。
```
tar -czvf $APIGEECTL_HOME/../apigeectl-v1.8-backup.tar.gz $APIGEECTL_HOME
```
Cassandra のバックアップと復元の手順に沿って Cassandra データベースをバックアップします。

Apigee ランタイムのサービスアカウントに Cloud Trace エージェントロールを追加します。（省略可）

省略可: Cloud Trace を使用する予定で、ハイブリッド v1.8 のインストールに Cloud Trace Agent ロールをまだ追加していない場合は、Apigee ランタイムサービス用のサービスアカウントに Cloud Trace エージェントの Google Cloud IAM ロール（roles/cloudtrace.agent）が付与されていることを確認します。

本番環境の場合、ランタイムサービスアカウントは apigee-runtime です。非本番環境の場合、ランタイムサービスアカウントは apigee-non-prod です。

ロールを追加するには、UI の [Cloud コンソール] > [IAM と管理] > [サービスアカウント] か、次のコマンドを使用します。

次のコマンドでサービスアカウントのメールアドレスを取得します。
本番環境
```
gcloud iam service-accounts list --filter "apigee-runtime"
```
メールアドレスがパターン apigee-runtime@$ORG_NAME.iam.gserviceaccount.com と一致する場合、そのパターンを次のステップで使用できます。
非本番環境
```
gcloud iam service-accounts list --filter "apigee-non-prod"
```
パターン apigee-non-prod@$ORG_NAME.iam.gserviceaccount.com と一致する場合、そのパターンは次のステップで使用できます。

サービスアカウントに Cloud Trace エージェントのロールを割り当てます。

本番環境

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-runtime@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

非本番環境

gcloud projects add-iam-policy-binding $PROJECT_ID \
    --member="serviceAccount:apigee-non-prod@$PROJECT_ID.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

例

gcloud projects add-iam-policy-binding hybrid-example-project \
    --member="serviceAccount:apigee-runtime@hybrid-example-project.iam.gserviceaccount.com" \
    --role="roles/cloudtrace.agent"

ここで、$PROJECT_ID は Apigee ハイブリッドがインストールされている Google Cloud プロジェクトの名前です。

注: インストールでサービスアカウントにカスタム名を使用している場合は、コマンドの apigee-runtime または apigee-non-prod の代わりにその名前を使用します。

インストールで Anthos Service Mesh を使用している場合は、Apigee Ingress ゲートウェイをインストールします。

バージョン 1.9 以降、Apigee ハイブリッドでは Ingress に対する Anthos Service Mesh の使用がサポートされなくなりました。ハイブリッドのインストールで Anthos Service Mesh を使用している場合は、ハイブリッドバージョン 1.9 をインストールする前に、現在のインストールを Apigee Ingress ゲートウェイに移行する必要があります。

ingressGateways プロパティをオーバーライドファイルに追加します。
構文
```
  ingressGateways:
  - name: INGRESS_NAME
    replicaCountMin: REPLICAS_MIN
    replicaCountMax: REPLICAS_MAX
    resources:
      requests:
        cpu: CPU_COUNT_REQ
        memory: MEMORY_REQ
      limits:
        cpu: CPU_COUNT_LIMIT
        memory: MEMORY_LIMIT
    svcAnnotations:  # optional. See Known issue 243599452.
      SVC_ANNOTATIONS_KEY: SVC_ANNOTATIONS_VALUE
    svcLoadBalancerIP: SVC_LOAD_BALANCER_IP # optional
```
例
```
  ingressGateways:
  - name: prod1
    replicaCountMin: 2
    replicaCountMax: 100
    resources:
      requests:
        cpu: 1
        memory: 1Gi
      limits:
        cpu: 2
        memory: 2Gi
    svcAnnotations:  # optional. See Known issue 243599452.
      networking.gke.io/load-balancer-type: "Internal"
    svcLoadBalancerIP: 198.252.0.123 
```
- INGRESS_NAME は、Ingress デプロイの名前です。次の要件を満たす任意の名前を使用できます。
  - 最大文字数が 17 文字
  - 小文字の英数字またはハイフン（-）のみを使用する
  - 先頭が英数字である
  - 末尾が英数字である
  構成プロパティリファレンスの ingressGateways[].name をご覧ください。
- REPLICAS_MIN と REPLICAS_MAX は、インストールにおける Apigee Ingress ゲートウェイの最小レプリカ数と最大レプリカ数です。詳細とデフォルト設定については、構成プロパティリファレンスの ingressGateways[].replicaCountMin および ingressGateways[].replicaCountMax をご覧ください。
- CPU_COUNT_REQ と MEMORY_REQ は、インストール環境における Apigee Ingress ゲートウェイの各レプリカに対する CPU とメモリのリクエストです。
  すでに overlay.yaml ファイルなどで Anthos Service Mesh Ingress ゲートウェイにこれらのプロパティを設定している場合は、設定します。
  
  詳細とデフォルト設定については、構成プロパティリファレンスの ingressGateways[].resources.requests.cpu および ingressGateways[].resources.requests.memory をご覧ください。
- CPU_COUNT_LIMIT と MEMORY_LIMIT は、インストールされている Apigee Ingress ゲートウェイの各レプリカに対する CPU とメモリの上限値です。
  すでに overlay.yaml ファイルなどで Anthos Service Mesh Ingress ゲートウェイにこれらのプロパティを設定している場合は、設定します。
  
  詳細とデフォルト設定については、構成プロパティリファレンスの ingressGateways[].resources.limits.cpu および ingressGateways[].resources.limits.memory をご覧ください。
- SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE（省略可）:
  注: overrides.yaml の ingressGateways[].svcAnnotations フィールドは期待どおりに機能しません。既知の問題 243599452 をご覧ください。
  これは、デフォルトの Ingress サービスのアノテーションを提供する Key-Value ペアです。アノテーションは、ハイブリッドインストールの構成をサポートするために、クラウドプラットフォームによって使用されます。たとえば、ロードバランサのタイプを内部または外部に設定する場合などです。次に例を示します。
```
ingressGateways:
    svcAnnotations:
      networking.gke.io/load-balancer-type: "Internal"
```
  アノテーションは、プラットフォームによって異なります。必須アノテーションと推奨アノテーションについては、プラットフォームのドキュメントをご覧ください。
  
  注: Apigee Ingress ゲートウェイの公開に記載のように、上り（内向き）デプロイ用に独自の Kubernetes Service を作成する場合、Annotations を設定する必要はありません。
  構成プロパティリファレンスの ingressGateways[].svcAnnotations をご覧ください。
- SVC_LOAD_BALANCER_IP（省略可）ロードバランサに静的 IP アドレスを割り当てることができます。ロードバランサの IP アドレスの指定をサポートするプラットフォームでは、この IP アドレスを使用してロードバランサが作成されます。ロードバランサの IP アドレスを指定できないプラットフォームでは、このプロパティは無視されます。
  ロードバランサに静的 IP アドレスが割り振られていない場合は、このプロパティをオーバーライドファイルに含めないでください。
  
  注意: 現在の istio-ingressgateway と同じ IP アドレスは指定しないでください。指定すると、サービスがクラスタで実行されているときに問題が発生する可能性があります。
  
  注: Apigee Ingress ゲートウェイの公開に記載のように、上り（内向き）デプロイ用に独自の Kubernetes Service を作成する場合、LoadBalancerIP を設定する必要はありません。
  構成プロパティリファレンスの ingressGateways[].svcLoadBalancerIP をご覧ください。
次のコマンドを使用して変更を適用し、Apigee Ingress ゲートウェイをインストールします。
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```
Apigee Ingress ゲートウェイを公開します。Apigee Ingress ゲートウェイの公開の手順を実施します。
プロキシを呼び出して、新しい Ingress ゲートウェイをテストします。現在デプロイされている重要なプロキシをすべてテストするのが理想的です。
トラフィックを切り替えるには、新しい Apigee Ingress ゲートウェイの IP アドレスを指すように DNS レコードを更新します。DNS プロバイダによっては、トラフィックを新しいエンドポイントに段階的にシフトできる可能性があります。
ヒント: Apigee Ingress ゲートウェイの外部 IP アドレスは、次のコマンドを使用して確認できます。
```
kubectl get svc -n apigee -l app=apigee-ingressgateway
```
出力は次のようになります。
```
NAME                                        TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)                                      AGE
apigee-ingressgateway-prod-hybrid-37a39bd   LoadBalancer   192.0.2.123   233.252.0.123   15021:32049/TCP,80:31624/TCP,443:30723/TCP   16h
```
ダッシュボードをモニタリングして、すべてのランタイムトラフィックが機能していることを確認します。すべてが想定どおりに動作している場合にのみ、次の手順に進みます。DNS キャッシュが原因で DNS 更新の伝播に時間がかかることがあるため、古い Ingress ゲートウェイ（Anthos Service Mesh）を経由するトラフィックがないことを確認します。
Apigee から Anthos Service Mesh への構成の提供を停止するには、Apigee Ingress ゲートウェイの管理ガイドの ASM への構成の提供を停止するの手順を実施します。
API プロキシトラフィックを再度テストしてモニタリングします。
Anthos Service Mesh のドキュメントの手順に沿って、クラスタから Anthos Service Mesh をアンインストールします。

ハイブリッド 1.9.4 ランタイムをインストールする

現在のディレクトリがハイブリッドベースディレクトリ（apigeectl 実行可能ファイルが配置されているディレクトリの親）であることを確認します。
```
cd $APIGEECTL_HOME/..
```

次のコマンドを使用して、ご使用のオペレーティングシステムに対応したリリースパッケージをダウンロードします。ご利用のプラットフォームを次の表から選択します。

Linux

Linux 64 ビット:

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_linux_64.tar.gz

macOS

Mac 64 ビット:

curl -LO \
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_mac_64.tar.gz

Windows

Windows 64 ビット:

curl -LO ^
  https://storage.googleapis.com/apigee-release/hybrid/apigee-hybrid-setup/1.9.4/apigeectl_windows_64.zip

現在の apigeectl/ ディレクトリをバックアップディレクトリ名に変更します。次に例を示します。
Linux
```
mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/
```
macOS
```
mv $APIGEECTL_HOME/ $APIGEECTL_HOME-v1.8/ 
```
Windows
```
rename %APIGEECTL_HOME% %APIGEECTL_HOME%-v1.8 
```
ダウンロードした gzip ファイルの内容をハイブリッドのベースディレクトリに展開します。ハイブリッドのベースディレクトリは、名前を変更した apigeectl-v1.8 ディレクトリのあるディレクトリです。
Linux
```
tar xvzf filename.tar.gz -C ./
```
macOS
```
tar xvzf filename.tar.gz -C ./
```
Windows
```
tar xvzf filename.zip -C ./
```
デフォルトでは、tar の内容が展開されるディレクトリの名前には、バージョンとプラットフォームが含まれています。たとえば、./apigeectl_1.9.4-xxxxxxx_linux_64 となります。次のコマンドを使用して、このディレクトリの名前を apigeectl に変更します。
Linux
```
mv apigeectl_1.9.4-xxxxxxx_linux_64 apigeectl
```
macOS
```
mv apigeectl_1.9.4-xxxxxxx_mac_64 apigeectl
```
Windows
```
rename apigeectl_1.9.4-xxxxxxx_windows_64 apigeectl
```
apigeectl ディレクトリに移動します。
```
cd ./apigeectl
```
このディレクトリは apigeectl ホームディレクトリになります。apigeectl 実行可能コマンドはこのディレクトリに配置されます。
この手順では、apigeectl ユーティリティがインストールされているファイルシステムのディレクトリを環境変数 $APIGEECTL_HOME で表しています。必要に応じて、ディレクトリを apigeectl ディレクトリに変更し、次のコマンドで変数を定義します。
Linux
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
macOS
```
export APIGEECTL_HOME=$PWD
```
```
echo $APIGEECTL_HOME
```
Windows
```
set APIGEECTL_HOME=%CD%
```
```
echo %APIGEECTL_HOME%
```
version コマンドで apigeectl のバージョンを確認します。
```
./apigeectl version
```
```
Version: 1.9.4
```
hybrid-base-directory/hybrid-files ディレクトリに移動します。hybrid-files ディレクトリには、オーバーライドファイル、証明書、サービスアカウントなどの構成ファイルがあります。次に例を示します。
```
cd $APIGEECTL_HOME/../hybrid-files
```
次のコマンドを使用して、kubectl が正しいコンテキストに設定されていることを確認します。現在のコンテキストは、Apigee ハイブリッドをアップグレードするクラスタに設定する必要があります。
```
kubectl config get-contexts | grep \*
```
hybrid-files ディレクトリ:
1. 以下の $APIGEECTL_HOME へのシンボリックリンクを更新します。このリンクを使用すると、hybrid-files ディレクトリ内から新しくインストールされた apigeectl コマンドを実行できます。
```
ln -nfs $APIGEECTL_HOME/tools tools
ln -nfs $APIGEECTL_HOME/config config
ln -nfs $APIGEECTL_HOME/templates templates
ln -nfs $APIGEECTL_HOME/plugins plugins
```
2. シンボリックリンクが正しく作成されたことを確認するには、次のコマンドを実行してリンクパスが正しい場所を指していることを確認します。
```
ls -l | grep ^l
```
ドライランの初期化を行ってエラーを確認します。
```
${APIGEECTL_HOME}/apigeectl init -f OVERRIDES_FILE --dry-run=client
```
ここで、OVERRIDES_FILE はオーバーライドファイルの名前です（例: ./overrides/overrides.yaml）。

ヒント: 上記のコードサンプルの OVERRIDES_FILE をオーバーライドファイルの名前とパスに置き換えると、このページのすべてのインスタンスが置き換えられます。
エラーがなければ、ハイブリッド 1.9.4 を初期化します。
```
$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE
```
注: apigeectl は、apigeectl init の実行時に、Apigee Ingress ゲートウェイをインストールして構成します。
初期化のステータスを確認します。
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
成功すると、「All containers ready.」と出力されます。
```
kubectl describe apigeeds -n apigee
```
出力で「State: running」を探します。
--dry-run フラグを使用して、apply コマンドのドライランでエラーを確認します。
```
$APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --dry-run=client
```
エラーがない場合、オーバーライドを適用します。インストールに応じて、本番環境または非本番環境用の手順を実施します。
本番環境

本番環境では、ハイブリッドコンポーネントを個別にアップグレードし、アップグレードされたコンポーネントのステータスを確認してから次のコンポーネントに進んでください。
1. 現在のディレクトリが hybrid-files ディレクトリであることを確認します。
2. オーバーライドを適用して Cassandra をアップグレードします。
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --datastore
3. 完了を確認します。
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
  ヒント: check-ready が失敗した場合は、次のコマンドで Pod に関する詳細情報を取得できます。
  kubectl -n NAMESPACE get pods
  
  ここで、NAMESPACE は Apigee ハイブリッドの名前空間です。
  Pod の準備ができた場合にのみ、次の手順に進みます。
4. オーバーライドを適用してテレメトリーコンポーネントをアップグレードし、完了を確認します。
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --telemetry
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
5. Redis コンポーネントを起動します。
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --redis
6. オーバーライドを適用して、組織レベルのコンポーネント（MART、Watcher、Apigee Connect）をアップグレードし、完了を確認します。
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --org
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
7. オーバーライドを適用して環境をアップグレードします。次の 2 つの選択肢があります。
  - 環境ごと: 一度に 1 つの環境にオーバーライドを適用して、完了を確認します。この手順を環境ごとに繰り返します。
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --env ENV_NAME
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
    
    ここで、ENV_NAME はアップグレードする環境の名前です。
  - 一度にすべての環境: すべての環境にオーバーライドを一度に適用して、完了を確認します。
    $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --all-envs
    
    $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
8. オーバーライドを適用して virtualhosts コンポーネントをアップグレードし、完了を確認します。
  $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE --settings virtualhosts
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
非本番環境

非本番環境、デモ環境、試験運用版環境の大半では、すべてのコンポーネントに同時にオーバーライドを適用できます。非本番環境が大規模で複雑な場合や、本番環境とよく似ている場合は、本番環境をアップグレードするための手順の実施をおすすめします。
1. 現在のディレクトリが hybrid-files ディレクトリであることを確認します。
2. $APIGEECTL_HOME/apigeectl apply -f OVERRIDES_FILE
3. ステータスを確認します。
  $APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

`1.9.4-hotfix.1` をインストールする

ホットフィックスリリース 1.9.4-hotfix.1 をインストールする手順は次のとおりです。

この手順を実施するには、Apigee ハイブリッドバージョン 1.9.4 以降を使用している必要があります。1.9.4 以降を使用していない場合は、続行する前に 1.9.4 にアップグレードしてください。
overrides.yaml ファイルを開きます。
istiod スタンザで、イメージタグのバージョン（存在する場合）をバージョン 1.17.7 に変更します。次に例を示します。
```
istiod:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-istiod"
    tag: "1.17.7-asm.0-distroless"
```
Apigee ハイブリッドのインストール方法によって、ingressGateway スタンザまたは ingressGateways スタンザを使用できます。オーバーライドファイルにあるスタンザを見つけて、イメージタグのバージョン（存在する場合）をバージョン 1.17.7 に変更します。たとえば、ingressGateway スタンザがあるとします。
```
ingressGateway:
  image:
    url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
    tag: "1.17.7-asm.0-distroless"
```
ingressGateways スタンザの場合は、次のようにします。
```
ingressGateways:
  - name: gateway1
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...
  - name: gateway2
    image:
      url: "gcr.io/apigee-release/hybrid/apigee-asm-ingress"
      tag: "1.17.7-asm.0-distroless"
    ...
  
```
ファイルを保存します。

次のコマンドを実行して、istiod コンポーネントを初期化します。

$APIGEECTL_HOME/apigeectl init -f OVERRIDES_FILE

$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE

次のコマンドを実行して、Apigee Ingress コンポーネントに変更を適用します。複数の組織がある場合は、組織ごとにこのコマンドを繰り返します。
```
$APIGEECTL_HOME/apigeectl apply --org -f OVERRIDES_FILE
```
```
$APIGEECTL_HOME/apigeectl check-ready -f OVERRIDES_FILE
```
Pod のステータスを確認します。
```
kubectl get pods -n YOUR_APIGEE_NAMESPACE
```

Kubernetes のバージョンをアップグレードする

Kubernetes プラットフォームをハイブリッド 1.9 でサポートされているバージョンにアップグレードします。ヘルプが必要な場合は、プラットフォームのドキュメントをご覧ください。

クリックして、サポートされているプラットフォームのリストを開く

	Apigee ハイブリッドのバージョン
プラットフォーム	1.6 ⁽³⁾	1.7 ⁽³⁾	1.8 ⁽³⁾	1.9	1.10
Anthos（Google Cloud - GKE）	1.19.x 1.20.x 1.21.x	1.20.x 1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.21.x ^{(≤ 1.8.3)} 1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
Anthos（AWS）	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	1.10.x 1.11.x 1.12.x 1.13.x 1.25⁽¹³⁾	1.12.x 1.13.x 1.25⁽¹³⁾	1.13.x 1.25⁽¹³⁾ 1.26⁽¹³⁾
Anthos（Azure）	1.8.x	1.9.x 1.10.x 1.12.x ^{(≥ 1.7.2)}	1.10.x 1.11.x 1.12.x 1.13.x 1.14.x	1.12.x 1.13.x 1.14.x	1.13.x 1.14.x 1.15.x
Anthos（オンプレミス - VMware）⁽¹⁾	1.7.x 1.8.x 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x
Anthos（ベアメタル）^（1）	1.7.x 1.8.2+ 1.9.3+ 1.10.x	1.9.x ⁽⁴⁾ 1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ ^{(≥ 1.7.2)} 1.12.x ⁽⁴⁾ ^{(≥ 1.7.2)}	1.10.x ⁽⁴⁾ 1.11.x ⁽⁴⁾ 1.12.x ⁽⁴⁾ ⁽⁵⁾ 1.13.x ⁽⁵⁾ 1.14.x ⁽⁵⁾ 1.15.x	1.12.x ⁽⁴⁾ 1.13.x 1.14.x 1.15.x	1.13.x 1.14.x 1.15.x 1.16.x
EKS^（7）	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
AKS⁽⁷⁾	1.19.x 1.20.x 1.21.x	1.21.x 1.22.x ^{(≥ 1.7.2)} 1.23.x ^{(≥ 1.7.2)}	1.22.x ^{(≤ 1.8.3)} 1.23.x ^{(≤ 1.8.4)} 1.24.x ^{(≥ 1.8.4)} 1.25.x ^{(≥ 1.8.4)}	1.23.x 1.24.x 1.25.x 1.26.x ^{(≥ 1.9.2)}	1.24.x 1.25.x 1.26.x
OpenShift⁽⁷⁾	4.6 4.7 4.8	4.7 4.8	4.8 4.9 4.10	4.10 4.11	4.11 4.12
Rancher Kubernetes Engine（RKE）⁽⁷⁾	なし	なし	なし	1.3.8	v1.26.2+rke2r1
コンポーネント	1.6 ⁽³⁾	1.7 ⁽³⁾	1.8	1.9	1.10
Anthos Service Mesh（ASM）	1.9.x 1.10.x 1.12.x 1.13.x	1.10.x 1.11.x 1.12.x 1.13.x ^{(≥ 1.7.2)} 1.14.x 1.15.x ^{(≥ 1.7.6)}	1.11.x 1.12.x 1.13.x 1.14.x 1.15.x	1.17.x⁽¹¹⁾	1.17.x⁽¹¹⁾
JDK	JDK 11	JDK 11	JDK 11	JDK 11	JDK 11
cert-manager	1.5.4	1.7.x	1.7.x 1.8.x 1.9.x 1.10.x 1.11.x	1.10.x 1.11.x	1.10.x 1.11.x 1.12.x
Cassandra	3.11.10	3.11.10	3.11.10	3.11.10	3.11.10
⁽¹⁾ Anthos バージョン 1.8、1.9、1.10 では、`cert-manager`との競合を回避するために、次のドキュメントに記載されている手順を実施してください。 Anthos 1.8.2 以降: バージョン 1.8.2 以降にアップグレードすると `cert-manager` と競合する。 Anthos 1.9: バージョン 1.9.0 または 1.9.1 にアップグレードすると `cert-manager` と競合する。 Anthos 1.10 以降: `cert-manager` のインストールが競合している。 ⁽²⁾ Apigee ハイブリッドバージョン 1.7.2 以降でサポートされています。 ⁽³⁾ Apigee ハイブリッドバージョン 1.8 以前の正式なサポートが終了しました。今後、定期的な月次パッチは提供されません。サポートの継続が正式に提示されているお客様を除き、これらのリリースの正式なサポートは提供されません。他のお客様はアップグレードが必要です。 ⁽⁴⁾ Anthos on bare metal と VMWare の 1.12 以前のバージョンは、サポートが終了しています。Anthos on bare metal バージョンサポートポリシーと Anthos clusters on VMware のバージョンをご覧ください。 ⁽⁵⁾ Anthos on bare metal と VMWare には ASM 1.14 が必要です。ハイブリッド v1.8 にアップグレードして Apigee Ingress ゲートウェイに切り替えることをおすすめします。これにより、ハイブリッドクラスタに ASM をインストールする必要がなくなります。 ⁽⁶⁾ Apigee ハイブリッドバージョン 1.8.4 以降でサポートされています。 ⁽⁷⁾ Apigee Ingress ゲートウェイを使用する Apigee ハイブリッド v1.8 以降では、接続クラスタを使用する必要はありません。 ⁽⁸⁾ Apigee ハイブリッドバージョン 1.8.4 以降ではサポートされていません。 ⁽⁹⁾ Apigee ハイブリッドバージョン 1.7.6 以降でサポートされています。 ⁽¹⁰⁾ Apigee ハイブリッドバージョン 1.8.5 以降ではサポートされていません。 ⁽¹¹⁾ ASM は Apigee ハイブリッド 1.9 以降で自動的にインストールされます。 ⁽¹²⁾Apigee ハイブリッドバージョン 1.9.2 以降でサポートされています。 ⁽¹³⁾ Anthos clusters on AWS（マルチクラウド）のバージョン番号に Kubernetes のバージョンが反映されるようになりました。バージョンの詳細と推奨パッチについては、Anthos のバージョンとアップグレードのサポートをご覧ください。

接続クラスタについて

Apigee ハイブリッドバージョン 1.7.x 以前で、Elastic Kubernetes Service（EKS）、Azure Kubernetes Service（AKS）、またはサポートされているサードパーティの Kubernetes サービスプロバイダのマルチクラウドコンテキストで Apigee ハイブリッドを実行する場合は、Anthos 接続クラスタを使用する必要があります。Google では、クラスタアタッチメントを使用して Anthos Service Mesh（ASM）の使用状況を測定しています。サードパーティクラスタの登録は任意です。Google Cloud コンソールで接続クラスタを表示する場合にのみ登録が必要になります。詳細については、サードパーティの Kubernetes クラスタを Google Cloud に接続するをご覧ください。

Apigee ハイブリッドバージョン 1.8.x で Ingress ゲートウェイに Anthos Service Mesh を使用する場合、Anthos に関連付けられたクラスタが必要です。Apigee Ingress ゲートウェイを使用している場合、Anthos 接続クラスタはオプションです。

アップグレードのロールバック

以前のアップグレードをロールバックする手順は次のとおりです。

ハイブリッドランタイムの名前空間に対して、完了したジョブのクリーンアップを行います。ここで、名前空間を指定した場合、NAMESPACE はオーバーライドファイルで指定した名前空間になります。指定しない場合、デフォルトの名前空間は apigee です。
```
kubectl delete job -n NAMESPACE \
  $(kubectl get job -n NAMESPACE \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')
```

apigee-system 名前空間で完了したジョブをクリーンアップします。

kubectl delete job -n apigee-system \
  $(kubectl get job -n apigee-system \
  -o=jsonpath='{.items[?(@.status.succeeded==1)].metadata.name}')

以前のバージョンの apigeectl を含むディレクトリを指すように APIGEECTL_HOME 変数を変更します。次に例を示します。
```
export APIGEECTL_HOME=PATH_TO_PREVIOUS_APIGEECTL_DIRECTORY
```
ロールバックするインストールのルートディレクトリで、apigeectl apply を実行し、Pod のステータスを確認してから apigeectl init を実行します。ロールバックするバージョンの元のオーバーライドファイルを必ず使用してください。
1. ハイブリッドファイルディレクトリで、apigeectl apply を実行します。
```
$APIGEECTL_HOME/apigeectl apply -f ORIGINAL_OVERRIDES_FILE
```
  ここで、ORIGINAL_OVERRIDES_FILE は、以前のバージョンのハイブリッドインストールのオーバーライドファイルの相対パスとファイル名です（例: ./overrides/overrides1.8.yaml）。
2. Pod のステータスを確認します。
```
kubectl -n NAMESPACE get pods
```
  ここで、NAMESPACE は Apigee ハイブリッドの名前空間です。
3. apigeeds のステータスを確認します。
```
kubectl describe apigeeds -n apigee
```
  出力は次のようになります。
```
Status:
  Cassandra Data Replication:
  Cassandra Pod Ips:
    10.8.2.204
  Cassandra Ready Replicas:  1
  Components:
    Cassandra:
      Last Successfully Released Version:
        Revision:  v1-f8aa9a82b9f69613
        Version:   v1
      Replicas:
        Available:  1
        Ready:      1
        Total:      1
        Updated:    1
      State:        running
  Scaling:
    In Progress:         false
    Operation:
    Requested Replicas:  0
  State:                 running
```
  apigeeds Pod が実行されている場合にのみ、次の手順に進みます。
4. 次のコマンドを実行して、アップグレード後に Message Processor の新しいレプリカ数の値をメモします。これらの値が、以前に構成した値と一致しない場合は、オーバーライドファイルの値を以前の構成と一致するように変更します。
```
apigeectl apply -f ORIGINAL_OVERRIDES_FILE --dry-run=client --print-yaml --env ENV_NAME 2>/dev/null |grep "runtime:" -A 25 -B 1| grep "autoScaler" -A 2
```
  出力は次のようになります。
```
      autoScaler:
        minReplicas: 2
        maxReplicas: 10
```
5. apigeectl init を実行します。
```
$APIGEECTL_HOME/apigeectl init -f ORIGINAL_OVERRIDES_FILE
```

Apigee ハイブリッドのバージョン 1.9 へのアップグレード

バージョン 1.9.4 へのアップグレードの概要

前提条件

バージョン 1.9 へのアップグレードを準備する

ハイブリッド インストールをバックアップする（推奨）

Linux

macOS

Windows

Apigee ランタイムのサービス アカウントに Cloud Trace エージェント ロールを追加します。（省略可）

本番環境

非本番環境

本番環境

非本番環境

例

インストールで Anthos Service Mesh を使用している場合は、Apigee Ingress ゲートウェイをインストールします。

構文

例

ハイブリッド 1.9.4 ランタイムをインストールする

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

Linux

macOS

Windows

本番環境

非本番環境

1.9.4-hotfix.1 をインストールする

Kubernetes のバージョンをアップグレードする

クリックして、サポートされているプラットフォームのリストを開く

プラットフォーム

コンポーネント

接続クラスタについて

アップグレードのロールバック

ハイブリッドインストールをバックアップする（推奨）

Apigee ランタイムのサービスアカウントに Cloud Trace エージェントロールを追加します。（省略可）

`1.9.4-hotfix.1` をインストールする