gitosis による git サーバーの管理 の履歴(No.17)

gitosis について†

gitosis は、（複数の）git リポジトリの管理を容易に行うためのソフトウェア。
詳しい説明は、http://openbooth.org/archives/60.html あたりを参照のこと。

gitosis により管理されるサーバーには

git clone gitosis-account@some.your.server.com:some-project

のような形でアクセスすることになる。

some.your.server.com

gitosis をインストールしたサーバーのアドレス

gitosis-account

some.your.server.com に(通常は)１つだけ作成された gitosis 用のアカウント名
すべてのユーザーはこのアカウントを通じてリポジトリにアクセスする

some-project

git リポジトリの名前
１つの gitosis-account で複数の git リポジトリを管理することができる

リポジトリへのアクセス制御は公開鍵(rsa)ベースで、 ユーザーごと、そして、リポジトリごとに、 読み取り専用、または、読み書き可能、を指定できる。

git リポジトリの以下のような管理は、shell ログインすることなく git を使ってリモートから行える。

• 新しいリポジトリの作成
• ユーザーアカウントの追加・削除
• リポジトリごと、ユーザーごとのアクセス制御

LANG:console
$ wget https://downloads-packages.s3.amazonaws.com/debian-7.8/gitlab_7.7.2-omnibus.5.4.2.ci-1_amd64.deb
$ sudo dpkg -i gitlab_7.7.2-omnibus.5.4.2.ci-1_amd64.deb
$ sudo gitlab-ctl reconfigure

# ボート競合を回避する方法
# from http://d.hatena.ne.jp/toritori0318/20140524/1400955383
$ sudo jed /etc/gitlab/gitlab.rb
 external_url 'http://dora.bk.tsukuba.ac.jp:88/'
 unicorn['port'] = 18080
 postgresql['port'] = 15432
 redis['port'] = 16379
 ci_unicorn['port'] = 18181

Username: root
Password: 5iveL!fe

Debian での gitosis のインストール†

• http://openbooth.org/archives/65.html

と同様にやれば良いんだけれど、 はまるのは、git というユーザーを使おうとするとうまく行かない事。

gitosis というユーザーが自動的に作られるので、それを使う。

手順としては、

1. aptitude で gitosis をインストール (１行目：aptitude install)
2. １人目の管理者（自分）の公開鍵を用いて gitosis を初期化 (１０行目：gitosis-init)
3. 自分のアカウントからアクセスできることを確認する （１７行目：ssh）

LANG:console
$ sudo aptitude install gitosis
 以下の新規パッケージがインストールされます:
   gitosis python-pkg-resources{a} python-setuptools{a} 
 更新: 0 個、新規インストール: 3 個、削除: 0 個、保留: 0 個。
 284kB のアーカイブを取得する必要があります。展開後に 1217kB のディスク領域が新たに消費されます。
$ sudo su gitosis
gitosis$ cd
gitosis$ pwd
 /srv/gitosis
gitosis$ gitosis-init < ~osamu/.ssh/id_rsa.pub
 Initialized empty Git repository in /home/git/repositories/gitosis-admin.git/
 Reinitialized existing Git repository in /home/git/repositories/gitosis-admin.git/
gitosis$ ls -a
 .ssh     gitosis  repositories
gitosis$ exit
$ cd
$ ssh gitosis@localhost
 PTY allocation request failed on channel 0
 ERROR:gitosis.serve.main:Need SSH_ORIGINAL_COMMAND in environment.
 Connection to localhost closed.

最後の一行、エラーになっているように見えるが、**ログインが成功した後**、 何も Git のコマンドを指定していないので、接続が拒否された、という意味。

管理作業†

• http://openbooth.org/archives/82.html

を参考に、osamu@another-server をもう１人の管理者として登録してみる。

gitosis のリポジトリ管理情報は、それ自体１つの git リポジトリで管理されているので、 その編集手順は次のようになる。

1. 管理情報リポジトリである gitosis-admin をローカルにコピー : git clone
2. 管理情報をローカルで編集 : gitosis.conf をエディタで編集したり、公開鍵を keydir にコピーしたり
3. 編集結果をローカルリポジトリに登録 : git add / git commit
4. ローカルリポジトリをサーバーに送信 : git push

LANG:console
$ git clone gitosis@localhost:gitosis-admin.git
 Initialized empty Git repository in /home/osamu/gitosis-admin/.git/
 remote: Counting objects: 5, done.
 remote: Compressing objects: 100% (4/4), done.
 remote: Total 5 (delta 0), reused 5 (delta 0)
 Receiving objects: 100% (5/5), done.
$ ls
 gitosis-admin
$ cd gitosis-admin/
$ ls
 gitosis.conf    keydir
$ ls keydir
 osamu@debian-server.pub
$ cat gitosis.conf
 [gitosis]
 
 [group gitosis-admin]
 writable = gitosis-admin
 members = osamu@debian-server
$ jed gitosis.conf
 [gitosis]
 
 [group gitosis-admin]
 writable = gitosis-admin
 members = osamu@debian-server, osamu@another-server
$ scp osamu@another-server:.ssh/id_rsa.pub keydir/osamu@another-server.pub
$ ls keydir
 osamu@another-server    osamu@debian-server
$ git add keydir/osamu@another-server.pub
$ git commit -a
 Created commit d7e6afb: osamu@another-server.pub was added as admin
  1 files changed, 1 insertions(+), 0 deletions(-)
  create mode 100644 keydir/takeuchi@dora.pub
$ git status
 # On branch master
 nothing to commit (working directory clean)
$ git push
 Counting objects: 6, done.
 Compressing objects: 100% (4/4), done.
 Writing objects: 100% (4/4), 730 bytes, done.
 Total 4 (delta 0), reused 0 (delta 0)
 To gitosis@localhost:gitosis-admin.git
    31412ce..d7e6afb  master -> master

これで、新しいユーザーが追加され、 登録した公開鍵を使って gitosis アカウントにログイン可能になっている。

LANG:console
$ ssh osamu@another-server
$$ git clone gitosis@gitosis.server:gitosis-admin.git
 Initialized empty Git repository in ~/gitosis-admin/.git/
 remote: Counting objects: 10, done.
 remote: Compressing objects: 100% (9/9), done.
 remote: Total 10 (delta 1), reused 4 (delta 0)
 Receiving objects: 100% (10/10), done.
 Resolving deltas: 100% (1/1), done.
$$ rm -r gitosis-admin

うまく行っている。

gitosis-admin/
  gitosis.conf
  keydir/
    osamu@another-server.pub
    osamu@debian-server.pub

[group グループ名]
members = member1 member2 member3 @other-group ...
writable = リポジトリ１ リポジトリ２ リポジトリ３ ...
readonly = リポジトリ１ リポジトリ２ リポジトリ３ ...

[repo リポジトリ１]
## Allow gitweb to show this repository.
#gitweb = yes

## Oneline description of the project, mostly for gitweb.
#description = blah blah

## Owner of this repository. Used in gitweb list of projects.
#owner = John Doe

## Allow git-daemon to publish this repository.
#daemon = yes

LANG:console
git commit -a -m "message"
git push

LANG:console
$ git clone gitosis@my.debian-server.com:gitosis-admin.git
  ...

$ cd gitosis-admin/
$ jed gitosis.conf
...

[group myteam]
members = member1 member2 member3
writable = my_project
...

$ git commit -a -m "my_project created"
$ git push
$ mkdir my_project
$ cd my_project
$ git init
$ git remote add origin gitosis@git.server.com:my_project.git
$ # do some work, git add and commit files
$ git push origin master:refs/heads/master

フックの使い方†

git リポジトリにフックを仕込むことで、リポジトリの更新時にメールを送信するなどが 可能となる・・・のではないかとの記述を目にした。後で調べてみよう。

(2011/03/24 追記)
http://labs.gree.jp/blog/2011/03/2885/
こちらのサイトに詳しく使い方が紹介されていました。

コメント†

自由にコメントを付けて下さい。