
Kubernetes Ingress APIは基盤となるものですが、複雑なトラフィック管理においては、表現力、役割の分離、拡張性に限界があります。その後継であるGateway APIは、よりきめ細かく、役割指向の設計と堅牢な拡張メカニズムを導入することで、これらの欠点を解消します。このガイドでは、Envoyプロキシを基盤とするEnvoy GatewayまたはCilium Gatewayに焦点を当て、ingress-nginxからEnvoyベースのGateway API実装への本番環境移行戦略について詳しく説明します。
Generate Deployments, Services, ConfigMaps & Ingress
Convert multi-service Docker Compose v2/v3 YAML into production-grade Kubernetes manifests with custom replicas, health probes, resource limits, and PVC storage.
Gateway APIは階層構造を導入しています。
GatewayClass: Gatewayのクラスを定義し、それを実装するコントローラー(例:envoy-gateway-class、cilium-gateway-class)を指定します。これは通常、インフラプロバイダーまたはクラスター管理者によって管理されます。Gateway: ロードバランサーの特定のインスタンスを表し、ポートとプロトコルを公開します。これはインフラオペレーターまたはプラットフォームチームによってプロビジョニングされます。HTTPRoute / GRPCRoute / TLSRoute / TCPRoute / UDPRoute: プロトコル固有のルーティングルールを定義し、Gatewayにアタッチします。これらは通常、アプリケーション開発者によって管理されます。この役割指向の設計は関心を分離します。インフラチームはGatewayClassとGatewayリソースを管理し、アプリケーションチームはRouteリソースを管理することで、インフラを直接変更することなくセルフサービスを可能にします。
段階的でダウンタイムのない移行が重要です。この戦略には以下が含まれます。
ingress-nginxと並行してGateway APIコントローラーとリソースをデプロイします。ingress-nginxロードバランサーIPからGateway APIロードバランサーIPへトラフィックを段階的に移行します。ingress-nginxを維持します。cert-managerがインストールされていること。kubectlおよびhelm CLIツール。ingress-nginxデプロイメント。ここではEnvoy Gatewayを主要な例として使用しますが、Cilium Gatewayも同様のパターンに従い、CiliumのeBPFデータプレーンを活用します。
# gateway-api-crd-install.yaml
# Install Gateway API CRDs if not already present in your cluster.
# This is a prerequisite for any Gateway API controller.
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
name: gatewayclasses.gateway.networking.k8s.io
spec:
group: gateway.networking.k8s.io
names:
kind: GatewayClass
listKind: GatewayClassList
plural: gatewayclasses
singular: gatewayclass
scope: Cluster
versions:
- name: v1
served: true
storage: true
schema:
openAPIV3Schema:
type: object
x-kubernetes-preserve-unknown-fields: true
subresources:
status: {}
---
# ... other Gateway API CRDs (Gateway, HTTPRoute, etc.) ...
# For brevity, full CRD definitions are omitted.
# You can find them at https://github.com/kubernetes-sigs/gateway-api/releases
# Install Envoy Gateway via Helm
# Add the Envoy Gateway Helm repository
helm repo add envoy-gateway https://envoyproxy.github.io/envoy-gateway/
helm repo update
# Install Envoy Gateway into the 'envoy-gateway-system' namespace
helm install envoy-gateway envoy-gateway/envoy-gateway \
--create-namespace \
--namespace envoy-gateway-system \
--version v0.8.0 # Use the latest stable version
デプロイを確認します。
kubectl get pods -n envoy-gateway-system
kubectl get gatewayclass
EnvoyGatewayポッドが実行され、eg(Envoy Gatewayのデフォルト)または類似のGatewayClassが表示されるはずです。
CiliumをCNIとしてすでに使用している場合、Cilium GatewayはeBPFを活用した高度に統合されたソリューションを提供します。
# Install Cilium with Gateway API support
helm upgrade --install cilium cilium/cilium \
--namespace kube-system \
--set gatewayAPI.enabled=true \
--set gatewayAPI.nodePort.enabled=true # Or LoadBalancer, depending on your cloud provider
# ... other Cilium configurations ...
デプロイを確認します。
kubectl get pods -n kube-system -l k8s-app=cilium
kubectl get gatewayclass
ciliumまたは類似のGatewayClassが表示されるはずです。
このステップでは、外部ロードバランサーをプロビジョニングするGatewayリソースと、ルーティングルールを定義するHTTPRouteリソースを作成します。
このGatewayリソースは、クラウドロードバランサーをプロビジョニングし、ポート80と443を公開します。
# gateway.yaml
apiVersion: gateway.networking.k8s.io/v1
kind: Gateway
metadata:
name: my-app-gateway
namespace: default # Or your designated ingress namespace
spec:
gatewayClassName: eg # Use 'eg' for Envoy Gateway, 'cilium' for Cilium Gateway
listeners:
- name: http
protocol: HTTP
port: 80
allowedRoutes:
namespaces:
from: All # Allow HTTPRoutes from any namespace to attach
- name: https
protocol: HTTPS
port: 443
tls:
mode: Terminate
certificateRefs:
- kind: Secret
name: my-app-tls-secret # This secret will be provisioned by cert-manager
allowedRoutes:
namespaces:
from: All # Allow HTTPRoutes from any namespace to attach
これを適用します: kubectl apply -f gateway.yaml
Gatewayがプロビジョニングされるまで待ちます。そのステータスを確認します。
kubectl get gateway my-app-gateway -n default -o yaml
プロビジョニングされたロードバランサーの外部IPまたはホスト名を取得するには、status.addressesを探します。これが新しいエントリポイントになります。
cert-managerによる自動TLScert-managerがインストールされ、設定されていることを確認してください。TLSシークレットをプロビジョニングするためにCertificateリソースを使用します。
# cert-manager-certificate.yaml
apiVersion: cert-manager.io/v1
kind: Certificate
metadata:
name: my-app-tls-certificate
namespace: default
spec:
secretName: my-app-tls-secret # Matches the name in Gateway listener
dnsNames:
- myapp.example.com
- www.myapp.example.com
issuerRef:
name: letsencrypt-prod # Or your preferred ClusterIssuer/Issuer
kind: ClusterIssuer
group: cert-manager.io
これを適用します: kubectl apply -f cert-manager-certificate.yaml
シークレットが作成されたことを確認します: kubectl get secret my-app-tls-secret -n default
次に、バックエンドサービスにトラフィックを転送するためのHTTPRouteを定義します。この例には、パスベースのルーティングとカナリアデプロイメントのための重み付けされたトラフィックスプリットが含まれています。
# httproute.yaml
apiVersion: gateway.networking.k8s.io/v1
kind: HTTPRoute
metadata:
name: my-app-route
namespace: default # Namespace where your application service resides
spec:
parentRefs:
- name: my-app-gateway # Attach to the Gateway defined above
namespace: default
hostnames:
- "myapp.example.com"
- "www.myapp.example.com"
rules:
- matches:
- path:
type: PathPrefix
value: /api/v1/
backendRefs:
- name: my-app-service-v1 # Existing stable service
port: 80
weight: 90 # 90% of traffic to v1
- name: my-app-service-v2 # New canary service
port: 80
weight: 10 # 10% of traffic to v2
- matches:
- path:
type: PathPrefix
value: /
backendRefs:
- name: my-app-service-v1 # Default route for all other paths
port: 80
これを適用します: kubectl apply -f httproute.yaml
default名前空間にmy-app-service-v1とmy-app-service-v2(およびそれに対応するデプロイメント)が存在することを確認してください。
これはダウンタイムゼロを実現するための最も重要なフェーズです。
kubectl get gateway my-app-gateway -n default -o jsonpath='{.status.addresses[0].value}'からこれを入手します。a123.us-east-1.elb.amazonaws.com)をプロビジョニングする場合、myapp.example.comのCNAMEレコードをこの新しいホスト名に更新します。myapp.example.comのAレコードをこの新しいIPに更新します。myapp.example.comのDNSレコードのTTL(Time To Live)を非常に低い値(例:60秒)に短縮します。これにより、変更が迅速に伝播されます。ingress-nginx IPから新しいGateway API IPへトラフィックを段階的に移行します。これにより、制御されたパーセンテージベースの切り替えが可能になります。DNS更新の例(概念的、myapp.example.comを使用):
# Before migration (pointing to ingress-nginx LB)
myapp.example.com. 300 IN A 192.0.2.100
# During migration (after Gateway API LB is ready)
# Option 1: CNAME (if Gateway provides hostname)
myapp.example.com. 60 IN CNAME a123.us-east-1.elb.amazonaws.com.
# Option 2: A Record (if Gateway provides IP)
myapp.example.com. 60 IN A 203.0.113.200
# After full validation, revert TTL to a higher value (e.g., 3600)
myapp.example.com. 3600 IN CNAME a123.us-east-1.elb.amazonaws.com.
徹底的な検証が最も重要です。
ingress-nginxパスと新しいGateway APIパスの間で、レイテンシ、エラー率、スループットを比較します。Envoy Gatewayは、スクレイピング可能なPrometheusメトリクスを公開しています。HTTPRouteの重み付けされたトラフィックスプリットを活用して、少数のユーザーを新しいパスに段階的に公開します。綿密に監視します。GatewayがPending状態のままになるkubectl get gateway my-app-gatewayがReady: Falseとmessage: "Gateway is not ready"でstatus.conditionsを表示する。kubectl logs -n envoy-gateway-system -l app.kubernetes.io/name=envoy-gateway。クラウドプロバイダーAPI呼び出しに関連するエラーを探す。kubectl describe gateway my-app-gateway。HTTPRouteがGatewayにアタッチされないkubectl get httproute my-app-route -o yamlがconditionsでstatus.parentsを表示し、ResolvedRefs: FalseまたはAccepted: Falseを示す。parentRefs(名前、名前空間)の不一致、またはGateway上のallowedRoutes設定。HTTPRouteのparentRefs.nameとparentRefs.namespaceが、Gatewayの名前と名前空間に正確に一致することを確認する。Gateway.spec.listeners.allowedRoutes.namespaces.fromが正しく設定されていることを確認する(例:AllまたはSelectorがHTTPRouteの名前空間と一致する)。GatewayとHTTPRouteのイベントを確認する: kubectl describe gateway my-app-gatewayとkubectl describe httproute my-app-route。SSL_PROTOCOL_ERRORまたはcertificate_unknownエラーを報告する。GatewayのcertificateRefが間違っている、cert-managerの失敗、またはtls.modeが間違っている。Gateway.spec.listeners.tls.certificateRefsが正しいSecret名と名前空間を指していることを確認する。cert-manager CertificateとCertificateRequestリソースを確認する: kubectl get certificate my-app-tls-certificate -n default -o yaml。Ready: Trueを確認する。cert-managerコントローラーログを検査する: kubectl logs -n cert-manager -l app.kubernetes.io/instance=cert-manager。tls.modeがTerminateであることを確認する。weight設定と一致しない、またはすべてのトラフィックが1つのバックエンドに流れる。backendRefsの設定ミス、またはサービスディスカバリの問題。HTTPRoute.spec.rules.backendRefs.weightの値を再確認する。複数のルールが適用される場合は、それらが正しく合計されていることを確認する。backendRefs.nameとbackendRefs.portがKubernetesのServiceリソースを正しく指していることを確認する。ServiceとEndpointSliceリソースを確認し、正常なポッドがあることを確認する。EnvoyProxyリソース(Envoy Gatewayを使用している場合)をカスタマイズする必要があるかもしれません。envoy_cluster_upstream_rq_total、envoy_server_uptime)を監視する。| 機能 | Ingress-Nginx | Gateway API (Envoy Gateway) |
|---|---|---|
| APIモデル | Ingress, IngressClass | GatewayClass, Gateway, HTTPRouteなど |
| 役割分離 | 限定的(管理者がIngressClassを管理、開発者がIngressを管理) | 強力(インフラ: GatewayClass、オペレーター: Gateway、開発者: Route) |
| 拡張性 | アノテーション、Nginx ConfigMap | ポリシーアタッチメント(例:HTTPRouteFilter)、EnvoyProxy CRD |
| トラフィックスプリット | アノテーション(例:nginx.ingress.kubernetes.io/canary) | HTTPRouteにおけるファーストクラスのbackendRefs.weight |
| マルチクラスター | ネイティブではサポートされていない | マルチクラスター/マルチテナント向けに設計 |
| プロトコルサポート | HTTP/HTTPS、TCP/UDP(externalNameまたはstream-snippets経由) | HTTP/HTTPS、gRPC、TCP、UDP、TLS(ネイティブCRD) |
| 実装 | Nginx | Envoy Proxy |
| TLS管理 | Ingressアノテーション経由のcert-manager | Gateway.spec.listeners.tls.certificateRefs経由のcert-manager |
`ingress-nginx`からEnvoyベースのGateway API実装への移行中に、部分的なDNS切り替え後、重要な本番アプリケーションで断続的な503エラーが発生しています。運用チームは、新しいGateway APIの設定に誤りがあると疑っています。ダウンタイムを最小限に抑えつつ、この問題を軽減するための最も効果的な即時対策は次のうちどれですか?
ingress-nginxとGateway APIを同時に実行できますか?はい、これは段階的な移行に推奨されるアプローチです。これらは独立して動作し、それぞれ独自のロードバランサーをプロビジョニングします。DNSを管理して、どちらか一方にトラフィックを誘導します。
Envoy Gatewayの場合、通常はEnvoyProxyカスタムリソースを使用して高度なEnvoy設定を適用します。これにより、基盤となるEnvoyプロキシの設定を直接操作できます。Cilium Gatewayの場合、Ciliumのネットワークポリシーと、高度なEnvoy機能のためのCiliumEnvoyConfigリソースを活用します。Gateway API自体は標準的なルーティングに焦点を当てており、コントローラー固有のCRDが拡張性を提供します。
Envoyは高性能なプロキシであり、特にHTTP/2やgRPCの特定のワークロードではNginxよりも優れたパフォーマンスを発揮することがよくあります。適切なリソース割り当てを前提とすれば、パフォーマンスへの影響は一般的に肯定的または中立的です。重要なのは、Envoy GatewayコントローラーとEnvoyプロキシポッドの適切な設定とリソースプロビジョニングです。
Gateway.spec.listeners.allowedRoutesフィールドは、どの名前空間が特定のGatewayにRouteリソースをアタッチすることを許可されているかを制御します。All、Same、またはSelectorを指定して、Routeのアタッチメントを制限または許可し、安全なマルチテナント環境を可能にすることができます。例えば、from: Allは任意の名前空間を許可し、from: SelectorとnamespaceSelectorは特定のラベルに一致する名前空間のみを許可します。
はい、Gateway APIは2023年10月にv1のGA(一般提供)に昇格しました。Envoy GatewayやCilium Gatewayのようなコントローラーは活発に開発されており、本番環境で使用されています。これはKubernetesにおけるIngressとトラフィック管理の未来と考えられています。
AI CLIログの整形、Cron式の作成、JWTの解析、chmod権限の計算をオフラインで実行。

KubernetesにおけるeBPFとCiliumについて、高スループットルーティング、ネットワークポリシー、Hubble可観測性を本番環境レベルのアーキテクチャとコード例で網羅的に解説するガイド。
続きを読む
Kubernetesで真のゼロダウンタイムデプロイメントを実現する方法。Pod Disruption Budget、terminationGracePeriodSeconds、preStopフック、Ingressのコネクションドレイニングを適切に設定します。
続きを読む
eBPFを活用したCiliumとCalicoの比較、Kubernetesネットワークスループット、セキュリティ、サービスメッシュを本番環境レベルのアーキテクチャとコード例で網羅的に解説するガイドです。
続きを読む