Harbor ドキュメント
Shopifyストアフロント、Gitリポジトリ、フォルダ、iCloud Drive、Harbor設定の自動バックアップ。
Harborは、月額サブスクリプションなしで、スケジュールされたバックアップとリカバリパッケージを作成するmacOSメニューバーのネイティブアプリです。 このページでは、Harborが何をバックアップするのか、Shopify、Git、Harbor Configのリストアの仕組み、アクティビティと保持されたバックアップの使用方法、スケジュールされたバックアップから何を期待できるかについて説明します。
Harborがバックアップするもの
Harborは5つのソースタイプをサポートし、ローカルフォルダ、マウントされたボリューム、外付けドライブ、ネットワーク共有など、選択した宛先にバックアップを保存します。
- フルミラーリングされたGitバックアップデータを含むGitリポジトリ
- zipまたはコピーされたフォルダバックアップとしてのローカルフォルダ
- iCloud Driveフォルダ
- Harbor自体の設定と動作設定のスナップショットであるHarbor Config
- 商品、コレクション、ページ、ブログ、ナビゲーション、リダイレクト、テーマを含むShopifyストアフロントデータ
HarborはバックアップをHarborクラウドアカウント内ではなく、ご自身のドライブと宛先に保存します。
Shopifyリカバリ
HarborのShopifyリカバリフローはストアフロントに特化しています。アクティブなライブストアフロントを盲目的に上書きするのではなく、まずクリーンなリカバリストアに再構築するように設計されています。
- 商品とバリアントを復元します
- ページ、ブログ、保存されたブログ記事、コレクション、ナビゲーションメニュー、リダイレクトを復元します
- キャプチャされたテーマバンドルをテーマライブラリに未公開のテーマとしてインポートします
- ターゲットストアにすでにストアフロントコンテンツがある場合、ガイド付きリストアをブロックします
- 「テーマのみ」を選択した場合、同じストアのテーマのみのリストアを許可します
Harborは現在の有効なテーマを自動的に置き換えません。
Harborが意図的に除外するもの
新しいShopifyリカバリパッケージは、保護された顧客データやライブ運用状態ではなく、ストアフロントのリカバリに重点を置いています。
- 新しいストアフロントリカバリパッケージには顧客は含まれません
- 新しいストアフロントリカバリパッケージには注文は含まれません
- 新しいストアフロントリカバリパッケージには在庫数量は含まれません
これにより、Harborは顧客データアーカイブ製品ではなく、動作するストアフロントの復元に重点を置いています。
Gitバックアップとリストア
HarborはフルミラーリングされたGitバックアップを作成し、「作業コピーを作成」を使用すると、通常の作業コピーとしてリストアします。
- リポジトリの参照とGit履歴をバックアップします
- バックアップから使用可能な作業コードフォルダを復元します
- 明示的に「置換」を選択しない限り、既存のコードをサイレントに上書きすることはありません
- トークンを使用したプライベートHTTPSリポジトリと、そのMacで既に動作しているSSHリポジトリをサポートします
- Macに
git-lfsがインストールされている場合、Git LFSオブジェクトをフェッチできます
Gitリストアはコミットされたリポジトリコンテンツを復元します。.env.local、node_modules、ビルド出力フォルダなどの無視されたファイルやローカル専用ファイルは、コミットされていない限りGitバックアップの一部ではありません。
Harbor Configバックアップとインポート
Harbor Configにより、Harborはスケジュールに基づいて自身のセットアップをポータブルなJSONスナップショットとしてバックアップできます。
- ソース、スケジュール、保持ルール、宛先マッピング、Harborの動作設定が含まれます
- 動作設定には、「ログイン時に起動」、「実行中にスリープを防止」、Harborの通知トグルが含まれます
- 最初にJSONファイルとして復元し、次にダッシュボード > 一般からインポートします
- Git、Shopify、ローカルフォルダ、iCloud Driveと同じようにスケジュールされたソースとして機能します
- 通常のデータバックアップと共にHarbor自体のポータブルバックアップを提供します
秘密トークン、認証情報、宛先ブックマークは、Harbor Configバックアップから意図的に除外されています。
スケジューリングと通知
Harborは、メニューバーから無人で実行され、再起動後やバックアップ期間を逃した場合でも動作し続けるように設計されています。
- ソースごとのスケジュール
- ログイン時の起動をサポート
- バックアップ期間を逃した場合のキャッチアップ実行
- 保持クリーンアップ
- バックアップの成功、失敗、宛先の問題、失敗の概要に関するmacOS通知コントロール
- クライアント認証情報が保存されている場合、スケジュールされたバックアップのShopifyトークン自動更新
HarborはプライベートGitおよびShopifyアクセストークンをmacOSキーチェーンに保存します。Harborは、最新のShopifyトークンの更新結果をソース設定UIに直接表示することもできます。また、各MacでmacOSによって通知許可が付与される必要があります。
アクティビティ、保持されたバックアップ、および復元
アクティビティは、バックアップ結果の確認、保持されたバックアップソースの切り替え、保存されたアーティファクトの検証、および復元の開始を一箇所で行うことができます。
- 成功、失敗、スキップ、実行中、中断されたバックアップ試行を表示します
- ソースのスケジュールや保持ポリシーを変更せずに、保持されたバックアップをソースでフィルタリングします
- ソース、ステータス、検証の詳細、または
6月11日、6/11、2026-06-11などの日付で検索します - 保存されたアーティファクトを検証し、選択したフォルダに復元したり、一時フォルダに復元したり、Finderで表示したりできます
- 宛先およびネットワーク共有のチェックをバックグラウンドで実行するため、低速または切断されたNASがインターフェースをブロックすることはありません
バックアップ中にHarborまたはMacが終了した場合、Harborはアプリが次回起動したときに、中断されたアクティビティエントリに中断済みとマークします。その後の成功したバックアップには影響しません。
トラブルシューティング
Harborが期待どおりに動作しない場合は、ソースの種類、宛先接続、およびアクティビティまたは履歴の最後のバックアップ結果から始めてください。
- Shopifyの復元がブロックされている場合は、テーマのみの復元を行う場合を除き、クリーンなリカバリストアに復元していることを確認してください。
- スケジュールされたShopifyバックアップが失敗した場合は、Shopifyソースで保存されているクライアントID、クライアントシークレット、および最後のトークン更新ステータスを再確認してください。
- Gitの復元が不完全に表示される場合は、Gitバックアップはコミットされたリポジトリコンテンツを復元するものであり、
.env.local、node_modules、ビルド出力フォルダなどの無視されたファイルやローカル専用ファイルではないことを忘れないでください。 - Harbor Configのインポートでソースリストは復元されるが、プライベートGitまたはShopifyアカウントへのアクセスができない場合は、Harborはシークレットをエクスポートしないため、インポート後にそれらの認証情報を再入力してください。
- 宛先が利用不可と表示される場合は、ドライブ、マウントされたボリューム、またはネットワークパスを再接続し、バックアップを再度実行してください。Harborは低速または切断された宛先をバックグラウンドでチェックしますが、Harborがバックアップを保存できる前に宛先が到達可能である必要があります。
- アクティビティエントリに中断と表示されている場合、HarborまたはMacは、そのバックアップが結果の記録を完了する前に停止しました。宛先接続を確認し、ソースを再度実行してください。その後の成功したバックアップは繰り返す必要はありません。
- 通知が表示されない場合は、HarborにmacOS通知許可があり、関連する通知トグルがダッシュボード > 一般で有効になっていることを確認してください。
サポートと法律
Harborは、選択した宛先にバックアップを保存し、macOSキーチェーンをサポートされている認証情報に使用します。 ドキュメント、プライバシー、ライセンス、ソフトウェアの利用規約については、以下のリンクを使用してください。