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復元フローはストアフロントに焦点を当てています。これは、アクティブなライブストアフロントを盲目的に上書きするのではなく、まずクリーンなリカバリストアに再構築するように設計されています。
- 商品とバリエーションを復元します
- ページ、ブログ、保存されたブログ記事、コレクション、ナビゲーションメニュー、リダイレクトを復元します
- 取得したテーマバンドルをテーマライブラリの未公開テーマとしてインポートします
- ターゲットストアにすでにストアフロントコンテンツがある場合、ガイド付き復元をブロックします
- Themesのみが選択されている場合、同じストアでのテーマのみの復元を許可します
Harborは現在の有効なテーマを自動的に置き換えません。
Harborが意図的に除外するもの
新しいShopifyリカバリパッケージは、保護された顧客データやライブの運用状態ではなく、ストアフロントの復元に焦点を当てています。
- 新しいストアフロントリカバリパッケージには顧客は含まれません
- 新しいストアフロントリカバリパッケージには注文は含まれません
- 新しいストアフロントリカバリパッケージには在庫数量は含まれません
これにより、Harborは顧客データアーカイブ製品にすることなく、機能するストアフロントの復元に焦点を当てることができます。
Gitのバックアップと復元
Harborは完全にミラーリングされたGitバックアップを作成し、[作業コピーを作成]を使用すると通常の作業コピーとして復元します。
- リポジトリ参照とGit履歴をバックアップします
- バックアップから使用可能な作業コードフォルダを復元します
- 明示的に「置き換え」を選択しない限り、既存のコードをサイレントに上書きすることはありません
- トークン付きのプライベートHTTPSリポジトリと、そのMacで既に動作するSSHリポジトリをサポートします
- Macに
git-lfsがインストールされている場合、Git LFSオブジェクトを取得できます
Gitの復元はコミットされたリポジトリコンテンツを元に戻します。.env.local、node_modules、ビルド出力フォルダなどの無視されたファイルやローカルのみのファイルは、コミットしない限りGitバックアップの一部ではありません。
Harbor設定のバックアップとインポート
Harbor Configを使用すると、Harborは独自のセットアップをポータブルJSONスナップショットとしてスケジュールに基づいてバックアップできます。
- ソース、スケジュール、保持ルール、宛先マッピング、Harborの動作設定が含まれます
- 動作設定には、ログイン時に起動、実行中のスリープ防止、Harborの通知トグルが含まれます
- 最初にJSONファイルとして復元し、次にダッシュボード > 全般からインポートします
- Git、Shopify、ローカルフォルダ、iCloud Driveと同じようにスケジュールされたソースとして機能します
- 通常のデータバックアップと並行して、Harbor自体のポータブルバックアップを提供します
秘密トークン、資格情報、宛先ブックマークは、Harbor Configバックアップから意図的に除外されます。
スケジューリングと通知
Harborはメニューバーから無人で実行され、再起動後やバックアップのスキップ後も動作し続けるように設計されています。
- ソースごとのスケジュール
- ログイン時の起動サポート
- バックアップのスキップ後に追いつき実行
- 保持期間のクリーンアップ
- バックアップの成功、失敗、宛先の問題、失敗の概要に関するmacOS通知制御
- クライアント資格情報が保存されている場合の、スケジュールされたバックアップのためのShopifyトークン自動更新
Harborは最後のShopifyトークン更新結果をソース設定UIに直接表示できますが、通知の許可は各MacでmacOSによって引き続き付与される必要があります。
トラブルシューティング
Harborが期待どおりに動作しない場合は、まずソースタイプ、宛先接続、およびアクティビティまたは履歴の最後のバックアップ結果から確認してください。
- Shopifyの復元がブロックされている場合は、テーマのみの復元でない限り、クリーンなリカバリストアに復元していることを確認してください。
- スケジュールされたShopifyバックアップが失敗した場合は、保存されたクライアントID、クライアントシークレット、およびShopifyソースの最後のトークン更新ステータスを再確認してください。
- Gitの復元が不完全に表示される場合、Gitバックアップはコミットされたリポジトリコンテンツを復元し、
.env.local、node_modules、ビルド出力フォルダなどの無視されたファイルやローカルのみのファイルは復元しないことに注意してください。 - Harbor Configのインポートでソースリストが復元されても、プライベートGitまたはShopifyアカウントへのアクセスが復元されない場合は、Harborはシークレットをエクスポートしないため、インポート後にそれらの資格情報を再入力してください。
- 宛先が利用不可と表示される場合は、ドライブ、マウントされたボリューム、またはネットワークパスを再接続し、バックアップを再度実行してください。
- 通知が表示されない場合は、HarborにmacOSの通知許可があること、およびダッシュボード > 全般で関連する通知トグルが有効になっていることを確認してください。