サイドカーと重複ファイルのためのImmich Cloudエクスポート移行チェックリスト

エヴァ・ウォン

IceWhale author

エヴァ・ウォン は テクニカルライター であり ZimaSpaceの常駐ティンカーでもあります。 生涯のオタクであり、 ホームラボとオープンソースソフトウェアに情熱を持っています。彼女は複雑な技術的概念をわかりやすく、 実践的なガイドに翻訳することを専門としています。エヴァはセルフホスティングは楽しくあるべきで、怖がるものではないと信じています。彼女のチュートリアルを通じて、コミュニティが ハードウェアのセットアップを解明する手助けをしています。初めてのNAS構築からDockerコンテナの習得まで。

Immich Cloud Export Migration Checklist for Sidecars and Duplicates

Immichがサイドカー、日付、関連付け、そして実際に検証できる必要なバージョンを保持するまで、元のクラウドエクスポートには手を加えないでください。

Googleフォトなどのエクスポートには、JSONの付属ファイル、重複したアルバム参照、名前を変更された重複ファイル、編集版、同じスマートフォンの次回バックアップと重なるファイルが含まれることがあります。まずマニフェストを作成し、あらゆる衝突の種類を含む小規模なカナリアインポートを実行してください。サイドカーに不明点が残っている間は、フォルダーを平坦化したりクラウド上のコピーを削除したりしないでください。移行が完了するのは、元のハッシュ、タイムラインの日付、アルバム、そして最初のモバイルバックアップとの重複テストが一致した後です。

元のエクスポートを保持し、移行マニフェストを作成する

すべてのアーカイブを読み取り専用のステージングツリーに展開し、移行が承認されるまでダウンロードしたアーカイブを保持してください。候補となる各アセットについて、エクスポートバッチ、相対パス、ファイル名、バイトサイズ、ハッシュ、メディアタイプ、撮影情報、サイドカーのパス、アルバムディレクトリを記録します。このマニフェストは、2つのファイルの名前が同じでも内容が異なる場合のロールバック用の基準になります。

クラウドエクスポートでは、撮影時刻、説明、位置情報、アルバムとの関連付けがメディアファイルの外部に保持されることがあるため、サイドカーを考慮した移行が重要です。エクスポート対応インポーターのワークフローは、エクスポート対応インポーターを使用し、クラウド上のコピーを削除する前に移行先を検証することで、単純なファイルコピー以上の情報を保持できる理由を示しています。

アーカイブの展開に失敗した場合、想定した年が存在しない場合、サイドカー数の説明がつかない場合、またはステージングボリュームに作業用コピーの容量がない場合は中止してください。唯一のエクスポートの名前変更、平坦化、重複排除、メタデータの書き換えは行わないでください。これらの変更により、後でサイドカーを照合するために必要な証拠が失われます。

名前やフォルダーを正規化する前にサイドカーを照合する

重複ファイル、編集版、長いファイル名に追加された接尾辞など、エクスポーターの命名規則に従ってメディアとJSONをグループ化します。代表的な10件について、埋め込みの撮影時刻と、サイドカーの写真時刻、ファイルシステムの更新時刻、タイムゾーン、説明、位置情報、アルバムへの所属を比較します。各衝突の種類について、どのフィールドを正式な基準にするかを記録してください。

メタデータを統合する場合は作業用コピーを使用し、元のサイドカーをその横に保持してください。サイドカーによる撮影日の変更を防ぐためのZimaSpaceのワークフローは、日付を保持するための関連手順を示しています。このチェックリストでは、Immich全体をインポートする前に必要なマニフェストと重複チェックを追加しています。

すべてのカナリアサイドカーが、意図した1つのメディアファイルに対応するか、対応なしとして明示的に分類された場合にのみ、このステージは合格です。名前を変更されたファイルが複数のサイドカーに対応し得る場合は未解決のままにし、ファイル名だけで選択せず、エクスポーターの連番とハッシュを確認してください。

本当の重複と関連するバージョンを分ける

衝突を、バイト単位で同一のコピー、クラウドでサイズ変更されたコピー、編集版、アルバム参照、Live Photoのペア、または同じ名前を持つ実際には異なる画像に分類します。家族で文書化されたルールを決めていない限り、編集版と元のバージョンは保持してください。見た目が似ているだけでは削除の十分な根拠になりません。

クラウド履歴と再開されたスマートフォンのバックアップに関する解決済みのコミュニティ事例は、クラウド履歴と再開されたスマートフォンのバックアップによって、ハッシュが異なる重複が作成される可能性を示しています。この限定的な失敗パターンを利用して、自動アップロードを有効にする前に、Takeoutセットと各スマートフォンのカメラロールとの重複をテストしてください。

あらゆる重複の種類を含む小規模なカナリアを1つインポートします。ソースと移行先の件数、ハッシュ、日付、位置情報、アルバムへの所属、ペア動画の処理結果を比較してください。インポーターが必要なバージョンを統合したり、説明のつかない2つ目のアセットを作成したりした場合は、カナリアをロールバックしてください。後から一括削除して埋め合わせないでください。

-15% OFF

ZimaBoard 2 - あなたの大きなアイデアのためのミニホームサーバー

Single board computer zimaboard2

完全なインポートを実行し、新しい正規データソースを証明する

マニフェストで特定したバッチをインポートする間は、メタデータの書き換えとモバイルバックアップを停止します。インポートログと拒否されたファイルの一覧を保存し、アルバム参照や完全な重複が意図的に統合される場合に、1つの元の総数と別の総数が一致するとは限らないことを踏まえて、種類ごとに件数を照合してください。

インポート後は、古い年と最近の年、編集済みの写真、長い動画、Live Photo、共有アルバムの項目、サイドカー付きのアセットを抽出して確認します。選択した元ファイルをダウンロードし、ステージングしたコピーとハッシュを比較してください。ウェブとモバイルの両方のクライアントで、タイムラインの日付、検索、アルバムへの所属、位置情報を確認します。

インポートした履歴に問題がないことを確認してから、1台のスマートフォンだけでバックアップを有効にします。重複テストを繰り返し、Immichを再起動して、2つ目のコピーが作成されないことを確認してください。2回のバックアップサイクルと復元テストが成功するまで、元のエクスポートとクラウドライブラリを保持します。対応しないサイドカーや予測不能な重複処理がある場合は、マニフェストとカナリアのログを完全な状態で添えてエスカレーションしてください。