Unified Load Balancer 構成およびアドミニストレーション ガイド、リリース 2026.02

PDF

Unified Load Balancer 構成およびアドミニストレーション ガイド、リリース 2026.02

ULB クラスターポリシー(UCP)

Want to summarize with AI?

Log in

ULB クラスターポリシー(UCP)について説明し、主要な概念、要件、および運用上の考慮事項に焦点を当てます。ULB クラスターポリシーは、ULB がサービス通信を受信するノードインターフェイスを識別します。


ULB クラスターポリシーは、ULB がサービス通信を受信するノードインターフェイスを識別します。サービス側ネットワークで使用される物理インターフェイスまたは VLAN サブインターフェイスの名前を構成します。ULB は、クラスター全体にこの構成を適用し、使用可能で起動している構成済みの各インターフェイスでイングレス eBPF 処理をアクティブにします。

ポリシーはインターフェイスを識別しまが、作成されません。構成済みのインターフェイスが現在既存しない場合、または、1 つ以上のモードが停止している場合でもポリシーをコミットできます。ポリシーは引き続き有効ですが、影響を受けるノードはそのインターフェイス経由で ULB サービス通信を処理できません。インターフェイスが使用可能になり、起動すると、ULB が変更を検出し、自動的に使用を開始します。管理者はポリシーを再コミットする必要はありません。

サービスの可用性については、構成済みのインターフェイスが存在し、ULB サービス通信を受信することが予想されるすべてのノードで稼働していることを確認します。既存しないインターフェイスまたは使用できないインターフェイスは、そのノードの処理に影響しますが、クラスター全体のポリシーを無効にすることはありません。

CLI の構成がコミットされると、ULB は自動的にクラスタースコープのポリシーを作成または更新します。管理者は、Kubernetes リソースを作成したり、生成された名前を指定したりしません。CLI の構成からインターフェイスを削除すると、ULB はそのインターフェイスを使用しなくなります。すべてのインターフェイスエントリを削除すると、生成されたポリシーも削除されます。


ULB クラスターポリシーを構成する

手順

ULB がサービス通信に使用するノードインターフェイスを構成します。
[cluster1/data] lbs# config
[cluster1/data] lbs(config)# cluster-policy
[cluster1/data] lbs(config-cluster-policy)# node-interface name ens192.1001
[cluster1/data] lbs(config-cluster-policy)# exit
[cluster1/data] lbs(config)# end

設定を確認します。

手順

  1. ULB が目的のインターフェイス名でポリシーを作成したことを確認します。

    kubectl get ulbclusterpolicy global-ulb-cluster-policy -o yaml
    Sample O/p:
    kubectl get ulbclusterpolicy global-ulb-cluster-policy -o yaml
    apiVersion: lbs.cisco.com/v1alpha1
    kind: UlbClusterPolicy
    metadata:
      name: global-ulb-cluster-policy
    spec:
      nodeInterfaces:
      - name: ens192.1001
    
  2. 各ノードについて報告されたインターフェイスの状態を確認します(UlbNodeInfo は ULB によって作成されます)。

    kubectl get ulbnodeinfos -o yaml
    	Sample O/p:
    apiVersion: v1
    items:
    - apiVersion: lbs.cisco.com/v1alpha1
      kind: UlbNodeInfo
      metadata:
        name: <ulbnodeinfo-node-name-1>
      spec:
        interfaces:
        - name: ens192.1001
          primaryIpv4: <ipv4-address>
          primaryIpv6: <ipv6-address>
          state: up
        nodeName: <node-name-1>
    
    - apiVersion: lbs.cisco.com/v1alpha1
      kind: UlbNodeInfo
      metadata:
        name: <ulbnodeinfo-node-name-2>
      spec:
        interfaces:
        - name: ens192.1001
          primaryIpv4: <ipv4-address>
          primaryIpv6: <ipv6-address>
          state: up
        nodeName: <node-nmae-2>
    
    kind: List
    

ULB ノードインターフェイスの運用状態

レポートの状態

意味と管理者のアクション

up

インターフェイスは、ULB サービス処理に使用できます。インターフェイスレベルでのアクションは不要です。

down

インターフェイスは存在しますが動作していません。サービス通信をそのノードにリダイレクトする前に、インターフェイスを起動します。

unknown

インターフェイスが見つかりません。構成された名前を確認するか、そのノードに必要なインターフェイスを作成します。

Note

ULB クラスターポリシーが存在する場合は、構成が受け入れられたことを確認します。構成済みのインターフェイスがすべてのノードで現在使用可能であるとは限りません。ノードごとのインターフェイスの状態を使用して、運用準備状況を確認します。


IP プールを使用して ULB クラスターポリシーを構成する

手順

ULB がサービス通信に使用するノードインターフェイスと Pod のセカンダリインターフェイスの IP プールを構成します。
[cluster1/data] lbs# config
[cluster1/data] lbs(config)# cluster-policy
[cluster1/data] lbs(config-cluster-policy)# node-interface name <interface-name>
[cluster1/data] lbs(config-cluster-policy)# pod-ip-pool name <pool-name> ip-version v4 cidr <ipv4-cidr> node-subnet-prefix <ipv4-prefix>
[cluster1/data] lbs(config-cluster-policy)# pod-ip-pool name <pool-name> ip-version v6 cidr <ipv6-cidr> node-subnet-prefix <ipv6-prefix>
[cluster1/data] lbs(config-cluster-policy)# exit
[cluster1/data] lbs(config)# end