Container Network Interface (CNI)

コンテナランタイムが Pod のネットワーク設定を差し替え可能な実行ファイルに委譲するための、最小でランタイム非依存な仕様と Go ライブラリ。

カテゴリ: Service Mesh & Networking
CNCF 成熟度: Incubating
言語: Go
ライセンス: Apache-2.0
リポジトリ: containernetworking/cni
ドキュメント基準コミット: 7c27007 (2025-12-15、v1.3.0 より後)

何をするものか

CNI は Linux コンテナのネットワークインターフェースを設定するための仕様と Go ライブラリ群である。リポジトリが持つのは 3 つ、書かれた仕様、ランタイムが組み込む参照 Go ライブラリ、サンプルの CLI ツールだ。データプレーンは意図的に同梱しない。bridge や host-local といった実プラグインは別リポジトリにあり、Calico / Cilium / Flannel などは同じ契約をサードパーティが実装したものである (README.md:13)。

契約が狭いのは意図的だ。CNI はコンテナのネットワーク接続性と、コンテナ削除時の割り当てリソース回収だけに関心を持つ (README.md:13)。すべてはプロセス境界をまたいで行われる。ランタイムがプラグインバイナリを exec し、意図を環境変数と stdin の JSON で渡し、stdout から JSON の結果を読み取る。

containerd / CRI-O / kubelet のようなランタイムは libcni ライブラリをリンクし、ディスク上のネットワーク設定をパースしてプラグインを順に呼び出す。設定の注入、プラグインの探索、結果のキャッシュ、バージョン折衝はライブラリが担うので、各プラグインは小さく保たれる。

いつ使うか

コンテナランタイムを作る・拡張していて、Pod をネットワークに接続する標準的な方法が欲しいとき。
ネットワークプラグインを書いていて、ランタイムごとのコードなしに任意の CNI 準拠ランタイムで動かしたいとき。
Kubernetes を運用し、いずれも CNI を話すプラグイン (Calico / Cilium / Flannel / Multus) を選んだり連結したりするとき。
ターンキーなデータプレーンやネットワークポリシーエンジンが欲しい場合は、ここではない。CNI はインターフェースであり、その機能を提供する実装は別途選ぶ。

このディープダイブの構成

歴史: 起源・マイルストーン・存在理由。
アーキテクチャ: コンポーネントとリクエストの流れ。
採用事例・エコシステム: 誰が動かし、周囲に何があるか。
内部実装: ソースから読んだ重要なコードパス。
はじめに: インストールと最初の動く構成。

Container Network Interface (CNI) ​

何をするものか ​

いつ使うか ​

このディープダイブの構成 ​

出典 ​

Container Network Interface (CNI)

何をするものか

いつ使うか

このディープダイブの構成

出典