TUNNEL_DECAP_TERM_TABLE¶

YANG 未定義

TUNNEL_DECAP_TERM_TABLE は CONFIG_DB ではなく APPL_DB / STATE_DB のテーブルであり、sonic-yang-models には対応モジュールが存在しない。本ページは schema.h のテーブル名定数と tunneldecaporch.cpp / tunnelmgr.cpp の実装からフィールドを起こしたもの。

概要¶

tunneldecaporch が消費する アプリケーション層テーブル。CONFIG_DB の TUNNEL を tunnelmgrd が APPL_DB に投影する形で生成される¹。subnet decap 機能では ipinip.json.j2 テンプレートから swssconfig が書き込む。tunneldecaporch (orchagent) が SAI create_tunnel_term_table_entry() を呼び出してハードウェアに設定する。

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

flowchart LR
  CDB[("CONFIG_DB<br/>TUNNEL")]
  TM["tunnelmgrd"]
  CDB --> TM
  APPDB[("APP_DB<br/>TUNNEL_DECAP_TERM_TABLE")]
  TM --> APPDB
  ORCH["tunneldecaporch"]
  APPDB --> ORCH
  SYNCD["syncd"]
  ORCH --> SYNCD
  SAI["SAI<br/>sai_tunnel_api"]
  SYNCD --> SAI

凡例

CONFIG_DB から SAI までの典型経路。subnet decap の場合は ipinip.json.j2 → swssconfig → APPL_DB の経路も存在する。

DB / key¶

APPL_DB:   TUNNEL_DECAP_TERM_TABLE:<tunnel_name>:<dst_ip_prefix>
STATE_DB:  TUNNEL_DECAP_TERM_TABLE|<tunnel_name>|<dst_ip_prefix>

テーブル名定数は schema.h の APP_TUNNEL_DECAP_TERM_TABLE_NAME (L50) / STATE_TUNNEL_DECAP_TERM_TABLE_NAME (L489)²。

フィールド¶

フィールド	型	説明
`term_type`	string `P2P`/`P2MP`/`MP2MP`	トンネル終端エントリのタイプ。省略時の暗黙値は `P2MP`
`src_ip`	IP prefix (IPv4/IPv6)	送信元 IP prefix。`P2MP` では省略可、`P2P` と `MP2MP` (non-subnet) では必須
`subnet_type`	string `vlan`/`vip`	サブネット decap term の種別。通常 P2P/P2MP term では省略する

制約¶

term_type は P2P, P2MP, MP2MP のいずれかのみ有効
P2P では src_ip が必須。なければ "no source IP is provided." を LOG_ERROR してスキップ
MP2MP (non-subnet-decap) も src_ip が必須
subnet_type が存在する場合は MP2MP のみ許可
subnet decap tunnel (IPINIP_SUBNET/IPINIP_V6_SUBNET) に対しては MP2MP のみ許可

フィールドのコード由来デフォルト (Phase A)¶

term_type¶

条件	デフォルト値	由来
フィールド省略時	`P2MP`	`tunneldecaporch.cpp` L361: `TunnelTermType term_type = TUNNEL_TERM_TYPE_P2MP;`
CONFIG_DB `TUNNEL` に `src_ip` あり	`P2P` (tunnelmgrd が書き込む)	`tunnelmgr.cpp` L283
CONFIG_DB `TUNNEL` に `src_ip` なし	`P2MP` (tunnelmgrd が書き込む)	`tunnelmgr.cpp` L287
subnet decap term	`MP2MP` (ipinip.json.j2 が書き込む)	`ipinip.json.j2` L117, L183

tunnelmgrd は常に term_type を明示的に書き込むため、省略されるケースは直接 APPL_DB を操作する場合のみ。

src_ip¶

条件	デフォルト値	由来
`P2MP` term	省略（フィールドなし）	`tunnelmgr.cpp` L284-288: `src_ip` フィールドを追加しない
`P2P` term	必須（省略不可）	`tunneldecaporch.cpp` L456-459
`MP2MP` subnet decap term	`subnetDecapConfig.src_ip` / `src_ip_v6` から自動注入	`tunneldecaporch.cpp` L478-500
`MP2MP` non-subnet term	必須（省略不可）	`tunneldecaporch.cpp` L461-464

P2MP では src_ip が省略されるため、SAI SAI_TUNNEL_TERM_TABLE_ENTRY_ATTR_SRC_IP は設定されない (tunneldecaporch.cpp L948-959)。

subnet_type¶

条件	デフォルト値	由来
通常 P2P/P2MP term	省略（フィールドなし）	`tunnelmgr.cpp` で書き込まない
VLAN subnet decap	`"vlan"`	`ipinip.json.j2` L119, L185
VIP subnet decap	`"vip"`	`tunneldecaporch.cpp` L428-432 (有効値として定義)

subnet_type は SAI 属性に直接マップされない。orchagent の内部ステート (TunnelTermEntry.subnet_type) と STATE_DB に記録される用途のみ。

SAI 固定デフォルト (常にハードコード)¶

SAI 属性	値	由来
`SAI_TUNNEL_TERM_TABLE_ENTRY_ATTR_VR_ID`	`gVirtualRouterId` (デフォルト VRF)	`tunneldecaporch.cpp` L921-923
`SAI_TUNNEL_TERM_TABLE_ENTRY_ATTR_TUNNEL_TYPE`	`SAI_TUNNEL_TYPE_IPINIP`	`tunneldecaporch.cpp` L940-942
`SAI_TUNNEL_TERM_TABLE_ENTRY_ATTR_ACTION_TUNNEL_ID`	対応するトンネルの OID	`tunneldecaporch.cpp` L944-946

購読者¶

tunneldecaporch (orchagent): SAI create_tunnel_term_table_entry() / remove_tunnel_term_table_entry() を呼び出す
STATE_DB 側はモニタリング用ミラー (stateTunnelDecapTermTable)

書き込み入り口¶

tunnelmgrd¶

CONFIG_DB TUNNEL テーブルを購読し、src_ip の有無から自動的に P2P/P2MP を判定して APPL_DB へ書き込む (tunnelmgr.cpp L278-289)。

swssconfig (ipinip.json.j2)¶

ビルド時テンプレートから生成。典型的な書き込みパターン:

{
  "TUNNEL_DECAP_TERM_TABLE:IPINIP_TUNNEL:10.0.0.1": {
    "term_type": "P2MP"
  }
}

{
  "TUNNEL_DECAP_TERM_TABLE:IPINIP_SUBNET:192.168.0.0/24": {
    "term_type": "MP2MP",
    "subnet_type": "vlan"
  }
}

db_migrator¶

db_migrator.py に旧 TUNNEL_DECAP_TABLE から TUNNEL_DECAP_TERM_TABLE へのマイグレーションロジックが存在する。

引用元¶

tunnelmgrd 実装: tunnelmgr.cpp. https://github.com/sonic-net/sonic-swss/blob/4305596156d70e9797e8a881b3d19b46de0bce0d/cfgmgr/tunnelmgr.cpp ↩
テーブル名定数: schema.h. https://github.com/sonic-net/sonic-swss-common/blob/158de8d3463ff4b841653f6d57190bb142b80d9c/common/schema.h#L50 ↩