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

この手順を使用して、既存の Apigee ハイブリッド v1.8 インストールを、Ingress に対して Anthos Service Mesh を使用する設定から 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 ゲートウェイをインストールする

  1. 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_MINREPLICAS_MAX は、インストールにおける Apigee Ingress ゲートウェイの最小レプリカ数と最大レプリカ数です。詳細とデフォルト設定については、構成プロパティ リファレンスの ingressGateways[].replicaCountMiningressGateways[].replicaCountMax をご覧ください。
    • CPU_COUNT_REQMEMORY_REQ は、インストール環境における Apigee Ingress ゲートウェイの各レプリカに対する CPU とメモリのリクエストです。

      詳細とデフォルト設定については、構成プロパティ リファレンスの ingressGateways[].resources.requests.cpuingressGateways[].resources.requests.memory をご覧ください。

    • CPU_COUNT_LIMITMEMORY_LIMIT: インストール環境での Apigee Ingress ゲートウェイの各レプリカに対する最大 CPU とメモリの上限。

      詳細とデフォルト設定については、構成プロパティ リファレンスの ingressGateways[].resources.limits.cpuingressGateways[].resources.limits.memory をご覧ください。

    • SVC_ANNOTATIONS_KEY SVC_ANNOTATIONS_VALUE(省略可):

      これは、デフォルトの Ingress サービスのアノテーションを提供する Key-Value ペアです。アノテーションは、ハイブリッド インストールの構成をサポートするために、クラウド プラットフォームによって使用されます。たとえば、ロードバランサのタイプを内部または外部に設定する場合などです。次に例を示します。

      ingressGateways:
        svcAnnotations:
          networking.gke.io/load-balancer-type: "Internal"

      アノテーションは、プラットフォームによって異なります。必須アノテーションと推奨アノテーションについては、プラットフォームのドキュメントをご覧ください。

      構成プロパティ リファレンスの ingressGateways[].svcAnnotations をご覧ください。
    • SVC_LOAD_BALANCER_IP(省略可)ロードバランサに静的 IP アドレスを割り当てることができます。ロードバランサの IP アドレスの指定をサポートするプラットフォームでは、この IP アドレスを使用してロードバランサが作成されます。ロードバランサの IP アドレスを指定できないプラットフォームでは、このプロパティは無視されます。

      ロードバランサに静的 IP アドレスが割り振られていない場合は、このプロパティをオーバーライド ファイルを含めないでください。

      構成プロパティ リファレンスの ingressGateways[].svcLoadBalancerIP をご覧ください。
  2. 次のコマンドを使用して変更を適用し、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 ゲートウェイへの切り替えの手順に沿ってください。