この記事で分かること

Dockerで小さなサービスを運用する方へ。このサイトのAPI保存結果と取得予算を例に、コードの配布と状態の保存を分ける方法を整理します。

  • image・コンテナ・volumeの役割と、データの置き場所。
  • 非rootアプリが保存できる所有権と権限。
  • 単なる再起動と、別コンテナからの復元を分けた確認。

Pythonの導入と、保存状態の維持は別だった

このサイトではPythonとOpenVulnQueryをDocker imageへ組み込み、Node.jsから非公開のPythonクライアントを起動しています。同じimageから作り直せば、その実行環境を再現できます。

一方、APIを使ってから保存する照会結果と取得予算は、ビルド時のファイルではありません。アプリを更新したときにも維持する必要があるため、公開HTMLのあるimageとは別に、named volumeを用意しました。

内容このサイトの配置変更時の扱い
HTML・JS・Python・依存関係固定imageの中検証したimageとして置き換える
Cisco認証設定公開領域外の環境設定値を公開せず、新コンテナへ必要な設定を渡す
保存結果と全体取得予算非公開volume → /var/lib/openvuln同じvolumeを新しいアプリへ引き継ぐ

volumeはコンテナがなくなっても状態を保持できる保存先です。named volumeとanonymous volumeの扱いはDocker公式のvolumeの説明 ↗を確認できます。保持できることと、バックアップがあることは別です。

同じ保存先を、明示してマウントする

コンテナ内で見えるディレクトリ名が同じでも、マウントしたvolumeが違えば別の状態です。名前とマウント先を記録します。このサイトの対象は/var/lib/openvulnだけで、公開ページの出力先はマウントしません。

--mount type=volume,source=your-private-state,target=/var/lib/openvuln
--env OPENVULN_DATA_DIR=/var/lib/openvuln
--read-only

上は構成の一部分です。既存コンテナへ追加するだけの手順ではありません。--read-onlyでルートの書き込みを止めたうえで、状態を置くvolumeだけを読み書き可能にします。volumeが空のときにどう初期化されるかも、image内のディレクトリと合わせて確認します。

確認には必要な項目だけを出します。認証情報も含む可能性があるため、docker inspectの全文を記事やログへ転載しません。

docker inspect your-app --format '{{range .Mounts}}{{println .Type .Name .Destination .RW}}{{end}}'
docker inspect your-app --format '{{.Config.User}} {{.HostConfig.ReadonlyRootfs}}'
docker volume inspect your-private-state --format '{{.Name}}'

your-appとyour-private-stateは自分の対象名へ置き換えます。アプリが使っているvolume名、対象ディレクトリ、RWが意図どおりかを確かめます。

非rootで動かすと、書き込み権限の確認が必要になる

imageが起動しても、保存先へ書けない場合があります。このサイトはnodeユーザーのUID 1000で動き、保存ディレクトリは同じ所有者の0700、保存ファイルは0600にしました。アプリのUIDと、volume上の所有者が合う必要があります。

見るもの確認点
実行ユーザーアプリをrootへ変える前に、現在のUIDを確認
ディレクトリ所有者、書き込み権限、期待したマウント先か
ファイル別ユーザーが作った既存ファイル、破損、symlinkの有無
実行条件read-onlyがvolumeにも掛かっていないか、残容量はあるか

すべてを777へ変更すると、原因が分からなくなり、必要以上に読める範囲が増えます。どのユーザーがどのディレクトリへ書くかを決めてから合わせます。Windows上のフォルダはPOSIXの数値だけでは権限を表せないため、ACLも別に確認します。

小さな状態を、別プロセスから読み直す

まずDockerを使う前に、保存したJSONを別プロセスから読めるかを試します。Node.js 24系を使い、persist-demo.mjsを新しい作業フォルダへ保存してください。

node persist-demo.mjs populate demo-state
node persist-demo.mjs reuse demo-state

最初の行が一つの架空レコードを保存し、次の行が同じ状態を読みます。両方のcheckedAtが一致し、attemptsは1のままです。二つのコマンドは順番に実行してください。同時に初期化する処理の排他制御は含みません。既存の状態は上書きしません。初回をやり直すなら、新しい専用フォルダ名を使います。

Dockerで試すための構成例

Docker Engineを使えるローカルの検証環境では、同梱Dockerfileを使って次の二つのコンテナへ同じ専用volumeを渡せます。既存の本番volumeは使わず、新しい検証専用名を選びます。

docker build -t article-volume-demo:local .
docker volume create article-volume-demo-state
docker run --rm --network none --read-only --cap-drop ALL --mount type=volume,source=article-volume-demo-state,target=/data article-volume-demo:local node persist-demo.mjs populate
docker run --rm --network none --read-only --cap-drop ALL --mount type=volume,source=article-volume-demo-state,target=/data article-volume-demo:local node persist-demo.mjs reuse

サンプルの入力は架空データだけで、外部APIへ接続しません。--rmでコンテナを終了時に除いても、名前付きvolumeは次のコンテナへ渡す対象として残ります。片付けるときも、検証専用volumeの名前と、使っているコンテナがないことを確かめてから行います。

復元できたことを、値で確認する

このサイトの実装では、Linuxの独立した検証volumeを使い、一つ目のコンテナで架空結果と予算を保存し、二つ目のコンテナで復元しました。二つ目では取得処理を呼ばず、元の日時と予算1回を維持したことを確認しています。

その後、本番候補でも実ASA結果を保存し、計画した再起動後に同じ結果と元の取得日時を確認しました。コンテナの再起動だけでは同じ書き込み領域を読むため、別コンテナでの検証も行った点が確認の範囲です。

項目期待する結果
取得日時保存前と復元後で同じ
保存条件種類・版・機種が同じ
取得回数保存結果を読むだけなら増えない
所有権UID1000、ディレクトリ0700、ファイル0600

二つの有効なアプリを同じvolumeへつなぐことは、データを安全に共有する設計とは別です。本番は一つのwriterに制限しています。複数インスタンスへ増やすなら、保存と予約を共有する仕組みも設計し直します。

出典と確認範囲

2026年10月4日に、このサイトのLinuxコンテナで別コンテナからの状態復元、所有権・権限、本番候補の再起動後の復元を確認しました。配布用Node.js例は別プロセスでの保存・読み込みを確認しています。配布用Dockerfileによる新しいimageのビルドと実行は、この記事作成環境では未確認です。

volumeの寿命と初期化はDocker公式資料 ↗、imageの読み取り専用設定はdocker runの公式リファレンス ↗を参照します。volumeはバックアップそのものではなく、機密データの保管や復旧用コピーは別に考える必要があります。