サイドカーとは、アプリ本体のコンテナのすぐ横にもう1つのコンテナを並べ、ログ転送や通信の仲介といった補助機能を本体の外へ切り出す構成のことです。オートバイの側車(サイドカー)のように本体へ寄り添うことから、この名が付きました。iPadをMacの2台目のディスプレイにするAppleのSidecar、写真の編集情報を元画像の横に保存するサイドカーファイル、株式市場のサイドカー(プログラム売買の一時停止措置)とは別の話です。本記事ではKubernetes 1.37で旧来の書き方とネイティブサイドカーの挙動を実測し、YAMLの書き方から採用を見送る条件までを扱います。
まとめ:サイドカーコンテナの定義方法と採用判断
Kubernetesでサイドカーを組むとき、起動と終了の順序を制御したいなら、initContainersにrestartPolicy: Alwaysを付けるネイティブサイドカーを使います。1.29から既定で有効になり、1.33で安定版になりました。containersに2つ並べる旧来の書き方では、起動と終了の順序が保証されません。
Kubernetes 1.37での実測結果は次のとおりです。
- 旧来方式のJobは、本体が3秒で終わってもサイドカーが動き続けるため完了しなかった。ネイティブ方式では完了した
- ネイティブ方式でも、サイドカーがSIGTERMを処理しないとJobの完了が30秒遅れた(猶予期間ぶん待ってから強制終了されるため)
- Pod削除時、旧来方式は本体とサイドカーに同時にSIGTERMが届いた。ネイティブ方式は本体の終了を待ってからサイドカーを止めた(3回とも同じ)
採用の判断軸は、言語構成と、補助機能を本体と別に更新・権限分離したいかどうかです。言語が混在し、暗号化・ログ・監視を横断的に入れたいなら効きます。単一言語で数個のサービスなら、まずライブラリや基盤の標準機能で足りるかを確かめ、補助機能を本体と別に更新したい・権限を分けたい場合にだけサイドカーを選びます。
サイドカーパターンの仕組みと3種の補助コンテナ
サイドカーパターンは、本体(メインコンテナ)に手を入れずに機能を「横付け」する設計です。コンテナの仕組みと仮想マシンとの違いを前提に、なぜ1つの単位に複数のコンテナを束ねられるのかから見ていきます。
Pod内でネットワークとストレージを共有する構成
KubernetesのPodに同居するコンテナは、同じネットワーク名前空間を共有します。サイドカーはlocalhostで本体と通信でき、emptyDirなどのボリュームを共有すれば、本体が書いたログファイルをサイドカーが読んで外部へ送れます。Kubernetes公式のサイドカーコンテナの説明も、サイドカーは本体と同じネットワークとストレージの名前空間を共有するとしています。
サイドカー・アンバサダー・アダプターの役割の違い
補助コンテナの型は、Brendan BurnsとDavid Oppenheimerが2016年のHotCloudで発表した論文Design patterns for container-based distributed systemsで整理されました。
- サイドカー:本体の機能を拡張する汎用型(ログ転送、設定ファイルの同期など)
- アンバサダー:本体の外向き通信を代理するプロキシ型(接続先の切り替えを肩代わりする)
- アダプター:本体の出力を外部の標準形式へそろえる変換型(監視形式の統一など)
実装上はどれも同じPodに置く補助コンテナなので、広い意味ではまとめて「サイドカー」と呼ばれます。
ログ転送・プロキシ・設定同期など外へ出される代表機能
サイドカーに切り出されるのは、どのアプリにも要るがアプリ本体の関心事ではない処理です。代表はログ転送(Fluent Bitなど)、通信のプロキシ(Envoyなど)、監視エージェント、Gitリポジトリからの設定同期の4つです。ログの集め方そのものを比べたいときはログ集約の収集・転送の構成で、サイドカー型とノード単位のDaemonSet型の違いを扱っています。
Kubernetesでサイドカーコンテナを定義する書き方
Kubernetesのネイティブサイドカーは、1.28(2023年8月)でアルファとして入り、1.29でSidecarContainersフィーチャーゲートが既定で有効になり、1.33(2025年4月)で安定版になりました。コンテナオーケストレーションとしてKubernetesを1.29以降で運用しているなら、追加の設定なしで使えます。
旧来方式:containersに並べる書き方と弱点
1.28より前は、本体とサイドカーをcontainersに並べるしかありませんでした。今も動きますが、両者の起動順序と終了順序は保証されません。
apiVersion: batch/v1
kind: Job
metadata:
name: job-classic
spec:
backoffLimit: 0
template:
spec:
restartPolicy: Never
containers:
- name: main
image: busybox:1.37
command: ['sh', '-c', 'echo done; sleep 3']
- name: logshipper # サイドカーのつもりでも扱いは通常コンテナ
image: busybox:1.37
command: ['sh', '-c', 'sleep 100000']
ネイティブ方式:initContainersへのrestartPolicy: Alwaysの指定
サイドカーをinitContainersへ移し、コンテナ単位のrestartPolicy: Alwaysを付けます。これで本体より先に起動し、本体より後に止まります。
apiVersion: batch/v1
kind: Job
metadata:
name: job-native
spec:
backoffLimit: 0
template:
spec:
restartPolicy: Never
initContainers:
- name: logshipper
image: busybox:1.37
restartPolicy: Always # この1行でネイティブサイドカーになる
command: ['sh', '-c', 'trap "exit 0" TERM; sleep 100000 & wait']
containers:
- name: main
image: busybox:1.37
command: ['sh', '-c', 'echo done; sleep 3']
サイドカーのコマンドにtrap "exit 0" TERMを入れている理由は、次章の実測で示します。
startupProbeによる本体の起動待機と準備完了判定
ネイティブサイドカーは「起動した」と判定されてから次のコンテナへ進みます。startupProbeが無ければプロセスが動いた時点で起動扱い、あればstartupProbeの成功を待ちます。プロキシの準備前に本体が通信を始めて失敗する問題は、ここで防げます。
initContainers:
- name: proxy
image: busybox:1.37
restartPolicy: Always
command: ['sh', '-c', 'sleep 8; touch /tmp/ready; trap "exit 0" TERM; sleep 100000 & wait']
startupProbe:
exec:
command: ['test', '-f', '/tmp/ready']
periodSeconds: 1
failureThreshold: 30
この定義で測ると、proxyの起動から9秒後に本体が起動しました。startupProbeを外した対照では、両者が同じ秒に起動しています。プローブの種類と書き方はLiveness ProbeとReadiness Probeの違いで扱っています。
通常のInitコンテナとの違い
同じinitContainersに書いても、restartPolicy: Alwaysの有無で役割が変わります。
| 項目 | 通常のInitコンテナ | ネイティブサイドカー |
|---|---|---|
| 動作期間 | 完了してから次へ進む | Podの終了まで動き続ける |
| 本体との同時稼働 | しない | する |
| Probe | 使えない | startup・readiness・liveness |
| 本体とのやり取り | ボリューム経由の一方向 | localhost通信もできる |
旧来方式とネイティブサイドカーの挙動差をKubernetes 1.37で実測
2026年11月15日に、kind v0.33.0で作ったKubernetes v1.37.0の1ノードクラスタとbusybox:1.37で、前章のYAMLを動かしました。終了順序は3回測り、3回とも同じ順序でした。
| 測った項目 | 旧来方式 | ネイティブ方式 |
|---|---|---|
| Jobの完了 | 50秒後もRunning(0/1) | Complete(1/1) |
| Job完了までの時間 | 完了しない | SIGTERM処理あり8秒・なし約30秒遅延 |
| startupProbeありの起動 | 順序指定なし | サイドカー起動の9秒後に本体 |
| Pod削除時のSIGTERM | 本体とサイドカーに同時 | 本体の終了後にサイドカー |
旧来方式のJob完了を妨げる常駐サイドカー
旧来方式では、本体のmainは起動から3秒で終了コード0で終わりました。ところがlogshipperが動き続けるため、Podは1/2 NotReadyのまま、Jobは50秒後もRunningでした。バッチやCronJobにログ転送のサイドカーを付けると、この状態で止まり続けます。ネイティブ方式の同じJobはCompleteになりました。公式ドキュメントが書く「サイドカーはJobの完了を妨げない」という挙動です。
SIGTERM未処理のサイドカーによるJob完了遅延の実測
ネイティブ方式でも落とし穴が1つありました。サイドカーのコマンドをsleep 100000だけにすると、本体の終了から30秒後にサイドカーが終了コード137(SIGKILL)で止まり、その後でJobが完了しました。シェルがPID 1で動くとSIGTERMの既定動作が働かず、猶予期間(terminationGracePeriodSecondsの既定30秒)を使い切ってから強制終了されたためです。
trap "exit 0" TERMを足すと、サイドカーは本体の終了から1秒後に終了コード0で止まり、Jobは開始から8秒で完了しました。自作のサイドカーイメージでは、SIGTERMを受けたら速やかに終わる処理を必ず入れてください。Job1本あたり30秒でも、数百本流すバッチでは無視できない差になります。
Pod削除時の終了順序と本体の後処理中のプロキシ維持
本体はSIGTERMを受けてから5秒かけて後処理し、サイドカーはSIGTERMで即座に終わるように作り、Podを削除しました。旧来方式では、3回とも本体とサイドカーに同じ秒にSIGTERMが届き、サイドカーが先に消えました。本体がプロキシ経由で通信するなら、後処理の5秒間は外へ出られません。ネイティブ方式では、本体が終わった秒にサイドカーへSIGTERMが届きました。本体が後処理で外部APIを呼ぶ、キューに処理結果を書き戻すといった構成では、この差がそのまま失敗率に表れます。
実効リソース要求の計算:初期化時と常駐時の最大値
サイドカー(CPU 300m・メモリ64Mi)、続けて通常のInitコンテナ(1000m・256Mi)、本体(200m・128Mi)という順のPodを作り、ノードの割り当て表示を確認しました。Podの要求はCPU 1300m・メモリ320Miでした。本体とサイドカーの合計(500m・192Mi)ではなく、「通常のInitコンテナ+それより前に起動したサイドカー」のほうが大きいので、そちらが採られています。KEP-753の計算式どおりの結果で、マイグレーション用のInitコンテナに大きな要求を書くと、スケジューリング上はサイドカーの分がさらに上乗せされます。
Docker ComposeとAmazon ECSでサイドカーを組む方法
Kubernetes以外でも、サイドカーは「同じ実行単位に補助コンテナを置き、通信やボリュームを共有する」という形で組めます。
Docker Composeのnetwork_mode: service:によるネットワーク共有
Composeでは、サイドカー側にnetwork_mode: service:<本体のサービス名>を書くと、本体のネットワークをそのまま使えます(Compose仕様のnetwork_mode)。同じサービスにnetworksを併記するとファイルが拒否される点に注意してください。
services:
app:
image: nginx:1.29
healthcheck-sidecar:
image: busybox:1.37
network_mode: service:app # appと同じネットワーク名前空間に入る
command: ['sh', '-c', 'while true; do wget -q -O /dev/null http://localhost:80/ && echo ok; sleep 5; done']
2026年11月15日にDocker 29.5.2で起動したところ、サイドカーからlocalhost:80への要求がnginxに届き、成功を示すokが5秒間隔で出力されました(12秒間に3回)。ログ転送のようにファイルを受け渡すなら、両方のサービスに同じ名前付きボリュームをマウントします。
Composeの書き方全体はDocker Composeのcompose.yamlの書き方にまとめています。
Amazon ECSのdependsOnによる起動順序とessentialによる停止連動
Amazon ECSでは、タスク定義のcontainerDefinitionsに複数のコンテナを並べます。起動順はdependsOnで決め、停止時にはその依存関係が逆転します。起動条件は4種類です(ContainerDependencyのAPIリファレンス)。
START:依存先が起動したら起動するCOMPLETE:依存先が終了したら起動する(終了コードは問わない。essentialがfalseの依存先にのみ指定可能)SUCCESS:依存先が終了コード0で終わったら起動する(essentialがfalseの依存先にのみ指定可能)HEALTHY:依存先のヘルスチェックが成功したら起動する(確認はタスク起動時だけ)
もう1つ効くのがessentialです。省略するとtrue扱いで、trueのコンテナが止まるとタスク内の全コンテナが止まります。ログ転送のサイドカーが落ちただけで本体まで止めたくないなら、サイドカー側を"essential": falseにします。プロキシのように止まると通信できなくなるサイドカーは、逆にtrueのままにしておくのが筋です。ECSでEnvoyサイドカーを配っていたAWS App Meshは2026年9月に終了しており、移行先の比較はAWS App Meshの終了と移行先で扱っています。
サービスメッシュのサイドカープロキシとアンビエントモード
サイドカーが最も大規模に使われてきたのがサービスメッシュです。メッシュの全体像とAPIゲートウェイとの違いはサービスメッシュの仕組みと導入判断、Istioの設定はIstioのサイドカー/アンビエント方式に譲り、ここではサイドカーの観点に絞ります。
Envoyサイドカーが通信を横取りしてmTLSやリトライを差し込む経路
Istioのサイドカーモードでは、注入対象のPodにEnvoyを配置し、iptablesなどで対象のTCP通信をEnvoyへ転送します。UDP・ICMPや除外設定に該当する通信は、この転送の対象外です。アプリのコードを変えずにmTLSによる相互認証、リトライ、タイムアウトを差し込めるのはこのためです。Istioは1.27(2025年8月)でENABLE_NATIVE_SIDECARSの既定を自動判定に変えました。ただしIstioの開発者の説明によると、自動で有効になるのは全ノードがKubernetes 1.33以降のクラスタだけで、1.29〜1.32のノードが残る場合はENABLE_NATIVE_SIDECARS=trueを明示する必要があります。前章で見た「本体の後処理中にプロキシが先に消える」問題は、Envoyが実際にネイティブサイドカーとして注入されていれば、終了順序の保証で防がれます。kubectl describe podでistio-proxyがinitContainers側に表示されるかで確かめられます。
サーキットブレーカーとの違い:配置の型と障害遮断の型
サイドカーとサーキットブレーカーは、比べる軸が違います。サイドカーは「補助機能をどこに置くか」という配置の型、サーキットブレーカーは「失敗が続く呼び出し先への要求を止める」という障害遮断の型です。両者は組み合わせて使われ、Envoyのサイドカーがサーキットブレーカーを実装する、という関係になります。
Envoyのサーキットブレーカーは接続先クラスタごとに上限を持ち、既定値は同時接続・待機要求・同時要求がそれぞれ1,024、同時リトライが3です。IstioではDestinationRuleのconnectionPoolで上限を、outlierDetectionのconsecutive5xxErrorsなどで異常な接続先の除外を設定します。サイドカーを使わず、アプリのライブラリで実装する方法はcircuit breakerの実装とJava・Go・Node.jsの設定コードにあります。
株式市場の用語としての両者も別物です。韓国取引所(KRX)の取引ガイドでは、サイドカーはKOSPI200先物が基準価格から5%以上動いた状態が1分続くとプログラム売買の注文効力を5分間止める措置、サーキットブレーカーは第1段階で、指数が前日比8%以上下落した状態が1分続くと市場全体の売買を20分間止める措置です。
サイドカー1本あたりのCPU・メモリとアンビエントの数値
Istio公式の性能ページは、Istio 1.24で1KBのHTTP要求を毎秒1,000件流す条件の消費量を次のように示しています。サイドカーとwaypointは、ともにワーカースレッド2本の測定値です。
| プロキシ | 置かれる単位 | CPU | メモリ |
|---|---|---|---|
| サイドカー(Envoy) | Podごと | 約0.20 vCPU | 約60MB |
| ztunnel | ノードごと | 約0.06 vCPU | 約12MB |
| waypoint(L7が要るときだけ) | 名前空間などごと | 約0.25 vCPU | 約60MB |
1本あたりの数値より、置かれる単位の差が効きます。サイドカーはPod数だけ並び、待機中のPodでもメモリを持ち続けます。Istioは1.24(2024年11月)でサイドカーを使わないアンビエントモードを一般提供にし、L4の暗号化はノードごとのztunnel、L7の制御が要る通信だけwaypointを通す構成にしました。
サイドカーを採用する条件と見送る条件
サイドカーは条件が揃ったときだけ得をする技術です。判断の分かれ目を、言語構成・更新と権限の分離・セキュリティの順に示します。
採用が効く条件:言語の混在と横断ポリシーの一括変更
GoとJavaとPythonが混在し、同じ暗号化・認証・トレースを全サービスに入れたいなら、言語ごとにライブラリを保守するより、言語に依存しないサイドカーを1つ配るほうが重複が減ります。ポリシーを一括で更新したいなら、言語別ライブラリの保守工数と、サイドカーの常駐リソース・イメージ更新・障害対応の手間を並べて比べます。前者が大きくなる構成ほど、サイドカーが得になります。仮想マシンとコンテナが混在するなら、Envoyをサイドカーに置くConsulのサービスメッシュConnectも候補です。
見送る条件:ライブラリで足りる単一言語の構成とJob中心の基盤
サービスが数個で言語が1つの構成では、サイドカーとメッシュはたいてい過剰です。リトライやタイムアウトはライブラリで書いたほうが軽く、障害の切り分けも単純になります。Jobが中心の基盤で、旧来方式のサイドカーを使っている場合も要注意です。本記事の実測のとおりJobが終わらなくなるので、ネイティブ方式へ移すか、サイドカーをやめてノード単位のエージェントにします。言語数やサービス数だけで決めず、補助機能を本体と別に更新する必要も権限を分ける必要もなく、ライブラリや基盤の標準機能で足りるなら、サイドカーは足さずに見送ってください。
正規のPodへのサイドカー注入を悪用されない権限設計
サイドカーは本体と同じネットワークとボリュームに触れるため、攻撃者が正規のPodへサイドカーを紛れ込ませる手口があります。MicrosoftのThreat Matrix for KubernetesはこれをMS-TA9011(Sidecar Injection)として載せています。DeploymentやPodを更新できる権限を、業務上必要なサービスアカウントだけに絞ってください。加えて、アドミッションコントローラで許可したレジストリ以外のイメージを弾いておくのが基本です。新規にクラウド基盤を作る段階でこうした構成と権限を決めるなら、インフラ構築(AWS・Google Cloud・Azure)の相談で、言語構成と規模を前提に切り分けると手戻りが減ります。
よくある質問
サイドカーを日本語で何と言いますか?
もとはオートバイの横に付ける「側車」のことです。ITでは訳さずにサイドカーと呼び、本体の横に付ける補助コンテナや、その配置の型(サイドカーパターン)を指します。
サイドカープロキシとは何ですか?
サイドカーとしてPodに同居し、本体の通信のうち、プロキシを経由するよう設定された通信を中継するコンテナのことです。IstioのEnvoyが代表で、アプリのコードを変えずにmTLS、リトライ、サーキットブレーカーを差し込めます。Istio 1.27以降では、全ノードがKubernetes 1.33以降なら既定でネイティブサイドカーとして注入されます。
ネイティブサイドカーは古いKubernetesでも使えますか?
1.29以降なら既定で有効です。1.28ではSidecarContainersフィーチャーゲートを明示的に有効にする必要があり、1.27以前にはこの機能がありません。1.33で安定版になり、以降はフィーチャーゲートで無効化できなくなりました。
写真のサイドカーファイルとは何ですか?
RAW画像の横に置く、編集内容やメタデータを書いた別ファイルのことで、多くはXMP形式です。AdobeはLightroom Classicのヘルプで、RAW画像のメタデータをXMPのサイドカーファイルに保存できると説明しています。元ファイルの横に置く点が共通するだけで、コンテナのサイドカーとは別物です。
iPadのSidecarとは関係がありますか?
関係ありません。AppleのSidecarは、iPadをMacの2台目のディスプレイとして使うmacOSの機能です。本記事のサイドカーは、コンテナ基盤での補助コンテナの配置を指します。