コンテンツにスキップ

BGP_INTERNAL_NEIGHBOR テーブル

概要

マルチ ASIC プラットフォームにおける ASIC 間内部 iBGP セッションを CONFIG_DB で定義するテーブル。同一物理筐体内の複数 ASIC が iBGP で経路を交換するために使用する。bgpcfgd (docker-fpm-frr 内) が読み出して Jinja2 テンプレート (bgpd/templates/internal/) 経由で FRR (bgpd) に反映する1。

通常の BGP_NEIGHBOR との主要な差異:

  • iBGP のみ（ASN は DEVICE_METADATA の bgp_asn と一致することが YANG must で強制）
  • holdtime/keepalive/nhopself は CONFIG_DB 値を 無視し、テンプレートがハードコード値を適用
  • sub_role / switch_type によってルートマップ・next-hop-self が自動付与される

データフロー (自動生成)

flowchart LR
  CDB[("CONFIG_DB<br/>BGP_INTERNAL_NEIGHBOR")]
  DM["bgpcfgd"]
  FRR["FRR bgpd"]
  CDB --> DM --> FRR

凡例

CONFIG_DB から FRR までの典型経路を示す。詳細・例外は本ページ本文を参照。

key 構造

BGP_INTERNAL_NEIGHBOR|<neighbor>
BGP_INTERNAL_NEIGHBOR|<vrf_name>|<neighbor>

<neighbor> は内部 ASIC の IP アドレス（IPv4 または IPv6）。

フィールド一覧

sonic-bgp-common.yang の sonic-bgp-cmn-neigh grouping を uses する。BGP_NEIGHBOR の sonic-bgp-cmn とは 別の grouping（フィールドが少ない簡略版）であることに注意。

フィールド 型 YANG default bgpcfgd 実装挙動
neighbor (key) inet:ip-address — YANG must で DEVICE_METADATA の bgp_asn 参照
asn uint32 0..4294967295 なし YANG must で DEVICE_METADATA bgp_asn と一致を強制
local_addr inet:ip-address なし (mandatory) YANG mandatory true; bgpcfgd は欠如時 warn のみで処理続行（乖離）
name string なし optional; 欠如時は neighbor アドレスを tag として使用
holdtime uint16 なし dead field — テンプレートが timers 3 10 をハードコードで上書き
keepalive uint16 なし dead field — テンプレートが timers 3 10 をハードコードで上書き
nhopself uint8 0..1 なし dead field — sub_role/switch_type でプラットフォーム依存に上書き
rrclient uint8 0..1 なし 有効 field: != 0 のとき route-reflector-client を生成
admin_status up/down なし minigraph 生成時は常に up; ランタイム更新も唯一サポートされるフィールド

ハードコードデフォルトと dead field

instance.conf.j2 が CONFIG_DB の値に関わらず以下をハードコードする:

neighbor <addr> timers 3 10        # keepalive=3, holdtime=10 (CONFIG_DB 値無視)
neighbor <addr> timers connect 10  # conn_retry 相当 (CONFIG_DB 値無視)

peer-group.conf.j2 が常時適用する設定（フィールド値依存なし）:

neighbor INTERNAL_PEER_V4 soft-reconfiguration inbound
neighbor INTERNAL_PEER_V4 allowas-in 1
neighbor INTERNAL_PEER_V4 send-community
neighbor INTERNAL_PEER_V4 route-map FROM_BGP_INTERNAL_PEER_V4 in
neighbor INTERNAL_PEER_V4 route-map TO_BGP_INTERNAL_PEER_V4 out

プラットフォーム依存挙動

DEVICE_METADATA.sub_role および switch_type の値によって FRR 設定が自動分岐する:

条件 自動適用される設定 テンプレート
sub_role == 'BackEnd' ピアグループ単位で route-reflector-client 付与 peer-group.conf.j2
sub_role == 'BackEnd' または switch_type == 'chassis-packet' 個別 neighbor に next-hop-self force instance.conf.j2
switch_type == 'chassis-packet' update-source Loopback4096 + ttl-security hops 1 peer-group.conf.j2
sub_role == 'BackEnd' FROM_BGP_INTERNAL_PEER_V4 に set originator-id <Loopback4096 or bgp_router_id> policies.conf.j2
switch_type == 'chassis-packet' community-list + tag + local-preference によるルーティングポリシー policies.conf.j2

YANG-実装 Discrepancy

フィールド YANG 定義 bgpcfgd 実装 乖離種別
holdtime uint16（YANG default なし） テンプレートで完全無視、timers 3 10 ハードコード dead field
keepalive uint16（YANG default なし） テンプレートで完全無視、timers 3 10 ハードコード dead field
nhopself uint8 0..1 テンプレートで完全無視、sub_role/switch_type で代替 dead field + プラットフォーム依存乖離
local_addr mandatory true（YANG refine） bgpcfgd は欠如時 log_warn のみで処理続行 YANG-実装 discrepancy

制約

  • asn: YANG must で DEVICE_METADATA の bgp_asn と一致かつ >= 1。iBGP 専用テーブル
  • local_addr: YANG mandatory true + neighbor と同一 AF（IPv4-IPv4 or IPv6-IPv6）であること
  • minigraph 生成時: ASN 未設定 or 0 のエントリは filter_bad_asn() でサイレント除外

購読者

  • bgpcfgd (docker-fpm-frr 内、BGPPeerMgrBase(peer_type="internal")):
  • check_neig_meta=False（DEVICE_NEIGHBOR_METADATA チェックなし）
  • check_deployment_id は constants 設定次第
  • peer_type internal のみ Loopback4096 依存を追加 (managers_bgp.py L146)
  • sonic-py-common.multi_asic: is_bgp_session_internal() で参照（マルチ ASIC 判定用）

コード由来の暗黙デフォルト

フィールドデフォルト一覧

フィールド YANG default コード fallback / ハードコード dead? 乖離種別
asn なし minigraph: ASN 欠落エントリは filter_bad_asn() で除外（silent drop） — —
local_addr mandatory（YANG） bgpcfgd: 欠如時 warn のみで続行 — YANG-実装 discrepancy
holdtime なし instance.conf.j2: timers 3 10 ハードコード（CONFIG_DB 値無視） dead field dead field
keepalive なし instance.conf.j2: timers 3 10 ハードコード（CONFIG_DB 値無視） dead field dead field
nhopself なし テンプレートで完全無視。sub_role/switch_type が next-hop-self force を制御 dead field dead field + プラットフォーム依存
rrclient なし 0 相当（欠如時 int != 0 が False → route-reflector-client なし） — —
admin_status なし minigraph: 内部セッションは常に 'up'（ハードコード） — —
name なし 欠如時は neighbor アドレスを tag として使用 — —
timers connect （フィールドなし） instance.conf.j2 が timers connect 10 をハードコード — ハードコード
soft-reconfiguration inbound （フィールドなし） peer-group.conf.j2 が常時付与 — ハードコード
allowas-in 1 （フィールドなし） peer-group.conf.j2 が常時付与 — ハードコード
send-community （フィールドなし） peer-group.conf.j2 が常時付与 — ハードコード

重要な暗黙挙動

  1. holdtime/keepalive は CONFIG_DB 値が無効: minigraph が holdtime=180, keepalive=60 を書き込んでも bgpcfgd テンプレートが timers 3 10 で上書きするため、オペレーターが CONFIG_DB を変更しても実際の FRR タイマーは変わらない。

  2. nhopself は dead field: minigraph が nhopself=1/0 を書き込んでも bgpcfgd は読まない。next-hop-self は sub_role と switch_type によって自動決定される。

  3. local_addr 欠如時の silent warn: YANG は mandatory だが bgpcfgd は warn を出して続行する。ただし interface 解決ができなければ peer 追加は延期（書込み順依存）。

  4. admin_status は常に 'up'（minigraph 生成時）: 内部 BGP セッションを手動で down にする実用的なパスは minigraph 以外からの直接 CONFIG_DB 書き込みのみ。

  5. YANG-実装 discrepancy（local_addr mandatory）: YANG バリデーターは local_addr 欠如を拒否するが、bgpcfgd ランタイムは欠如のまま処理を進める。YANG バリデーションを通過しないエントリが CONFIG_DB に直接書き込まれた場合の動作は未定義。

スキャン証跡

  • instance.conf.j2 34 行全行精読: timers ハードコード、nhopself 参照なし確認
  • peer-group.conf.j2 36 行全行精読: soft-reconfiguration/allowas-in/send-community 常時付与確認
  • managers_bgp.py 598 行全行精読: local_addr warn only、check_neig_meta=False 確認
  • minigraph.py L1297-1430: filter_bad_asn、admin_status='up' ハードコード確認

関連 CONFIG_DB / YANG / CLI

  • 関連 CONFIG_DB: BGP_NEIGHBOR、BGP_VOQ_CHASSIS_NEIGHBOR、DEVICE_METADATA
  • 関連 YANG: sonic-bgp-internal-neighbor、sonic-bgp-common
  • 関連 CLI: マルチ ASIC 環境では show ip bgp summary / vtysh -c 'show bgp neighbor'

関連リファレンス

  • YANG: sonic-bgp-internal-neighbor / sonic-bgp-common
  • CONFIG_DB: BGP_NEIGHBOR

引用元

運用ヒント

典型値（minigraph 生成時）

"BGP_INTERNAL_NEIGHBOR": {
  "10.0.0.1": {
    "asn": "65001",
    "holdtime": "180",
    "keepalive": "60",
    "local_addr": "10.0.0.2",
    "name": "ASIC0",
    "nhopself": "0",
    "rrclient": "0",
    "admin_status": "up"
  }
}

注意: holdtime/keepalive は実際には効かない

上記の holdtime: 180, keepalive: 60 は minigraph が書き込むが、bgpcfgd テンプレートが timers 3 10 をハードコードで上書きするため FRR に反映されない。

確認コマンド

sonic-db-cli CONFIG_DB hgetall 'BGP_INTERNAL_NEIGHBOR|10.0.0.1'
show ip bgp summary
vtysh -c 'show bgp neighbor 10.0.0.1'

  1. YANG 定義: sonic-bgp-internal-neighbor.yang. https://github.com/sonic-net/sonic-buildimage/blob/master/src/sonic-yang-models/yang-models/sonic-bgp-internal-neighbor.yang; 実装: bgpcfgd/managers_bgp.py、bgpd/templates/internal/ ↩