Etckeeper

Etckeeper は /etc をバージョン管理します。

インストール

Etckeeper は公式リポジトリの etckeeper パッケージでインストールできます。

設定

メインの設定ファイルは /etc/etckeeper/etckeeper.conf です。このファイルで使用する VCS などの設定ができます。

お好きな VCS (デフォルトは git) を設定したら、次を実行することで /etc リポジトリを初期化できます:

# etckeeper init

使用方法

Etckeeper は etckeeper.conf で LOWLEVEL_PACKAGE_MANAGER として pacman の使用をサポートしています。pacman にはフック機能が存在しないため HIGHLEVEL_PACKAGER_MANAGER として pacman を使うことは不可能です。そのため、手動で変更をコミットするか、以下のどれかの方法を使用する必要があります。

Pacman フック

pacman 5.0.0 から、pacman にはフックのサポートが追加されています [1]。トランザクションの前後に etckeeper を自動的に実行するには、以下の2つのフックファイルを作成してください。まずは hooks ディレクトリを作成する必要があります:

# mkdir -p /etc/pacman.d/hooks

/etc/pacman.d/hooks/etckeeper-pre.hook

[Trigger]
Operation = Install
Operation = Upgrade
Operation = Remove
Type = Package
Target = *

[Action]
Description = Etckeeper Pre-install
Depends = etckeeper
When = PreTransaction
Exec = /usr/bin/etckeeper pre-install

/etc/pacman.d/hooks/etckeeper-post.hook

[Trigger]
Operation = Install
Operation = Upgrade
Operation = Remove
Type = Package
Target = *

[Action]
Description = Etckeeper Post-install
Depends = etckeeper
When = PostTransaction
Exec = /usr/bin/etckeeper post-install

pacman のフックに関する詳細は man alpm-hooks を参照。

systemd

パッケージにはサービスとタイマーユニットが含まれています。etckeeper.timer を有効化してください。

タイマーの詳細は systemd/タイマーを、付属のユニットを編集する場合は systemd#ユニットファイルの編集を見て下さい。

Cron

配布されているソースの debian/cron.daily に cron スクリプトが存在します。このスクリプトを使用することで定期的に変更を自動コミットすることができます。毎日スクリプトを実行するには、cron をインストール・有効化してから、etckeeper をビルドした srcdir からスクリプトを /etc/cron.daily にコピーして実行可能属性を付与してください (例: chmod +x /path/to/script)。

ラッパースクリプト

以下のようなスクリプトを PATH が通っているどこかに配置して、実行可能属性を付与し、pacman -Syu の代わりにスクリプトを実行することで、etckeeper が他のシステムで使っているような自動コミット機能をエミュレートすることができます。

#!/bin/bash

etckeeper pre-install
pacman -Syu
etckeeper post-install

もしくは ~/.bashrc に簡単なエイリアスを追加してください:

alias pkg-update='sudo etckeeper pre-install && sudo pacman -Syu && sudo etckeeper post-install'

あるいは関数を使うことで pacman や pacman のラッパーに引数を指定することもできます:

Pacman () { sudo etckeeper pre-install && sudo pacman  "$@" && sudo etckeeper post-install; }

関数を使うときは、通常通りに pacman にフラグを付けて実行しますが、大文字の "P" を使うようにします。例:

Pacman -Syu
Pacman -R foo

警告: Do not name your wrapper script "pacman" and rely on it appearing earlier in the PATH than /usr/bin/pacman. One of the etckeeper pre-install hooks calls pacman without specifying its path, so your script will be invoked recursively without end.

Incron

上記のスクリプトの代わりに、/etc のファイルに変更が加えられたときに etckeeper を使って自動的に変更をコミットするように incron を設定することもできます。

リモートリポジトリに自動的にプッシュ

警告: etckeeper のリポジトリを誰でもアクセスできるリモートリポジトリにプッシュすることで、パスワードハッシュや秘密鍵などの機密情報が漏洩する可能性があります。気をつけて使って下さい。

/etc/.git のローカルバックアップを作ることを第一歩として、etckeeper ではさらにコミットするたびに Github などのリモートリポジトリに変更を自動的にプッシュすることができます。実行可能ファイル /etc/etckeeper/commit.d/40github-push を作成:

#!/bin/sh
set -e

if [ "$VCS" = git ] && [ -d .git ]; then
  cd /etc/
  git push origin master
fi

etc/.git に移動してリモートの Github リポジトリを追加:

# git remote add origin https://github.com/user/repo.git

これで上記のラッパースクリプトやエイリアスを実行するたびに、自動的に Github リポジトリに変更がコミットされるようになります。