アプリケーションロードバランサ用の GKE Ingress

Autopilot Standard

このページでは、外部アプリケーションロードバランサの概要と仕組みについて説明します。Google Kubernetes Engine（GKE）では、GKE Ingress と呼ばれる、組み込みのマネージド Ingress コントローラを使用できます。このコントローラは、GKE で HTTP(S) ワークロードを処理する Google Cloud ロードバランサとして Ingress リソースを実装します。

概要

GKE では、Ingress オブジェクトが、クラスタ内で実行されるアプリケーションに HTTP(S) トラフィックをルーティングするルールを定義します。1 つの Ingress オブジェクトは 1 つ以上の Service オブジェクトに関連付けられており、それぞれの Service オブジェクトは Pod のセットに関連付けられています。Ingress が Service を使用してアプリケーションを公開する仕組みについては、Service ネットワーキングの概要をご覧ください。

Ingress オブジェクトを作成すると、GKE Ingress コントローラによって Cloud HTTP(S) ロードバランサが作成され、Ingress および関連する Service の情報に従ってそれが構成されます。

Ingress を使用するには、HTTP 負荷分散アドオンが有効になっている必要があります。GKE クラスタの HTTP 負荷分散はデフォルトで有効になっています。無効にしないでください。

外部および内部トラフィック用 Ingress

GKE Ingress リソースには次の 2 種類があります。

外部アプリケーションロードバランサ用の Ingress は、従来のアプリケーションロードバランサをデプロイします。インターネットに接続するこのロードバランサは、管理されたスケーラブルなロードバランシングリソースのプールとして Google のエッジネットワークにグローバルにデプロイされます。外部アプリケーションロードバランサ用に Ingress を設定して使用する方法を確認してください。
内部アプリケーションロードバランサ用の Ingress は、内部アプリケーションロードバランサをデプロイします。これらの内部アプリケーションロードバランサは、GKE クラスタ外部にある（ただし VPC ネットワーク内部の）Envoy プロキシシステムを利用しています。内部ロードバランサに Ingress を設定して使用する方法を確認してください。

重要: GKE が Ingress オブジェクトを介して外部アプリケーションロードバランサまたは内部アプリケーションロードバランサを作成する場合は、GKE の外部のメソッドを使用して、ロードバランサの構成変更を避ける必要があります。新しいリソースの変更の適用時、定期的な同期中、またはクラスタのアップグレード中に、ロードバランサのオブジェクト（転送ルール、ターゲットプロキシ、URL マップ、バックエンドサービス、ヘルスチェック）の設定のカスタマイズが上書きされます。GKE の外部で外部アプリケーションロードバランサまたは内部アプリケーションロードバランサを管理する必要がある場合は、代わりにスタンドアロン NEG のコンテナネイティブのロードバランシングを使用してください。

GKE Ingress コントローラの動作

GKE バージョン 1.18 以降を実行しているクラスタの場合、GKE Ingress コントローラで Ingress が処理されるかどうかは、kubernetes.io/ingress.class アノテーションの値によって決まります。

`kubernetes.io/ingress.class` 値	`ingressClassName` 値	GKE Ingress コントローラの動作
未設定	未設定	Ingress マニフェストを処理し、外部アプリケーションロードバランサを作成します。
未設定	任意の値	アクションは実行されません。サードパーティ製の Ingress コントローラがデプロイされている場合、Ingress マニフェストはそのコントローラで処理できます。
`gce`	任意の値。このフィールドは無視されます。	Ingress マニフェストを処理し、外部アプリケーションロードバランサを作成します。
`gce-internal`	任意の値。このフィールドは無視されます。	Ingress マニフェストを処理し、内部アプリケーションロードバランサを作成します。
`gce`、`gce-internal` 以外の値に設定	任意の値	アクションは実行されません。サードパーティ製の Ingress コントローラがデプロイされている場合、Ingress マニフェストはそのコントローラで処理できます。

古いバージョンの GKE を実行しているクラスタの場合、GKE コントローラは、kubernetes.io/ingress.class アノテーションがないか、値が gce または gce-internal のアノテーションがある Ingress を処理します。

`kubernetes.io/ingress.class` アノテーションの非推奨

kubernetes.io/ingress.class アノテーションは Kubernetes で非推奨になりましたが、GKE では引き続きこのアノテーションが使用されます。

ingressClassName フィールドを使用して GKE Ingress を指定することはできません。kubernetes.io/ingress.class アノテーションを使用する必要があります。

外部アプリケーションロードバランサの機能

Ingress によって構成された外部アプリケーションロードバランサには、次の機能があります。

柔軟な Service の構成。Ingress では、トラフィックがどのように Service に到達し、そのトラフィックがどのようにアプリケーションにルーティングされるかを定義します。また、クラスタ内の複数の Service に対して単一の IP アドレスを割り当てることができます。
Google Cloud ネットワークサービスとの統合
複数の TLS 証明書のサポート。Ingress では、リクエストの終了に際して複数の TLS 証明書を使用するように指定できます。

一覧については、Ingress の構成をご覧ください。

コンテナネイティブのロードバランシング

コンテナネイティブの負荷分散とは、ネットワークエンドポイントグループ（NEG）を使用して GKE 内の Pod エンドポイントに直接負荷を分散する手法のことです。

インスタンスグループを使用する場合、Compute Engine ロードバランサがバックエンドとしての VM IP にトラフィックを送信します。コンテナが同じホストインターフェースを共有しているコンテナで VM を実行する場合、次のような制限があります。

ロードバランサから VM NodePort へのホップと、Pod IP（別の VM に存在している可能性がある）へのホップの 2 つのホップが発生します。
ホップ数が増えるとレイテンシが増大し、トラフィックパスがより複雑になります。
Compute Engine ロードバランサには Pod が直接見えないため、トラフィックの負荷分散は最適なものにはなりません。
VM や Pod の損失などの環境イベントによって、トラフィックホップの重複のために断続的にトラフィック損失が発生する可能性があります。

NEG を使用すると、トラフィックは、VM IP または kube-proxy ネットワーキングを移動するのではなく、Ingress プロキシから直接 Pod IP に負荷分散されます。また、Kubernetes のクラスタ内正常性 Probe だけでなく、ロードバランサの観点からも Pod の健全性を判断するため、Pod の readiness ゲートが実装されます。これにより、ロードバランサインフラストラクチャで、Pod の起動、Pod の損失、VM の損失などのライフサイクルイベントを認識することで、トラフィック全体の安定性が向上します。これらの機能では、上記の制限を解決し、パフォーマンスの向上と安定したネットワークを実現します。

コンテナネイティブの負荷分散は、次のすべての条件が満たされている場合、デフォルトで Services に対して有効になります。

GKE クラスタ 1.17.6-gke.7 以降で作成された Service の場合
VPC ネイティブクラスタの使用
共有 VPC を使用しない
GKE ネットワークポリシーを使用しない

これらの条件では、Service 内に Pod IP をミラーリングするために NEG が作成する必要があることを示す cloud.google.com/neg: '{"ingress": true}' が Service に自動的に付けられます。NEG とは、Compute Engine のロードバランサが Pod と直接通信できるようにするものです。GKE 1.17.6-gke.7+ より前のバージョンで作成された既存の Service には、サービスコントローラによって自動的にアノテーションが付けられないことに注意してください。

NEG アノテーションが自動的に付けられる GKE 1.17.6-gke.7 以降のクラスタでは、NEG を無効にして、必要に応じて Compute Engine の外部ロードバランサでインスタンスグループをバックエンドとして使用することもできます。このためには、Service に cloud.google.com/neg: '{"ingress": false}' を明示的に付けます。内部アプリケーションロードバランサの Ingress を使用して NEG を無効にすることはできません。

NEG がデフォルトではないクラスタの場合でも、コンテナネイティブのロードバランシングを使用することを強くおすすめしますが、Service ごとに明示的に有効にする必要があります。アノテーションは、次の方法で Service に適用する必要があります。

kind: Service
...
  annotations:
    cloud.google.com/neg: '{"ingress": true}'
...

共有 VPC

Ingress リソースと MultiClusterIngress リソースは共有 VPC でサポートされていますが、追加の準備が必要です。

Ingress コントローラは GKE コントロールプレーンで動作し、クラスタのプロジェクトの GKE サービスアカウントを使用して Google Cloud への API 呼び出しを行います。デフォルトでは、共有 VPC サービスプロジェクトにあるクラスタが共有 VPC ネットワークを使用している場合、Ingress コントローラはホストプロジェクトでサービスプロジェクトの GKE サービスアカウントを使用して、上り（内向き）許可ファイアウォールルールの作成と更新を実行できません。

ホストプロジェクトで VPC ファイアウォールルールを作成および管理する権限をサービスプロジェクトの GKE サービスアカウントに付与できます。これらの権限を付与することで、GKE は次のものに対して上り（内向き）許可ファイアウォールルールを作成します。

外部 Ingress 用の外部アプリケーションロードバランサで使用される Google Front End（GFE）のプロキシとヘルスチェックシステム。詳細については、外部アプリケーションロードバランサの概要をご覧ください。
内部 Ingress で使用される内部アプリケーションロードバランサのヘルスチェックシステム。

注: 共有 VPC を使用しているかどうかにかかわらず、クラスタで内部 Ingress を使用している場合は、上り（内向き）許可ファイアウォールルールを手動で作成し、クラスタの VPC ネットワークとリージョンのプロキシ専用サブネットからのトラフィックを許可する必要があります。GKE Ingress コントローラでは、内部アプリケーションロードバランサのプロキシ専用サブネットのトラフィックを許可する上り（内向き）許可ファイアウォールルールを作成できないため、これらのルールを手動で作成する必要があります。詳しくは、Ingress の内部アプリケーション・ロードバランサに必要なネットワーク環境をご覧ください。

ホストプロジェクトからファイアウォールルールを手動でプロビジョニングする

セキュリティポリシーによって、ホストプロジェクトからのファイアウォール管理のみが許可される場合は、これらのファイアウォールルールを手動でプロビジョニングできます。共有 VPC に Ingress をデプロイすると、Ingress リソースイベントにより、アクセスを追加するために必要な特定のファイアウォールルールが提供されます。

ルールを手動でプロビジョニングするには:

Ingress リソースイベントを表示します。

kubectl describe ingress INGRESS_NAME

INGRESS_NAME は実際の Ingress 名で置き換えます。

出力は次の例のようになります。

Events:
Type    Reason  Age                    From                     Message
----    ------  ----                   ----                     -------
Normal  Sync    9m34s (x237 over 38h)  loadbalancer-controller  Firewall change required by security admin: `gcloud compute firewall-rules update k8s-fw-l7--6048d433d4280f11 --description "GCE L7 firewall rule" --allow tcp:30000-32767,tcp:8080 --source-ranges 130.211.0.0/22,35.191.0.0/16 --target-tags gke-l7-ilb-test-b3a7e0e5-node --project <project>`

推奨されるファイアウォールルールが Message 列に表示されます。

ホストプロジェクトから提案されたファイアウォールルールをコピーして適用します。ルールを適用すると、ロードバランサと Google Cloud ヘルスチェッカーから Pod にアクセスできます。

注: Ingress の種類によって、必要なルールは異なります。トラフィックを許可する独自の上り（内向き）ファイアウォールルールがある場合でも、GKE にファイアウォールルールの警告が表示されることがあります。その場合は、警告を無視してください。

ホストコントローラのファイアウォールルールを管理する権限を GKE Ingress コントローラに与える

サービスプロジェクトの GKE クラスタで、ホストプロジェクトのファイアウォールリソースを作成して管理するには、次のいずれかの方法で、サービスプロジェクトの GKE サービスアカウントに適切な IAM 権限を付与する必要があります。

サービスプロジェクトの GKE サービスアカウントに、ホストプロジェクトに対する Compute セキュリティ管理者のロールを付与します。次の例は、この方法を示しています。
より細かく設定する場合は、カスタム IAM ロールを作成し、権限 compute.networks.updatePolicy、compute.firewalls.list、compute.firewalls.get、compute.firewalls.create、compute.firewalls.update、compute.firewalls.delete のみを含めます。サービスプロジェクトの GKE サービスアカウントに、ホストプロジェクトに対するこのカスタムロールを付与します。

複数のサービスプロジェクトにクラスタがある場合は、いずれかの方法を選択して、サービスプロジェクトの GKE サービスアカウントごとに繰り返す必要があります。

gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
  --member=serviceAccount:service-SERVICE_PROJECT_NUMBER@container-engine-robot.iam.gserviceaccount.com \
  --role=roles/compute.securityAdmin

次のように置き換えます。

HOST_PROJECT_ID: 共有 VPC ホストプロジェクトのプロジェクト ID。
SERVICE_PROJECT_NUMBER: クラスタを含むサービスプロジェクトのプロジェクト番号。

複数のバックエンドサービス

各外部アプリケーションロードバランサまたは内部アプリケーションロードバランサは、1 つ以上のバックエンドサービスを参照する単一の URL マップを使用します。1 つのバックエンドサービスが、Ingress によって参照される各 Service に対応します。

たとえば、URL パスに応じてリクエストを異なるバックエンドサービスにルーティングするようにロードバランサを構成できます。つまり、your-store.example に送信されたリクエストは、正価の商品を表示するバックエンドサービスにルーティングされ、your-store-example/discounted に送信されたリクエストは、値引き対象商品を表示するバックエンドサービスにルーティングされるようにできます。

ホスト名に応じてリクエストをルーティングするように、ロードバランサを構成することもできます。つまり、your-store.example に送信されたリクエストはあるバックエンドサービスに送信され、your-experimental-store.example に送信されたリクエストは別のバックエンドサービスに送信されるようにできます。

GKE クラスタでは、Kubernetes Ingress オブジェクトを作成して HTTP(S) ロードバランサの作成と構成を行います。1 つの Ingress オブジェクトは 1 つ以上の Service オブジェクトに関連付けられている必要があります。それぞれの Service オブジェクトは、Pod のセットに関連付けられます。

my-ingress という名前の Ingress のマニフェストを次に示します。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-ingress
spec:
  rules:
  - http:
      paths:
      - path: /*
        pathType: ImplementationSpecific
        backend:
          service:
            name: my-products
            port:
              number: 60000
      - path: /discounted
        pathType: ImplementationSpecific
        backend:
          service:
            name: my-discounted-products
            port:
              number: 80

Ingress を作成すると、GKE Ingress コントローラで、Ingress とそれに関連する Service の情報に従って、外部アプリケーションロードバランサまたは内部アプリケーションロードバランサが作成されて構成されます。また、ロードバランサには、ドメイン名に関連付けることのできる固定 IP アドレスが与えられます。

上記の例で、ロードバランサの IP アドレスをドメイン名 your-store.example に関連付けたと仮定します。クライアントが your-store.example にリクエストを送信すると、そのリクエストはポート 60000 の my-products という名前の Kubernetes Service にルーティングされます。クライアントが your-store.example/discounted にリクエストを送信すると、そのリクエストはポート 80 の my-discounted-products という名前の Kubernetes Service にルーティングされます。

Ingress の path フィールドでサポートされているワイルドカード文字は「*」のみです。「*」はスラッシュ（「/」）の直後に置かれる必要があり、パターンの最後の文字でなければなりません。たとえば、/*、/foo/*、/foo/bar/* は有効なパターンですが、*、/foo/bar*、/foo/*/bar は有効ではありません。

より具体的なパターンのほうが、そうでないものよりも優先されます。/foo/* と /foo/bar/* の両方を使用すると、/foo/bar/bat が /foo/bar/* と比較されます。

パスの制限とパターンマッチングの詳細については、URL マップのドキュメントをご覧ください。

my-products Service のマニフェストは次のようになります。

apiVersion: v1
kind: Service
metadata:
  name: my-products
spec:
  type: NodePort
  selector:
    app: products
    department: sales
  ports:
  - protocol: TCP
    port: 60000
    targetPort: 50000

コンテナネイティブの負荷分散を使用しない場合、Service マニフェストでは type: NodePort を使用する必要があります。コンテナネイティブの負荷分散を使用する場合は、type: ClusterIP を使用します。

Service マニフェストの selector フィールドでは、app: products ラベルと department: sales ラベルの両方を持つ Pod がこの Service のメンバーであることを示しています。

リクエストがポート 60000 で Service に到達すると、そのリクエストは TCP ポート 50000 の 1 つのメンバーポッドにルーティングされます。

メンバーポッドごとに、TCP ポート 50000 でリッスンするコンテナが必要です。

my-discounted-products Service のマニフェストは次のようになります。

apiVersion: v1
kind: Service
metadata:
  name: my-discounted-products
spec:
  type: NodePort
  selector:
    app: discounted-products
    department: sales
  ports:
  - protocol: TCP
    port: 80
    targetPort: 8080

Service マニフェストの selector フィールドでは、app: discounted-products ラベルと department: sales ラベルの両方を持つポッドがこの Service のメンバーであることを示しています。

リクエストがポート 80 で Service に到達すると、そのリクエストは TCP ポート 8080 の 1 つのメンバーポッドにルーティングされます。

メンバーポッドごとに、TCP ポート 8080 でリッスンするコンテナが必要です。

デフォルトのバックエンド

Ingress のデフォルトのバックエンドを指定するには、Ingress マニフェストで spec.defaultBackend フィールドを指定します。これにより、rules フィールドで定義されたパスと一致しないリクエストがすべて処理されます。たとえば、次の Ingress では、/discounted と一致しないリクエストが my-products という Service のポート 60001 に送信されます。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-ingress
spec:
  defaultBackend:
    service:
      name: my-products
      port:
        number: 60001
  rules:
  - http:
      paths:
      - path: /discounted
        pathType: ImplementationSpecific
        backend:
          service:
            name: my-discounted-products
            port:
              number: 80

デフォルトのバックエンドを指定しない場合、GKE は 404 を返すバックエンドをデフォルトにします。これは、kube-system Namespace のクラスタ上に default-http-backend NodePort Service として作成されます。

404 HTTP レスポンスは次のようになります。

response 404 (backend NotFound), service rules for the path non-existent

ユーザーのデフォルトバックエンドを使用して GKE Ingress を設定するには、カスタムデフォルトバックエンドを使用した GKE Ingress をご覧ください。

Ingress と Compute Engine リソースのマッピング

GKE Ingress コントローラは、クラスタにデプロイされている Ingress リソースに基づいて、Compute Engine ロードバランサリソースをデプロイして管理します。Compute Engine リソースのマッピングは、Ingress リソースの構造によって異なります。

次のマニフェストは Ingress を記述しています。

apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
  name: my-ingress
spec:
  rules:
  - http:
      paths:
      - path: /*
        pathType: ImplementationSpecific
        backend:
          service:
            name: my-products
            port:
              number: 60000
      - path: /discounted
        pathType: ImplementationSpecific
        backend:
          service:
            name: my-discounted-products
            port:
              number: 80

この Ingress マニフェストは、次の Compute Engine リソースを作成するように GKE に指示します。

転送ルールと IP アドレス。
ロードバランサヘルスチェックのトラフィックと、Google Front End または Envoy プロキシからのアプリケーションのトラフィックを許可する Compute Engine ファイアウォールルール。
TLS を構成した場合、ターゲット HTTP プロキシとターゲット HTTPS プロキシ。
1 つのパスマッチャーを参照する単一のホストルールがある URL マップ。パスマッチャーには、/* 用と /discounted 用の 2 つのパスルールがあります。各パスルールは一意のバックエンドサービスにマッピングされます。
エンドポイントとして各 Service の Pod IP アドレスのリストを保持する NEG。これは my-discounted-products および my-products Service の結果として作成されます。

SSL 証明書を提供するためのオプション

SSL 証明書を HTTP(S) ロードバランサに指定するには、次の方法を使用します。

Google マネージド証明書: Google マネージド SSL 証明書は、ドメインに対してプロビジョニング、デプロイ、更新、管理されます。マネージド証明書はワイルドカードドメインをサポートしません。

Google Cloud と共有されるセルフマネージド証明書: 独自の SSL 証明書をプロビジョニングして、Google Cloud プロジェクトで証明書リソースを作成できます。その後、証明書リソースを Ingress のアノテーションでリストして、証明書を使用する HTTP(S) ロードバランサを作成できます。詳しくは、事前共有証明書に関する説明をご覧ください。
Secret リソースとしてのセルフマネージド証明書: 自身の SSL 証明書をプロビジョニングして、それを保持するための Secret を作成できます。Ingress 仕様の Secret を参照して、証明書を使用する HTTP(S) ロードバランサを作成できます。詳細については、Secret で証明書を使用する際の手順をご覧ください。

ヘルスチェック

デフォルトの Ingress コントローラを使用して Ingress によって 1 つ以上の Service を公開すると、GKE によって従来のアプリケーションロードバランサまたは内部アプリケーションロードバランサが作成されます。こうしたロードバランサでは、いずれも 1 つの URL マップで複数のバックエンドサービスがサポートされます。各バックエンドサービスは Kubernetes Service に対応し、各バックエンドサービスは Google Cloud ヘルスチェックを参照する必要があります。このヘルスチェックはクラスタの外部で実装されるため、Kubernetes の liveness Probe または readiness Probe とは異なります。

GKE は、次の手順を使用して、Kubernetes Service に対応する各バックエンドサービスのヘルスチェックを作成します。

Service が healthCheck 情報を使用して BackendConfig CRD を参照する場合、GKE はそれを使用してヘルスチェックを作成します。このヘルスチェックの作成方法は、GKE Enterprise Ingress コントローラと GKE Ingress コントローラの両方でサポートされます。
Service が BackendConfig CRD を参照していない場合:
- サービスを提供する Pod で readiness Probe にヘルスチェックパラメータとして解釈できる属性があるコンテナで Pod テンプレートを使用する場合、GKE でヘルスチェックのパラメータの一部またはすべてを推定できます。実装の詳細については、readiness Probe からのパラメータ、ヘルスチェックパラメータの作成に使用できる属性のリストについては、デフォルトパラメータと推定パラメータをご覧ください。readiness Probe からのパラメータの推定は、GKE Ingress コントローラでのみサポートされています。
- Service のサービスを提供する Pod 用の Pod テンプレートに、ヘルスチェックパラメータとして解釈できる属性がある readinessProbe があるコンテナがない場合、ヘルスチェックの作成にデフォルト値が使用されます。GKE Enterprise Ingress コントローラと GKE Ingress コントローラの両方で、デフォルト値のみを使用してヘルスチェックを作成できます。

デフォルトパラメータと推定パラメータ

以下のパラメータは、BackendConfig CRD を使用して対応する Service のヘルスチェックパラメータを指定しない場合に使用されます。

ヘルスチェックパラメータ	デフォルト値	推論可能な値
プロトコル	HTTP	Service のアノテーション `cloud.google.com/app-protocols` に存在している場合
リクエストパス	`/`	サービスを提供する Pod の `spec` に存在している場合: `containers[].readinessProbe.httpGet.path`
リクエストホストヘッダー	`Host: backend-ip-address`	サービスを提供する Pod の `spec` に存在している場合: `containers[].readinessProbe.httpGet.httpHeaders`
想定されるレスポンス	HTTP 200 (OK)	HTTP 200 (OK) 変更できません
チェック間隔	ゾーン NEG の場合: 15 秒インスタンスグループの場合: 60 秒	サービスを提供する Pod の `spec` に存在している場合: ゾーン NEG の場合: `containers[].readinessProbe.periodSeconds` インスタンスグループの場合: `containers[].readinessProbe.periodSeconds + 60 seconds`
チェックのタイムアウト	5 秒	サービスを提供する Pod の `spec` に存在している場合: `containers[].readinessProbe.timeoutSeconds`
正常しきい値	1	1 変更できません
異常しきい値	ゾーン NEG の場合: 2 インスタンスグループの場合: 10	デフォルトと同じ: ゾーン NEG の場合: 2 インスタンスグループの場合: 10
ポートの指定	ゾーン NEG の場合: Service の `port` インスタンスグループの場合: Service の `nodePort`	次の条件も満たしている限り、ヘルスチェックプローブは `spec.containers[].readinessProbe.httpGet.port` で指定されたポート番号に送信されます。 readiness Probe のポート番号が、サービスを提供する Pod の `containers[].spec.ports.containerPort` と一致する。サービスを提供する Pod の `containerPort` が、Service の `targetPort` と一致する。 Ingress のサービスバックエンドポートの仕様では、Service の `spec.ports[]` の有効なポートを参照しています。次の 2 つの方法があります。 Ingress の `spec.rules[].http.paths[].backend.service.port.name` は、対応する Service で定義された `spec.ports[].name` と一致します。 Ingress の `spec.rules[].http.paths[].backend.service.port.number` は、対応する Service で定義された `spec.ports[].port` と一致します。
宛先 IP アドレス	ゾーン NEG の場合: Pod の IP アドレスインスタンスグループの場合: ノードの IP アドレス	デフォルトと同じ: ゾーン NEG の場合: Pod の IP アドレスインスタンスグループの場合: ノードの IP アドレス

readiness Probe からのパラメータ

GKE で Service のバックエンドサービスのヘルスチェックが作成されると、その Service のサービスを提供する Pod で使用されている 1 つのコンテナの readiness Probe から特定のパラメータをコピーできます。このオプションは、GKE Ingress コントローラのみでサポートされています。

ヘルスチェックパラメータとして解釈できるサポートされている readiness Probe 属性は、デフォルトパラメータと推定パラメータでデフォルト値とともに一覧表示されています。readinessProbe に指定されていない属性、または readinessProbe がまったく指定されていない場合は、デフォルト値が使用されます。

Service のサービスを提供する Pod に複数のコンテナが含まれている場合や、GKE Enterprise Ingress コントローラを使用している場合は、BackendConfig CRD を使用してヘルスチェックパラメータを定義する必要があります。詳しくは、代わりに BackendConfig CRD を使用する場合をご覧ください。

警告: バックエンドサービスのヘルスチェックパラメータがサービスを提供する Pod の readinessProbe から推定される場合、GKE では readinessProbe とヘルスチェックが同期されません。

GKE によって Ingress の外部アプリケーションロードバランサまたは内部アプリケーションロードバランサが作成された後に、Ingress によって参照される Service のサービスを提供する Pod の readinessProbe を変更した場合、readinessProbe への変更は、ロードバランサ上の対応するバックエンドサービスのヘルスチェックにコピーされません。
逆に、Ingress の代わりに作成されたロードバランサのバックエンドサービスで使用されるヘルスチェックに変更を加えた場合、GKE では readinessProbe が更新されず、ヘルスチェックに加えた変更を元に戻されることもありません。

代わりに `BackendConfig` CRD を使用する場合

次の場合は、Pod の readinessProbe のパラメータに依存せずに、Service の BackendConfig CRD を作成して、バックエンドサービスのヘルスチェックパラメータを明示的に定義する必要があります。

GKE Enterprise を使用している場合: GKE Enterprise Ingress コントローラは、サービスを提供する Pod の readinessProbe からのヘルスチェックパラメータの取得をサポートしていません。ヘルスチェックの作成には、暗黙的パラメータを使用するか、BackendConfig CRD での定義に従います。

サービスを提供する Pod に複数のコンテナがある場合: GKE には、ヘルスチェックパラメータを推測するコンテナの readiness Probe を選択する方法がありません。各コンテナには独自の readiness Probe があり、readiness Probe はコンテナに必要なパラメータではないため、対応する Service のBackendConfig CRD を参照して、対応するバックエンドサービスのヘルスチェックを定義する必要があります。
ロードバランサのヘルスチェックに使用するポートを制御する必要がある場合: GKE では、そのポートが Ingress spec.rules[].http.paths[].backend.servicePort で参照される Service のサービスポートと一致している場合、バックエンドサービスのヘルスチェックに対して、readiness Probe の containers[].readinessProbe.httpGet.port のみを使用します。

`BackendConfig` CRD からのパラメータ

対応する Service により参照される BackendConfig CRD の healthCheck パラメータを使用して、バックエンドサービスのヘルスチェックパラメータを指定できます。これにより、従来のアプリケーションロードバランサまたは Ingress によって作成された内部アプリケーションロードバランサのヘルスチェックをより柔軟に制御できるようになります。GKE のバージョンの互換性については、Ingress の構成をご覧ください。

この BackendConfig CRD の例では、spec.healthCheck 属性でヘルスチェックプロトコル（タイプ）、リクエストパス、ポート、チェック間隔を定義します。

apiVersion: cloud.google.com/v1
kind: BackendConfig
metadata:
  name: http-hc-config
spec:
  healthCheck:
    checkIntervalSec: 15
    port: 15020
    type: HTTPS
    requestPath: /healthz

BackendConfig ヘルスチェックを構成するときに使用可能なすべてのフィールドを構成するには、カスタムヘルスチェックの構成の例を使用します。

カスタム HTTP ヘルスチェックを使用して GKE Ingress を設定する方法については、カスタム HTTP ヘルスチェックを使用した GKE Ingress をご覧ください。

複数の TLS 証明書の使用

HTTP(S) ロードバランサで、your-store.example および your-experimental-store.example という名前の 2 つのホストからコンテンツを提供するとします。ここで、ロードバランサは、your-store.example 用と experimental-store.example 用で異なる証明書を使用するものとします。

これを行うには、Ingress マニフェストで複数の証明書を指定します。ロードバランサは、指定された証明書のうち、リクエストで使用されているホスト名と一致する共通名（CN）が含まれている証明書を選択します。複数の証明書を構成する方法について詳しくは、Ingress での HTTPS 負荷分散のための複数の SSL 証明書の使用をご覧ください。

Kubernetes Service と Google Cloud バックエンドサービスの比較

Kubernetes Service と Google Cloud バックエンドサービスは別物です。両者の間には強い関係がありますが、その関係は必ずしも 1 対 1 ではありません。GKE Ingress コントローラは、Ingress マニフェスト内の各（service.name、service.port）ペア用に 1 つの Google Cloud バックエンドサービスを作成します。したがって、1 つの Kubernetes Service オブジェクトが複数の Google Cloud バックエンドサービスに関係する可能性があります。

制限事項

1.16 より前のバージョンを使用するクラスタでは、Ingress の Namespace と名前の長さの合計は 40 文字以内にする必要があります。このガイドラインに従わないと、GKE Ingress コントローラの動作が異常になる恐れがあります。詳しくは、GitHub での長い名前に関する問題をご覧ください。
NEG を使用するクラスタでは、Ingress の調整時間が Ingress の数によって影響を受けることがあります。たとえば、それぞれに 20 個の Ingress があり、そのすべてに 20 個の個別の NEG バックエンドが含まれている場合、Ingress の変更が調整されるまでに 30 分以上のレイテンシが発生する場合があります。これは特に、必要な NEG の数が増えるため、リージョンクラスタに影響します。
URL マップの割り当てが適用されます。
Compute Engine リソースの割り当てが適用されます。
GKE Ingress コントローラで NEG を使用しない場合、GKE クラスタのノード数は 1,000 に制限されます。NEG を使用して Service をデプロイする場合、GKE のノード数に課される制限はありません。Ingress で公開されている、NEG を使用しない Service は、1,000 ノードを超えるクラスタでは正しく機能しません。
GKE Ingress コントローラで readinessProbes をヘルスチェックとして使用するには、Ingress の作成時に Ingress 用の Pod が存在している必要があります。レプリカが 0 にスケールされている場合は、デフォルトのヘルスチェックが適用されます。詳しくは、ヘルスチェックに関する GitHub の問題のコメントをご覧ください。
Ingress の作成後に Pod の readinessProbe を変更しても、Ingress には影響を与えません。
外部アプリケーションロードバランサは、クライアントとロードバランサの間のレイテンシを最小限に抑えるために、グローバルに分散されたロケーションで TLS を終端します。TLS の終端を指定する必要がある場合は、タイプ LoadBalancer の GKE Service で公開されている独自の Ingress コントローラを使用して、適切なリージョンにあるバックエンドで TLS を終端する必要があります。
複数の Ingress リソースを単一の Google Cloud ロードバランサに統合する操作はサポートされていません。
相互 TLS は外部アプリケーションロードバランサでサポートされていないため、アプリケーションでは相互 TLS を無効にする必要があります。

外部 Ingress とルートベースクラスタ

外部 Ingress でルートベースのクラスタを使用する場合、GKE Ingress コントローラは GCE_VM_IP_PORT ネットワークエンドポイントグループ（NEG）を使用してコンテナネイティブのロードバランシングを使用できません。代わりに、Ingress コントローラは、すべてのノードプール内のすべてのノードを含む非マネージドインスタンスグループバックエンドを使用します。これらの非マネージドインスタンスグループが LoadBalancer Service でも使用されている場合、単一ロードバランシングインスタンスグループの制限に関連する問題が発生する可能性があります。

VPC ネイティブクラスタで作成された古い外部 Ingress オブジェクトの中には、作成した各外部アプリケーションロードバランサのバックエンドサービスでインスタンスグループバックエンドを使用するものがあります。これは内部 Ingress には関係ありません。内部 Ingress リソースは常に GCE_VM_IP_PORT NEG を使用し、VPC ネイティブクラスタを必要とするためです。

外部 Ingress での 502 エラーのトラブルシューティング方法については、外部 Ingress で HTTP 502 エラーが発生するをご覧ください。

実装の詳細

Ingress コントローラは、Google Cloud プロジェクトからテストリソースを取得して、サービスアカウントの権限を定期的にチェックします。この名前は、k8s-ingress-svc-acct-permission-check-probe という名の（実在しない）グローバル BackendService の GETとして表示されます。このリソースは通常は存在していないため、GET リクエストは「not found」を返します。これは想定された動作です。コントローラは、認証の問題により API 呼び出しが拒否されたことを確認しています。同じ名前の BackendService を作成すると、「not found」を返す代わりに GET が成功します。

Ingress 構成のテンプレート

GKE ネットワーキングレシピの Ingress セクションでは、Ingress の一般的な使用に関して GKE が提供しているテンプレートを確認できます。

アプリケーション ロードバランサ用の GKE Ingress

概要

外部および内部トラフィック用 Ingress

GKE Ingress コントローラの動作

kubernetes.io/ingress.class アノテーションの非推奨

外部アプリケーション ロードバランサの機能

コンテナ ネイティブのロード バランシング