「Borgmatic」の版間の差分

提供: ArchWiki
ナビゲーションに移動 検索に移動
(英語版から転載)
 
(→‎設定: 同期)
 
(同じ利用者による、間の4版が非表示)
2行目: 2行目:
 
[[Category:バックアップ]]
 
[[Category:バックアップ]]
 
[[en:Borgmatic]]
 
[[en:Borgmatic]]
[https://torsion.org/borgmatic/borgmatic] は [[Borg backup]] 用の Python ベースのラッパースクリプトで、バックアップを簡素化および自動化するように設計されています。これは、'''borgbackup''' を使用してバックアップを作成するための使いやすく柔軟なソリューションを提供することを目的としています。
+
[https://torsion.org/borgmatic/ borgmatic] は [[Borg backup]] 用の Python ベースのラッパースクリプトで、バックアップを簡素化および自動化するように設計されています。これは、'''borgbackup''' を使用してバックアップを作成するための使いやすく柔軟なソリューションを提供することを目的としています。
   
 
== インストール ==
 
== インストール ==
9行目: 9行目:
   
 
== 設定 ==
 
== 設定 ==
  +
  +
デフォルトでは、設定ファイルはインストールされません。作成するには、コマンド {{ic|borgmatic config generated}} を使用して生成できます:
  +
  +
{{hc|# borgmatic config generate|
  +
Generating a configuration file at: /etc/borgmatic/config.yaml
  +
  +
This includes all available configuration options with example values, the few
  +
required options as indicated. Please edit the file to suit your needs.
  +
  +
If you ever need help: https://torsion.org/borgmatic/#issues
  +
  +
summary:
  +
Generate successful
  +
}}
   
 
'''borgmatic''' の設定ファイルは、次のいずれかにあります。
 
'''borgmatic''' の設定ファイルは、次のいずれかにあります。
17行目: 31行目:
 
設定ファイルを使用すると、バックアップリポジトリ、バックアップソース、保持ポリシー、およびその他のパラメータを定義できます。
 
設定ファイルを使用すると、バックアップリポジトリ、バックアップソース、保持ポリシー、およびその他のパラメータを定義できます。
   
== 使用法 ==
+
== 使用法 ==
   
  +
'''borgmatic''' を好みに合わせて設定したら、次のコマンドを使用して実行できます。
Once you have configured '''borgmatic''' to your liking, you can run it using the following command:
 
   
 
# borgmatic --verbosity 2
 
# borgmatic --verbosity 2
   
  +
これにより、設定ファイルで指定された設定を使用してバックアッププロセスが開始されます。'''borgmatic''' には、バックアップ動作をカスタマイズするために使用できるさまざまなオプションとフラグが用意されています。
This will start the backup process using the settings specified in your configuration file. '''borgmatic''' provides various options and flags that you can use to customize your backup behavior.
 
   
  +
Borgmatic は、systemd システムとユーザーのユニットとタイマーも提供します。
Borgmatic also provides systemd system and user units and timers.
 
   
  +
== ヒントとテクニック ==
== Tips and tricks ==
 
   
=== Using systemd-creds to provide a password for borgmatic.service ===
+
=== systemd-creds を使用して borgmatic.service のパスワードを提供する ===
   
  +
まずパスワードを暗号化します
First, encrypt the password
 
   
 
{{hc|1=# systemd-ask-password -n {{!}} systemd-creds encrypt --name=borgpw -p - - |2=
 
{{hc|1=# systemd-ask-password -n {{!}} systemd-creds encrypt --name=borgpw -p - - |2=
46行目: 60行目:
 
}}
 
}}
   
  +
次に、提供された borgmatic systemd サービスを [[編集]] します。
Then, [[edit]] the provided borgmatic systemd service:
 
   
{{Note|Since [[systemd-creds]] provides credentials as files, you have to use {{ic|BORG_PASSCOMMAND}} to provide the password}}
+
{{Note|[[systemd-creds]] は認証情報をファイルとして提供するため、{{ic|BORG_PASSCOMMAND}} を使用してパスワードを提供する必要があります}}
   
 
{{hc|1=/etc/systemd/system/borgmatic.d/drop_in_name.conf|2=
 
{{hc|1=/etc/systemd/system/borgmatic.d/drop_in_name.conf|2=

2024年4月12日 (金) 23:34時点における最新版

borgmaticBorg backup 用の Python ベースのラッパースクリプトで、バックアップを簡素化および自動化するように設計されています。これは、borgbackup を使用してバックアップを作成するための使いやすく柔軟なソリューションを提供することを目的としています。

インストール

borgmatic パッケージを インストール します。

設定

デフォルトでは、設定ファイルはインストールされません。作成するには、コマンド borgmatic config generated を使用して生成できます:

# borgmatic config generate
Generating a configuration file at: /etc/borgmatic/config.yaml
 
This includes all available configuration options with example values, the few
required options as indicated. Please edit the file to suit your needs. 
 
If you ever need help: https://torsion.org/borgmatic/#issues
 
summary:
Generate successful

borgmatic の設定ファイルは、次のいずれかにあります。

  • /etc/borgmatic/config.yaml (または /etc/borgmatic.d のドロップイン)
  • ~/.config/borgmatic/config.yaml (または ~/.config/borgmatic.d のドロップイン)

設定ファイルを使用すると、バックアップリポジトリ、バックアップソース、保持ポリシー、およびその他のパラメータを定義できます。

使用方法

borgmatic を好みに合わせて設定したら、次のコマンドを使用して実行できます。

# borgmatic --verbosity 2

これにより、設定ファイルで指定された設定を使用してバックアッププロセスが開始されます。borgmatic には、バックアップ動作をカスタマイズするために使用できるさまざまなオプションとフラグが用意されています。

Borgmatic は、systemd システムとユーザーのユニットとタイマーも提供します。

ヒントとテクニック

systemd-creds を使用して borgmatic.service のパスワードを提供する

まずパスワードを暗号化します

# systemd-ask-password -n | systemd-creds encrypt --name=borgpw -p - -
🔐 Password: *******                 
SetCredentialEncrypted=borgpw: \
        k6iUCUh0RJCQyvL8k8q1UyAAAAABAAAADAAAABAAAABODbSDtNZ8+PtlN3IAAAAAgAAAA \
        AAAAAALACMA8AAAACAAAAAAngAgRKW32QRYMvWeTcwb4SbbvK/QDF4tihGlL8OHlLKa86 \
        AAEHwr8IDsdxBmuRIXWSBGoFu8la+lTclW0/GN3OZwbvfeymJhqSoa3+76kJ1aRumQVul \
        Wvc9KxykzPhVoqFN3adVujhUkfeUmD/IMwzscsOh0hsOd8d1r2v3K8WyVv9ebk0hS1mVC \
        UzSTCNMsuKrPF2wXUP2QK5+WIjL1AE4ACAALAAAAEgAgY9RHOefBR+mMgV/Frr+UzQX1S \
        IsLFItIbfB6Ep76It0AEAAgNyMB30ZJ2HiqikmhgZfvFRZqxNRhXluH/cxMiohBDKRj1E \
        c558FH6YyBX8Wuv5TNBfVIiwsUi0ht8HoSnvoi3QAAAADffR0SV5WlPlCnJtJrhVnIXp3 \
        IO36xjF4iBmXjBfjaWhpFJ6yyY0HzHF9O1J7eNgls5aJX6Skh

次に、提供された borgmatic systemd サービスを 編集 します。

ノート: systemd-creds は認証情報をファイルとして提供するため、BORG_PASSCOMMAND を使用してパスワードを提供する必要があります
/etc/systemd/system/borgmatic.d/drop_in_name.conf
[Service]
SetCredentialEncrypted=borgpw: \
        k6iUCUh0RJCQyvL8k8q1UyAAAAABAAAADAAAABAAAABODbSDtNZ8+PtlN3IAAAAAgAAAA \
        AAAAAALACMA8AAAACAAAAAAngAgRKW32QRYMvWeTcwb4SbbvK/QDF4tihGlL8OHlLKa86 \
        AAEHwr8IDsdxBmuRIXWSBGoFu8la+lTclW0/GN3OZwbvfeymJhqSoa3+76kJ1aRumQVul \
        Wvc9KxykzPhVoqFN3adVujhUkfeUmD/IMwzscsOh0hsOd8d1r2v3K8WyVv9ebk0hS1mVC \
        UzSTCNMsuKrPF2wXUP2QK5+WIjL1AE4ACAALAAAAEgAgY9RHOefBR+mMgV/Frr+UzQX1S \
        IsLFItIbfB6Ep76It0AEAAgNyMB30ZJ2HiqikmhgZfvFRZqxNRhXluH/cxMiohBDKRj1E \
        c558FH6YyBX8Wuv5TNBfVIiwsUi0ht8HoSnvoi3QAAAADffR0SV5WlPlCnJtJrhVnIXp3 \
        IO36xjF4iBmXjBfjaWhpFJ6yyY0HzHF9O1J7eNgls5aJX6Skh
Environment=BORG_PASSCOMMAND="cat %d/borgpw"