この記事で分かること
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はバックアップそのものではなく、機密データの保管や復旧用コピーは別に考える必要があります。