多くの開発者がバージョン管理のために GitHub や GitLab などの Git ホスティングサービスを利用しています。何らかの事情でサービスを利用出来ない場合は、GitLab をセルフホストする方も多いでしょう。
とはいえ「うまく動いている既製品があるから」といって生の Git サーバに触らないまま大切なコードを預けているのも変な話なので、Pro Git book を読みながら構築してみることにしました。
Git packaged by Bitnami とは
Git packaged by Bitnami は Git を Bitnami がパッケージ化したものです。Docker イメージの形式で提供されているので、依存関係を気にせず手軽に使い始めることができますね。
docker run --name git bitnami/git:latest git --version
Dockerfile のある Git リポジトリはこちらです。
コンテナを Git サーバに仕立てる
Pro Git book を見ながらインタラクティブに操作していきましょう。コンテナを立ち上げ、bash を起動します。このとき、SSH 接続用のポートと、Web UI 用のポートをフォワードしておきます。コンテナ外にデータを保持したい場合は、ボリュームやマウントの設定も追加してください。また、 bash が終了してもコンテナを稼働させたい場合は、コマンドをtail -f /dev/null に変更するなどしてください。
docker run -it --name git -p 10022:22 -p 11234:1234 bitnami/git:latest bash
続いて、サーバーのセットアップを行います。まず、git ユーザを作成します。
useradd -m git -s /bin/bash
git ユーザに SSH 経由で接続できるように設定します。
su git
cd ~
mkdir .ssh
chmod 700 .ssh
touch .ssh/authorized_keys
chmod 600 .ssh/authorized_keys
exit
# SSH デーモンを開始
/etc/init.d/ssh start
/home/git/.ssh/authorized_keys に公開鍵の情報を追記してください。Docker ホストから ssh -p 10022 git@localhost で接続できたら成功です。
次に、Git リポジトリを作成します。
su git
cd ~
mkdir <リポジトリ名>
cd <リポジトリ名>
git init --bare
exit
最後に、git ユーザのログインシェルを git-shell に変更します。SSH で好き勝手いじれないように制限する都合もありますが、Git 関連コマンドにパスを通す意味もあります。
chsh git -s /opt/bitnami/git/bin/git-shell
# git ユーザで bash 操作が必要なときは sudo で立ち上げる
sudo -u git bash
あとはお手元のリポジトリで remote として追加するだけで使い始めることができます！ git コマンドに SSH 用のポートを指定するには、以下のように設定します：
git remote add <リモート名> ssh://git@localhost:10022/~/<リポジトリ名>
GitWeb (Web UI) を表示する
GitWeb は Git に標準で付属する Web UI です。Git サーバとして使うなら最低限ほしいところなので、表示できるようにしておきましょう。
# instaweb の依存を追加します
apt update
apt install -y lighttpd libcgi-pm-perl gamin
# ゴミ掃除（任意）
apt clean -y
rm -rf /var/lib/apt/lists/*
cd /home/git/<リポジトリ名>
sudo -u git git instaweb
Port 1234 のフォワード先にアクセスすると、GitWebが表示されます。
