再デプロイ後、Composeスタックが新しい空の名前付きボリュームをアタッチするのはなぜですか?

Eva Wong は テクニカルライター であり、 生粋の技術好き としてZimaSpaceで活動しています。ホームラボやオープンソースソフトウェア をこよなく愛する生粋のギークで、複雑な技術概念をわかりやすく、実践的なガイド にまとめることを得意としています。Evaは、セルフホスティングは難しいものではなく、楽しむものだと考えています。チュートリアルを通じて、初めてのNAS構築からDockerコンテナの使いこなしまで、コミュニティがハードウェアのセットアップをわかりやすく理解できるよう 支援しています。、初めてのNAS構築からDockerコンテナの習得まで。

再デプロイ時にプロジェクトスコープのボリューム名が変わったり、元のボリュームが見つからなかったりすると、Composeスタックは新しい空の名前付きボリュームを接続することがあります。

再作成されたサービスが同じコンテナパスに新しく生成されたボリュームをマウントしていても、古いデータが別のDockerボリュームに残っている可能性があります。よくある原因として、スタック名やプロジェクト名の変更、ボリュームキーの名前変更、ボリュームを削除するコマンドによる削除、外部ボリューム宣言の欠落、別の管理ツール経由でのデプロイ、または明示的なボリューム名の解決先の変更などがあります。データの復元やアプリの初期化を行う前に、マウント中のボリュームと孤立した候補の両方を一覧にしてください。

新しいコンテナにマウントされた正確なボリュームを特定する

実行中のコンテナのマウントを調べ、ボリューム名、ドライバー、マウントポイント、ラベル、作成日時、コンテナ内のマウント先、読み書きモードを記録してください。再デプロイ前の記録と比較してください。

Ubuntuのdocker volume inspectコマンドではボリュームの識別情報を確認できるため、新しい空のボリュームと、名前が似た古い未マウントボリュームを区別できます。

元のボリュームが見つかるまでは、新しいボリュームにデータをコピーしないでください。アプリを起動すると新しいデータベースが作成され、保存先が意図どおり初期化されたように見えることがあります。

Composeのプロジェクト名が変わったか確認する

以前と現在のプロジェクト名、スタック名、Composeディレクトリ、-pオプション、COMPOSE_PROJECT_NAME、トップレベルのname:、デプロイ管理ツールを比較してください。

Dockerの説明によると、Composeは通常、明示的な名前または外部ボリュームの検索が設定されていない限り、ボリューム名をプロジェクト名とボリュームキーの組み合わせにします。

同じComposeファイルを別のディレクトリに移動すると、サービス名とボリュームキーが変わっていなくても、別のプロジェクトとボリュームが作成されることがあります。

安定した名前と外部ボリュームの設定を確認する

再デプロイの前後で、トップレベルのボリューム定義を比較します。name:、external:、ドライバーオプション、補間変数、想定しているボリュームの有無を確認してください。

MicrosoftのDocker Composeチュートリアルによると、名前付きボリュームはコンテナーの置き換え後も独立して保持されます。そのため、新しい空の状態になっている場合は、通常、別のボリューム識別子がアタッチされたか、古いボリュームが削除されています。

ライフサイクルをスタックの外部で意図的に管理する場合に限り、ボリュームを外部として指定してください。外部ボリュームが見つからない場合、Composeが代わりのボリュームを黙って作成せず、明確なエラーを出すようにします。

クリーンアップによって元のボリュームが削除されたか確認する

デプロイログ、スクリプト、UI操作、プルーニングジョブ、ボリューム削除コマンドを確認します。ボリュームの作成日時と再デプロイのタイミングを比較してください。

Red Hatのドキュメントによると、コンテナー管理の名前付きボリュームは、コンテナーの書き込み可能レイヤーとは別の場所に保存されます。そのため、コンテナーの削除と名前付きボリュームの削除は、ライフサイクル上の異なるイベントです。

元のボリュームが見つからない場合は、自動起動を停止し、検証済みのバックアップからのみ復元してください。空の置き換えボリュームに、削除されたレイヤーが復元可能な状態で残っていると思い込まないでください。

スタック管理ツールの識別情報とデプロイ方法を比較する

スタックがCLI、Portainer、NASアプリストア、Gitデプロイ、または別の自動化ツールのどれを使って起動されたかを記録してください。その管理ツールに保存されているスタック名と環境変数の値を比較します。

Portainerではデプロイ時にスタック名を指定する必要があり、管理ツールが制御するこの識別子は、手動のComposeコマンドで使われるディレクトリ名ベースのプロジェクト名と異なる場合があります。

そのため、手動で緊急起動すると、別のプロジェクトプレフィックスのリソースが作成されることがあります。デプロイの管理主体を1つに決め、作成される解決済みボリューム名を記録してください。

新しいボリュームマウントの下に隠れたデータを除外する

名前付きボリュームを接続せずにコンテナを停止し、使い捨てのテスト環境でイメージまたはバインドパスを調べます。ボリュームのマウント前に、起動時のデータがコンテナレイヤーに書き込まれていたかどうかを確認してください。

Linuxのmountマニュアルでは、マウントによってディレクトリ内の既存の内容が隠れると説明されています。そのため、新しい空のボリュームが、イメージ内または書き込み可能レイヤーに作成されたファイルを覆うと、データがなくなったように見えることがあります。

隠れているレイヤーと古い永続ボリュームを、むやみに統合しないでください。どちらの状態が正しいかを特定し、アプリケーションがサポートする復旧方法を使用してください。

制御されたテストで元のボリュームを再接続する

スタックを停止し、候補となる両方のボリュームをバックアップしてから、元のボリュームを使い捨てコンテナまたは一時サービスのパスに接続し、アプリケーションファイル、データベースの識別情報、所有権、タイムスタンプを確認します。

ZimaSpaceのマウントを壊さずにコンテナデータを移動するガイドでは、関連するパスのマッピング手順を解説しています。この記事では、プロジェクト単位の名前付きボリュームの識別に焦点を当てます。

目的の古いボリュームが、明示的に指定した安定した名前または外部名でマウントされ、再デプロイを繰り返しても別の空の候補が作成されず再利用される状態になれば、問題は解決です。

よくある質問

名前付きボリュームが空の場合、古いデータは削除されたということですか?

必ずしもそうではありません。古いボリュームが別のプロジェクトプレフィックスまたは明示的な名前で残っている一方、新しいコンテナが別の空のボリュームを使っている可能性があります。

Composeフォルダー名を変更すると、新しいボリュームが作成されますか?

はい。プロジェクト名が固定されていない場合、Composeはプロジェクトディレクトリから名前を決定し、異なるプレフィックスが付いたリソースを作成することがあります。

重要なボリュームは外部としてマークすべきですか?

外部ボリュームを使うとスタックの削除時にライフサイクルを管理できなくなりますが、事前の作成、命名、バックアップ、デプロイ時の確認が必要です。

サポートとヒント

続きを読む

Get More Builds Like This

Stay in the Loop

Get updates from Zima - new products, exclusive deals, and real builds from the community.

Stay in the Loop preferences

We respect your inbox. Unsubscribe anytime.