BOX起動

前回の記事で作成したBOXを起動し、BOXに接続します。

$ cd /tmp/unix
$ vagrant up
$ vagrant ssh

Subversionのインストール

CVSと同様に、多くのLinuxディストリビューションではSubversionがインストールされていませんので、パッケージ管理コマンドを使用してインストールします。

$ sudo yum -y install subversion

SSHサーバーの設定変更

リモートからSubversionのリポジトリを操作する際に、SSH接続を利用しますが、セキュリティを考慮してSSH公開鍵のみでユーザーを認証するようSSHサーバーの設定を変更します。

この設定後は、SSH公開鍵がvagrantユーザーの認証鍵ファイル(authorized_keys)に登録されていないユーザーからの接続が拒否されます。このため、新たにリモートユーザーの操作を許可するためには、リポジトリサーバーに接続可能なユーザーがSSH認証鍵を認証鍵ファイルに追加する必要があります。

/etc/ssh/sshd_config を下記のとおり編集します。

$ sudo vi /etc/ssh/sshd_config

UsePAN no
PasswordAuthentication no
RSAAuthentication yes
PubkeyAuthentication yes

編集が終了したら、SSHサーバーを再起動します。

$ sudo service sshd restart

以上の手順で、リポジトリサーバーの構築が終了します。

リポジトリの作成(create)

CVS同様、バージョン管理を行うファイルやフォルダ(以下、オブジェクトと記す)、変更履歴などを格納するリポジトリを作成します。

リポジトリの初期化方法は、CVSではinitコマンドを使用してリポジトリを初期化しましたが、Subversionでは、svnadminを使用してリポジトリを初期化します。

$ svnadmin create /home/vagrant/myrepos

実行すると、ホームディレクトリ下にmyreposリポジトリが作成され、バージョン管理に必要なファイルやフォルダが生成されます。

リポジトリに格納されているモジュールを確認します。

リポジトリを作成しただけですので、モジュールが何も格納されていないことがわかります。

$ svn list file:///home/vagrant/myrepos

なお、CVSではリポジトリの指定に環境変数CVSROOTを使用できましたが、Subversionでは、セキュリティに配慮し環境変数によるリポジトリの指定はできません。

以上で、リポジトリの初期化が終了します。

モジュールのインポート(import)

バージョン管理の対象となるオブジェクトをモジュールとして登録します。

importコマンドでは、オブジェクトを指定し、リポジトリURL/モジュール/プロジェクトの書式で、リポジトリにインポートします。

今回の場合、下記のとおり指定しています。

$ svn import .ssh file:///home/vagrant/myrepos/ssh-config/vagrant -m'First Import'

登録された、モジュール、プロジェクト、オブジェクトを確認します。

// モジュール確認
$ svn list file:///home/vagrant/myrepos
// プロジェクト確認
$ svn list file:///home/vagrant/myrepos/ssh-config/
// オブジェクト確認
$ svn list file:///home/vagrant/myrepos/ssh-config/vagrant

今回は、理解しやすさを考慮して、リポジトリを作成し、モジュールを登録していますが、Subversionでは、下記のフォルダを含むリポジトリレイアウトを推奨しています。

このため、推奨レイアウトを使用したリポジトリの登録とインポートは、下記のようになります。

// svnrepoリポジトリを作成
$ svnadmin create /home/vagrant/svnrepo

// 推奨されるtrunk/branches/tagsフォルダを作成
$ svn mkdir --parents file:///home/vagrant/svnrepo/ssh-config/vagrant/trunk -m'create trunk'
$ svn mkdir --parents file:///home/vagrant/svnrepo/ssh-config/vagrant/branches -m'create branches'
$ svn mkdir --parents file:///home/vagrant/svnrepo/ssh-config/vagrant/tags -m'create tags'

// オブジェクトをtrunkにインポート
$ svn import .ssh file:///home/vagrant/svnrepo/ssh-config/vagrant/trunk -m'First Import'

// リポジトリ確認
$ svn list file:///home/vagrant/svnrepo

このように、Subversionに登録するオブジェクトは、どのような階層構造であってもインポートすることができます。

また、作成するリポジトリ構成も、こうしなければならない(must)というものでは無く、推奨(recommend)という扱いですから、管理しやすいリポジトリ構成を作成しましょう。
また、CVSと同様に、リポジトリ操作においてメッセージを入力する必要があるmkdir/import/commitなどのコマンドを実行する際に、-mオプションを指定してメッセージを指定していますが、環境変数SVN_EDITORにエディタを指定しておくと、エディタ上で、メッセージを入力することができます。

export SVN_EDITOR=vi

チェックアウト(co)

登録したモジュールを、任意のフォルダ上にチェックアウトします。

$ cd /tmp
$ svn co file:///home/vagrant/myrepos/ssh-config/vagrant

CVSと同じようにチェックアウトできますが、CVSの場合、ssh-configフォルダが作成されるのに対して、Subversionでは、vagrantフォルダが作成されてチェックアウトされます。

両方のコマンドを実行して比べてみて下さい。

$ cd /tmp
$ cvs co sh-config/vagrant

承認(commit)

チェックアウトしたモジュール中のファイルを修正し、リポジトリに反映(コミット)します。

$ cd vagrant
$ vi authorized_key
$ svn commit -m'authorized_key update'

実行すると、リビジョン1からリビジョン2に変更されたことがわかります。

更新(update)

Subversionによるバージョン管理も、複数名によりリポジトリが更新されて行きますので、自分がチェックアウトしたモジュールを最新版にアップデートする必要があります。

ここでは、別フォルダにチェックアウトしたモジュールをコミットした後、更新しています。

$ mkdir -p /tmp/work
$ cd /tmp/work
$ svn co file:///home/vagrant/myrepos/ssh-config/vagrant
$ cd vagrant/
$ vi authorized_keys
$ svn commit -m'commit on work folder'

$ cd /tmp/vagrant
$ svn update

追加(add)

作業用フォルダにファイルを追加し、リポジトリにコミットします。

ここでは、/tmp/vagrant フォルダ下のファイルを別名(known_hosts)にコピーして、追加(add)の後コミットしています。

$ cd /tmp/vagrant
$ cp authorized_keys known_hosts
$ svn add known_hosts
$ svn commit -m'add known_hosts'

次に、/tmp/work/vagrantフォルダ上で、リポジトリを更新すると追加したファイルが取得できます。

$ cd /tmp/work/vagrant
$ svn update

ssh-agentの準備

リポジトリサーバーに接続可能なSSH公開鍵にパスフレーズが設定されている場合、リポジトリへの操作の度にパスフレーズを要求されますので、ssh-agentを使用してパスフレーズ入力を代替します。

Cygwin端末を起動し、SSH秘密鍵を登録します。

$ ssh-agent bash
$ ssh-add ~/.ssh/id_rsa

登録の際に、パスフレーズを要求されますので、パスフレーズを入力します。
以上で、ssh-agentの準備が終了します。

チェックアウト(co)

リモートからモジュールをチェックアウトします。

先に設定した、ssh-agentによってパスフレーズを要求されること無く、モジュールのチェックアウトができます。

$ svn co svn+ssh://vagrant@192.168.0.10/home/vagrant/myrepos/ssh-config/vagrant

ログ参照(log)

ファイルの変更履歴を表示します。

$ svn log

状態表示(status)

自分が変更したファイルを確認します。

CVSのstatusコマンドでは、作業フォルダ上のファイルの状態を表示しましたが、Subversionでは変更したファイルを表示します。

$ svn status

変更したファイルがあれば、ファイルの状態を表示します。

変更をコミットすると、何も表示されなくなります。

モジュールをチェックアウトすると、リポジトリの操作は、モジュールの登録を含め全てローカル上と同じように操作できます。