Ingress のスケーリングを処理する LoadBalancer CRD

CRD (CustomResourceDefinitions) を作成して NSX ロードバランサの使用状況を監視し、デフォルトのロードバランサでは処理できない Ingress ワークロードを処理するための追加の NSX レイヤー 7 ロードバランサを作成できます。これらの CRD は、Kubernetes LoadBalancer サービス用に作成されたレイヤー 4 ロードバランサのスケーリングのためのものではありません。

この機能をマネージャモードで使用する場合は、NCP 2.5.1 以降が必要です。ポリシーモードで使用する場合は、NCP 3.0.1 以降が必要です。

共有 Tier-1 トポロジがある場合にこの機能を使用するには、nsx-ncp-config ConfigMap の [nsx_v3] で tier0_gateway を構成する必要があります。

次の CRD を作成できます。

NSXLoadBalancerMonitor - この CRD は、NSX ロードバランサの使用統計情報を報告するために使用されます。ポリシーモードの場合、この CRD は LoadBalancer CRD で作成された名前空間のロードバランサのみを監視します。
LoadBalancer - この CRD は、新しい NSX ロードバランサを作成するために使用されます。このリソースの定義は、NCP YAML ファイルにあります。ポリシーモードと TKGI 環境の場合は、名前空間のリソースです。マネージャモード環境の場合、これはクラスタ全体のリソースになります。

（NCP 3.1 のみ）マネージャモードでこの機能を有効にするには、次の操作を行います。

[k8s] セクションの enable_lb_crd オプションを True に設定します。
次のコマンドを使用して、NCP YAML ファイルを適用します。
kubectl apply -f ncp-<platform>.yaml

（NCP 3.1 のみ）ポリシーモードで有効にする場合は、次の操作を行います。

[k8s] セクションの enable_lb_crd と enable_vnet_crd オプションを True に設定します。
次のコマンドを使用して、NCP YAML ファイルのポリシーバージョンを適用します。
kubectl apply -f ncp-<platform>-policy.yaml

（NCP 3.1 のみ）マネージャモードで新しい NSX ロードバランサを作成するには、LoadBalancer CRD を定義している YAML ファイルを適用します。次はその例です。

apiVersion: vmware.com/v1alpha1
kind: LoadBalancer
metadata:
    name: cluster1-lbs0
spec:
    httpConfig: {}

（NCP 3.1 のみ）ポリシーモードの場合、 VirtualNetwork を使用して LoadBalancer を作成する必要があります。次はその例です。

apiVersion: vmware.com/v1alpha1
kind: VirtualNetwork
metadata:
    name: vnet
---
apiVersion: vmware.com/v1alpha1
kind: LoadBalancer
metadata:
    name: cluster1-lbs0
spec:
    virtualNetworkName: vnet # Set to match VirtualNetwork object name
    httpConfig: {}

NCP 3.1.1 以降では、この機能を有効にする手順は、マネージャモードとポリシーモードで同じです。

（NCP 3.1.1 以降）この機能を有効にするには、次の操作を行います。

[k8s] セクションの enable_lb_crd オプションを True に設定します。
次のコマンドを使用して、NCP YAML ファイルを適用します。
kubectl apply -f ncp-<platform>.yaml

（NCP 3.1.1 以降）マネージャモードで新しい NSX ロードバランサを作成するには、LoadBalancer CRD を定義している YAML ファイルを適用します。次はその例です。

apiVersion: vmware.com/v1alpha1
kind: LoadBalancer
metadata:
    name: cluster1-lbs0
spec:
    httpConfig: {}

この YAML ファイルは、小規模サイズの NSX ロードバランサと、パーシステンス、SSL、または X-Forward 設定を持たないレイヤー 7 仮想サーバのペアを作成します。仮想サーバの IP アドレスは、ロードバランサ用に設定されたデフォルトの外部プールから割り当てられます。デフォルトのポートは 80 および 443 です。HTTP HOST ヘッダーにカスタムポートが含まれている場合は、標準以外のポートもサポートされます。カスタムポートは、非 TLS Ingress でのみサポートされることに注意してください。

LoadBalancer CRD の作成状態を確認するには、次のコマンドを実行します。

kubectl get lb <name of the LoadBalancer> -o yaml

結果は次のようになります。

status:
 conditions:
 - status: "True"
   type: Ready
 httpVirtualIP: <realized virtual IP>

この結果は、作成が成功したことを示します。作成に失敗した場合、status は False となり、仮想 IP アドレスは含まれません。

NSX ロードバランサおよび仮想サーバの設定をカスタマイズすることもできます。仮想サーバの IP アドレスおよびポートを設定する方法：

spec:
    httpConfig:
        virtualIP: <ip address, default to auto-allocate>
        port: <port number, default to 80>

セッションのアフィニティと X-Forwarded-mode を指定する方法：

spec:
    httpConfig:
         xForwardedFor: <INSERT or REPLACE, default to None>
         affinity:
             type: <source_ip or cookie, default to None>
             timeout: <timeout number, default to 10800>

TLS 設定を構成する方法：

spec:
    httpConfig:
        tls:
            port: <tls port number, default to 443>
            secretName: <name of secret, default to None>
            secretNamespace: <namespace of secret, default to None>

HTTP ポートと HTTPS ポートをデフォルト以外の値に設定しても、Kubernetes の制限により、Ingress 状態を表示するときに Ingress プリンタには常にデフォルトのポート値（80 および 443）が表示されます。Ingress にアクセスするには、引き続き設定されたポートを使用する必要があります。次はその例です。

curl -I -HHost:tea.example.com http://$INGRESS_IP:$CRD_LB_HTTP_PORT/tea

LoadBalancer の作成前または作成後にシークレットを作成できます。証明書を更新するには、最初に LoadBalancer の仕様から secretName および secretNamespace を削除し、シークレットのデータを更新してから、上記の設定を使用して同じシークレットを再接続します。新しいシークレットの作成および secretName と secretNamespace の更新も同じ動作をします。異なる CRD ロードバランサ間で同じシークレットデータを共有することはサポートされていません。異なる証明書を使用して CRD ロードバランサを設定する必要があります。

NSX ロードバランサの状態と統計情報を表示するには、次のコマンドを実行します。

kubectl get lbm

これにより、NSX ロードバランサごとに、すべての NSXLoadBlancerMonitors が一覧表示されます。次の情報が表示されます。

使用状況 - NSX ロードバランサ上のワークロードの数。
トラフィック - 各仮想サーバの集約された統計情報。
健全性 - このフィールドには 2 つのディメンションがあります。
- servicePressureIndex - ロードバランサのパフォーマンスを示します。スコアと重要度という 2 つの値が提供されます。
- infraPressureIndex - 基盤となるインフラストラクチャコンポーネントのパフォーマンスを示します。NCP 2.5.1 では、この値は必ずしも正確ではありません。
- フィールド metrics には、健全性スコアの計算時に考慮されるパラメータの概念が示されています。

ロードバランサの servicePressureIndex が HIGH の場合は、Ingress のワークロードを別のロードバランサに移行できます。これは、LoadBalancer CRD を使用して作成されたデフォルトのロードバランサである必要があります。

専用ロードバランサに Ingress を配置するには、Ingress の仕様にアノテーションを追加します。次はその例です。

 annotations:
   nsx/loadbalancer: <name of the LoadBalancer CRD>

アノテーションがない場合、または null に設定されている場合、Ingress はデフォルトの NSX ロードバランサに配置されます。