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

PDF

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

その他の構成

Want to summarize with AI?

Log in

技術的な実装および運用に関するその他の構成について説明します。これには、Cilium BPF マップの構成方法や、Cilium Hubble 統計の有効化方法が含まれます



cilium BPF マップを構成する

この手順を使用して、適切な CLI コマンドを入力して、Cilium の BPF マップサイズを編集します。

すべてのマップサイズを構成する必要はありません。セットアップに必要な数のみを調整します。デフォルトでは、この CLI は値を設定しないため、Cilium BPF マップサイズは、Cilium の標準に従います。この CLI で変更をコミットすると、Cilium Pod が再起動します。値が、定義された制限内にあることを確認します。そうしないと、コミットは失敗します。

手順

構成モードを開始し、次のコマンドを使用して、目的の BPF マップサイズを設定します。

例:

config
            [no] cilium bpf auth-map-max <value>
            [no] cilium bpf fragments-map-max <value>
            [no] cilium bpf lb-affinity-map-max <value>
            [no] cilium bpf lb-maglev-map-max <value>
            [no] cilium bpf lb-maglev-table-size <value>
            [no] cilium bpf lb-map-max <value>
            [no] cilium bpf lb-rev-nat-map-max <value>
            [no] cilium bpf lb-service-backend-map-max <value>
            [no] cilium bpf lb-service-map-max <value>
            [no] cilium bpf lb-source-range-map-max <value>
            [no] cilium bpf map-dynamic-size-ratio <value>
            [no] cilium bpf neigh-global-max <value>
            [no] cilium bpf node-map-max <value>
            [no] cilium bpf policy-map-max <value>
            exit
  • すべてのマップサイズを構成する必要はありません。セットアップに必要な数のみを調整します。

  • デフォルトでは、この CLI は値を設定しないため、Cilium BPF マップサイズは、Cilium の標準に従います。

  • この CLI で変更をコミットすると、Cilium Pod が再起動します。

  • 値が、定義された制限内にあることを確認します。そうでない場合、コミットは失敗します。

これらのコマンドに関連する最大サイズの参考資料として、次の表を使用します。

コマンド

説明

範囲

cilium bpf auth-map-max

BPF 認証マップの最大サイズ

65536 ~ 4194304

cilium bpf fragments-map-max

BPF フラグメントマップの最大サイズ

4096 ~ 65536

cilium bpf lb-affinity-map-max

BPF ロードバランサのアフィニティマップの最大サイズ

65536 ~ 4194304

cilium bpf lb-maglev-map-max

BPF ロードバランサ Maglev マップの最大サイズ

65536 ~ 4194304

cilium bpf lb-maglev-table-size

BPF ロードバランサ Maglev ルックアップテーブルのサイズ。

MAGLEV_TABLE_SIZE_251

MAGLEV_TABLE_SIZE_509

MAGLEV_TABLE_SIZE_1021

MAGLEV_TABLE_SIZE_2039

MAGLEV_TABLE_SIZE_4093

MAGLEV_TABLE_SIZE_8191

MAGLEV_TABLE_SIZE_16381

MAGLEV_TABLE_SIZE_32749

MAGLEV_TABLE_SIZE_65521

MAGLEV_TABLE_SIZE_131071

cilium bpf lb-map-max

BPF ロードバランサマップの最大サイズ

65536 ~ 4194304

cilium bpf lb-rev-nat-map-max

BPF ロードバランサのリバース NAT マップの最大サイズ。

65536 ~ 4194304

cilium bpf lb-service-backend-map-max

BPF ロードバランササービスのバックエンドマップの最大サイズ。

65536 ~ 4194304

cilium bpf lb-service-map-max

BPF ロード バランサ サービス マップの最大サイズ。

65536 ~ 4194304

cilium bpf lb-source-range-map-max

BPF ロードバランサソース範囲の最大サイズ

65536 ~ 4194304

cilium bpf map-dynamic-size-ratio

使用可能なメモリの量に対する BPF マップの動的なサイジングに使用される比率

0.0 ~ 1.0

cilium bpf neigh-global-max

BPF ネイバーマップのグローバル最大サイズ。

65536 ~ 4194304

cilium bpf node-map-max

BPF ノードマップの最大サイズ

16384 ~ 4194304

cilium bpf policy-map-max

BPF ポリシーマップの最大サイズ。

8192 ~ 16384


Cilium Hubible 統計を有効にする

手順

構成モードに入り、データ収集のために Hubbble 統計を有効にします。

例:


            config
            metrics collection
            exit
          
Note

デフォルトでは、この CLI は無効になっています。Hubbble 統計を有効にすると、Cilium Pod が再起動します。


ULB データパスロギングを有効または無効にする

データパスロギングは、個別のクラスター全体の障害対応制御です。ULB データパスロギングは、デフォルトでは無効に設定されています。ulb-logging で spec.dataPathLogging.enable を true に設定すると有効になりき、false に設定すると無効になります。この設定は、eBPF データパス診断ロギングにのみ影響します。通常のコンポーネントのロギングは引き続き使用できます。

手順

  1. ulb-logging という名前のサポートされているシングルトン UlbLogging リソースを構成します。

    apiVersion: lbs.cisco.com/v1alpha1
    kind: UlbLogging
    metadata:
      name: ulb-logging
    spec:
      dataPathLogging:
        enable: true
    
  2. リソースが [適用済み(Applied)] フェーズを報告することを確認します。

    kubectl get ulbloggings ulb-logging
    Note

    データパスロギングは、簡潔で制御された障害対応のみを目的としています。有効にすると、大量の診断出力が生成され、特に通信が多い場合、CPU 使用率が大幅にスパイクする可能性があります。通常の実稼働操作中には、データパスロギングを有効のままにしないでください。問題を再現して必要な情報を収集するために必要な時間だけ有効にし、その後すぐに無効にします。