Apigee Ingress ゲートウェイへの移行

この手順を使用して、既存の Apigee ハイブリッド v1.8 インストールを、Ingress に対して Anthos Service Mesh を使用する設定から Apigee Ingress ゲートウェイを使用する設定に移行します。

Apigee ハイブリッドバージョン 1.8 の Apigee Ingress ゲートウェイ

バージョン 1.8 以降の Apigee ハイブリッドでは、ハイブリッドインストールの Ingress ゲートウェイ（Apigee Ingress ゲートウェイ）を管理する新機能を備えています。Anthos Service Mesh はハイブリッドインストールの前提条件ではなくなり、Apigee では Anthos Service Mesh にルーティング構成が使用できなくなります。アップグレード後、トラフィックを新しい Apigee Ingress ゲートウェイゲートウェイに移行する必要があります。

移行には 2 つのシナリオがあります。

マルチクラスタまたはマルチリージョンの移行（推奨）:
Apigee 用の新しい Ingress に切り替える前に、移行するクラスタから別のクラスタまたはリージョンにすべてのトラフィックをドレインします。これにより、新しい Apigee Ingress ゲートウェイが期待どおりに動作しているかどうかテストできます。その後、アップグレードしたクラスタにトラフィックを戻します。
インプレースアップグレード（本番環境ではおすすめしません）:
アップグレード中に、Apigee によって新しい Ingress ゲートウェイが新しい IP アドレスで起動します。その後、新しい Apigee Ingress ゲートウェイが期待どおりに動作しているかどうかをテストして、トラフィックを新しい Ingress に移行できます。このアップグレード中にダウンタイムが発生する可能性があります。

Apigee Ingress ゲートウェイをインストールする

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 ゲートウェイを公開するに記載のように、ingress Deployment に独自の Kubernetes Service を作成する場合、Annotations を設定する必要はありません。
  構成プロパティリファレンスの ingressGateways[].svcAnnotations をご覧ください。
- SVC_LOAD_BALANCER_IP（省略可）ロードバランサに静的 IP アドレスを割り当てることができます。ロードバランサの IP アドレスの指定をサポートするプラットフォームでは、この IP アドレスを使用してロードバランサが作成されます。ロードバランサの IP アドレスを指定できないプラットフォームでは、このプロパティは無視されます。
  ロードバランサに静的 IP アドレスが割り振られていない場合は、このプロパティをオーバーライドファイルを含めないでください。
  
  注意: 現在の istio-ingressgateway と同じ IP アドレスは指定しないでください。指定すると、サービスがクラスタで実行されているときに問題が発生する可能性があります。
  
  注: Apigee Ingress ゲートウェイの公開に記載のように、Ingress Deployment 用に独自の Kubernetes Service を作成する場合、LoadBalancerIP を設定する必要はありません。
  構成プロパティリファレンスの ingressGateways[].svcLoadBalancerIP をご覧ください。
次のコマンドを使用して変更を適用し、Apigee Ingress ゲートウェイをインストールします。
```
$APIGEECTL_HOME/apigeectl apply -f overrides/overrides.yaml
```

トラフィックを Apigee Ingress ゲートウェイに切り替える

Anthos Service Mesh から Apigee Ingress ゲートウェイにトラフィックを移行するには、Apigee ハイブリッド v1.8 へのアップグレードに関するトピックにある Anthos Service Mesh から Apigee Ingress ゲートウェイへの切り替えの手順に沿ってください。