Apigee Ingress ゲートウェイ Pod で 2 つのコンテナのうち 1 つが実行されている

症状

Pod のリストを取得すると、apigee-ingressgateway Pod で実行されているコンテナが 2 つのうち 1 つしか表示されません。

たとえば、次のコマンドを実行するとします。

kubectl -n apigee get pods -l app=apigee-ingressgateway

出力:

NAME                                                             READY   STATUS    RESTARTS   AGE
apigee-ingressgateway-ext-ingress-myorg-hyb-8f2c412-shl9r         1/2     Running      0      6m48s
apigee-ingressgateway-ext-ingress-myorg-hyb-8f2c412-vvzsf         1/2     Running      0      123m

また、上記の Pod のいずれかで describe コマンドを実行すると、503 ステータス コードで Readiness プローブが失敗していることがわかります。

たとえば、Pod の説明の Events セクションに次のメッセージが表示されることがあります。

Events:
  Type     Reason     Age                    From     Message
  ----     ------     ----                   ----     -------
  Warning  Unhealthy  76s (x32903 over 18h)  kubelet  Readiness probe failed: HTTP probe failed with statuscode: 503

考えられる原因

原因	説明
Apigee Ingress がポート 80 でリッスンするように構成されている	Apigee Hybrid 1.9 以降、ポート 80 での Apigee Ingress 構成はサポートされなくなりました。

原因: Apigee Ingress がポート 80 でリッスンするように構成されている

この問題は、Apigee Ingress ゲートウェイがポート 80 でリッスンするように構成されていることが原因です。Apigee Hybrid 1.9 以降では、ポート 80 はサポートされなくなりました。

これは、ポート 80 を許可する以前のバージョンの Apigee Hybrid からアップグレードした場合や、ポート 80 を有効にする別の構成ミスがある場合に発生する可能性があります。

診断

1. apigee-ingressgateway Pod のリストを取得します。

   次のコマンドを実行します。

   kubectl -n apigee get pods -l app=apigee-ingressgateway

   出力例

   NAME                                                              READY   STATUS    RESTARTS   AGE
   apigee-ingressgateway-ext-ingress-myorg-hyb-8f2c412-shl9r         1/2     Running   0          6m48s
   apigee-ingressgateway-ext-ingress-myorg-hyb-8f2c412-vvzsf         1/2     Running   0          123m
   

2. リストされた Pod のいずれかを説明して、イベントを確認します。

   kubectl -n apigee describe pod APIGEE_INGRESSGATEWAY_POD

   ここで、APIGEE_INGRESSGATEWAY_POD は前のコマンド出力に示されている apigee-ingressgateway Pod です。

   出力例:

   Events:
     Type     Reason     Age                    From     Message
     ----     ------     ----                   ----     -------
     Warning  Unhealthy  76s (x32903 over 18h)  kubelet  Readiness probe failed: HTTP probe failed with statuscode: 503
   

3. APIGEE_INGRESSGATEWAY_POD Pod のログを取得します。

   kubectl -n apigee logs APIGEE_INGRESSGATEWAY_POD

   権限拒否エラーによりポート 80 のバインドに失敗したことを示すログエントリが表示され、その後に envoy が準備できていないというメッセージが表示されることがあります。

   2025-09-11T06:16:45.457621Z     error   envoy config external/envoy/source/common/listener_manager/listener_manager_impl.cc:1186        listener '0.0.0.0_80' failed to bind or apply socket options: cannot bind '0.0.0.0:80': Permission denied
   ...
   2025-09-11T06:16:46.365818Z     warn    Envoy proxy is NOT ready: config received from XDS server, but was rejected: cds updates: 1 successful, 0 rejected; lds updates: 0 successful, 1 rejected
   

4. 現在の apigeeroute 構成を確認して、ポート 80（HTTP）が有効になっている構成を見つけます。
   • 定義された Apigee ルートのリストを取得します。

     kubectl -n apigee get apigeeroute

     出力例:

     NAME                                  STATE     AGE
     myorg-hyb-dev-grp-000-33620d0         running   2d1h
     non-sni                               running   17s
     

   • 各 apigeeroute で、ポート 80 が定義されている場所を確認します。

     前のコマンドの出力にリストされている apigeeroute ごとに、次のコマンドを実行します。

     kubectl -n apigee get apigeeroute APIGEE_ROUTE_NAME -o yaml

     ここで、APIGEE_ROUTE_NAME は個々の apigeeroute の名前です。

     サンプル コマンド:

           kubectl -n apigee get apigeeroute non-sni -o yaml
           

     出力例:

           apiVersion: apigee.cloud.google.com/v1alpha2
           kind: ApigeeRoute
           metadata:
             name: non-sni
             namespace: apigee
             resourceVersion: "240441468"
           spec:
             enableNonSniClient: true
             hostnames:
             - '*'
           ports:
             - number: 443
               protocol: HTTPS
               tls:
                 credentialName: myorg-hyb-dev-grp
                 minProtocolVersion: TLS_AUTO
                 mode: SIMPLE
             - number: 80
               protocol: HTTP
           selector:
             app: apigee-ingressgateway
           status:
             lastAppliedGeneration: 1
             state: running
           

     非 SNI apigeeroute は、このルートの一部としてポート 80 が有効になっていることを示しています。

解決策

この問題を解決するには、次の行を削除して、元の apigeeroute yaml ファイルでポート 80 を無効にします。

  - number: 80
    protocol: HTTP
      

元の apigeeroute yaml ファイルがない場合は、次の手順を行います。

1. 次のコマンドを使用して、現在の構成をエクスポートします。

   kubectl -n apigee get apigeeroute APIGEE_ROUTE_NAME -o yaml > APIGEE_ROUTE_FILENAME.yaml

   ここで、APIGEE_ROUTE_NAME は、ポート 80 の構成を削除するために更新される apigeeroute です。

   ここで、APIGEE_ROUTE_FILENAME は apigeeroute yaml コンテンツを含む出力ファイル名です。

2. apigeeroute yaml ファイルを編集して、ポート 80 の構成を削除します。

   テキスト エディタで APIGEE_ROUTE_FILENAME ファイルを開き、次の行を削除します。

           - number: 80
             protocol: HTTP
               

3. 既存の apigeeroute を変更した YAML ファイルに置き換えます。

   kubectl -n apigee replace -f APIGEE_ROUTE_FILENAME.yaml
   

   ここで、APIGEE_ROUTE_FILENAME は更新された apigeeroute 構成を含む出力ファイルです。

4. apigee-ingressgateway Pod が 2/2 コンテナで実行されるようになります。そうでない場合は、Pod を削除して、新しい Pod が自動的に作成されるようにします。

           NAME                                                              READY   STATUS    RESTARTS   AGE
           apigee-ingressgateway-ext-ingress-myorg-hyb-8f2c412-shl9r         2/2     Running   0          25h
           apigee-ingressgateway-ext-ingress-myorg-hyb-8f2c412-vvzsf         2/2     Running   0          26h
           

診断情報の収集が必要な場合

上記の手順でも問題が解決しない場合は、次の診断情報を収集して Google Cloud カスタマーケアにご連絡ください。

• Overrides.yaml
• 次のコマンドの出力:
  • kubectl -n apigee get pods -l app=apigee-ingressgateway

  • kubectl -n apigee logs APIGEE_INGRESSGATEWAY_POD

  • kubectl -n apigee get apigeeroutes

  • 指定されたルートごとに、次のコマンドを実行します。

    kubectl -n apigee get apigeeroute APIGEE_ROUTE_NAME -o yaml

• または、Apigee ハイブリッドの Must-Gather 情報を実行して提供することもできます。