動的ポート add/del 概念¶
このページは 動的ポート add/del（概要ハブ） の派生で、概念とユーザ責務 に絞る。設定 / 安全削除手順は enhancements-to-add-or-del-ports-dynamically-operations.md、各 mgrd / orch の内部仕様は enhancements-to-add-or-del-ports-dynamically-internals.md、HLD と実装の乖離は enhancements-to-add-or-del-ports-dynamically-limitations.md を参照。
1. 機能スコープ¶
SONiC は本来「init 時にすべてのポートを作る」前提で設計されており、線数固定システム以外で扱いにくかった。本機能は次の 3 つの起動形態をサポートし、さらに post-init で動的に CONFIG_DB の PORT テーブルに add/del することでポート追加・削除を可能にする1:
- 全ポートを
config_dbに持って起動 - 一部ポートだけ持って起動
- ゼロポート で起動（line-card manager がプロビジョニング時に追加する想定）
ポート削除前にユーザは ACL / VLAN / LAG / Buffer PG など 全依存設定を先に削除する責任 を負う1。
2. 初期化フェーズと App-DB フラグ¶
flowchart TD
CDB[(CONFIG_DB:PORT)] --> PSYNC[portsyncd]
PSYNC -->|App-DB 反映| APPDB[(APP_DB)]
PSYNC -->|完了| FLAG1[PortConfigDone]
FLAG1 --> PORCH[portsorch / orchagent]
PORCH -->|SAI port 作成| SAI[SAI / SDK]
SAI -->|host i/f 作成| NL[netlink]
NL --> PSYNC
PSYNC --> SDB[(STATE_DB)]
PSYNC -->|全 host i/f 完了| FLAG2[PortInitDone]PortConfigDone: portsyncd がポート設定を APP_DB に反映完了。orchagent は これを待ってから SAI ポート作成を始める1。PortInitDone: 全 host interface が作成完了。xcvrd/buffermgrd/natmgr/natsyncは これを待つ1。
3. ゼロポート起動の要件¶
新たに zero-port SKU が必要1:
hwsku.jsonに interface セクション無しplatform.jsonに interface セクション無し- SAI profile に port エントリ無し
sonic-cfggen は port 無しで config_db.json を生成する。Pre-existing PR で cfggen / portsyncd / buffer drop counter 周りが「port 0 でも動く」ように改修済み1:
| PR | 内容 |
|---|---|
| sonic-buildimage #7999 | cfggen を port 無しで動かす |
| sonic-swss #1808 | portsyncd を port 無しで動かす |
| sonic-swss #1860 | port 削除時の buffer drop counter 削除 |
3.1 フェーズ別 実装境界¶
HLD は「全ポート / 一部 / ゼロポート起動 + post-init add/del + ref counter による安全削除 + restore」までを提案しているが、master では どのフェーズまで動き、どこから先が未取り込みか に明確な段差がある1。
| Phase | 実装済 (master で動く) | 未実装 (HLD 提案のみ) |
|---|---|---|
| 全ポート / 一部ポート 起動 | ✅ 取り込み済（既存パス） | — |
ゼロポート起動 (cfggen / portsyncd の port=0 対応) |
✅ sonic-buildimage #7999 / sonic-swss #1808 がマージ済 | — |
PortConfigDone / PortInitDone 待ち合わせ |
✅ orchagent / xcvrd / buffermgrd 側で動作 | — |
post-init ポート追加 (PORT を CONFIG_DB に投入 → portsorch で SAI port 作成) |
✅ 動作する（基本パス） | — |
post-init ポート削除 (admin down → 依存削除 → PORT 削除) |
🟡 運用側で全依存を先に削除すれば動く | orchagent 側の ref counter による削除拒否 ロジックは未取り込み |
| ポート restore (削除後の再構築) | — | ❌ HLD 提案のみ、未実装 |
lldpmgrd の動的 port 反映 |
🟡 部分的（pending_cmds 経由） |
一部改修が未マージ |
✅ フェーズはユーザ視点で素直に動作するが、🟡 フェーズは HLD が想定する自動保護が無いため運用側で前述の責務を負う必要があり、❌ フェーズは現行 master では使えない1。
4. Post-init: 追加 / 削除のシーケンス¶
ポート追加¶
sequenceDiagram
participant U as User / lc-manager
participant CDB as CONFIG_DB
participant PSY as portsyncd
participant ADB as APP_DB
participant POR as portsorch
participant SAI as SAI
participant SDB as STATE_DB
U->>CDB: PORT|<name> 追加
CDB->>PSY: set event
PSY->>ADB: PORT_TABLE エントリ追加
ADB->>POR: set event
POR->>SAI: SAI port + host i/f 作成
SAI->>PSY: netlink (host i/f 作成)
PSY->>SDB: PORT_TABLE エントリ追加
SAI->>POR: oper_state 通知 (ASIC_DB)
POR->>ADB: oper_state 反映ポート削除¶
portmgrd 経由で APP_DB から削除し、portsorch が SAI port + host i/f を削除する。state-db のクリーンアップは host i/f の netlink 削除イベント受領後に portsyncd が行う1。