www.mtkn.jp

git_server.html (6603B)

---

 <h1>Gitサーバーの設定 on OpenBSD</h1>
 <time>2024-02-14</time>
 
 <h2>はじめに</h2>
 <p>
 GitHubがMicrosoft傘下になり久しい。\
 MincraftがMicrosoftアカウントなしでは遊べなくなった。\
 このままではGitHubもそのうちMicrosoftアカウントを要求するように\
 なるかもしれない。\
 ということでGitサーバーを自前で持つことにした。\
 </p>
 
 <h2>手順</h2>
 <p>
 以下ではssh接続によるpull/push及び、httpsによるpullを設定する。
 <h3>概要</h3>
 <ol>
 <li>ドメインの設定(任意)</li>
 <li><code>httpd(8)</code>の設定</li>
 <li>gitパッケージのインストールとchroot環境の整備</li>
 </ol>
 
 <h3>ドメインの設定(任意)</h3>
 <p>
 ドメインを設定する。\
 IPアドレスでアクセスできればいいならこの工程はいらない。\
 </p>
 <p>
 今回はgitというサブドメインを登録した:
 </p>
 <table>
 <thead>
 <tr>
 <th>サブドメイン</th>
 <th>種別</th>
 <th>内容</th>
 <th>優先度</th>
 </tr>
 </thead>
 <tbody>
 <tr>
 <td>git</td>
 <td>A</td>
 <td><i>サーバーのIPアドレス</i></td>
 <td></td>
 </tr>
 </tbody>
 </table>
 
 <h3><code>httpd(8)</code>の設定</h3>
 <p>
 httpsで接続する場合、<code>acme-client(8)</code>を設定する。\
 まず<code>/etc/acme-client.conf</code>にドメインを追加する:
 </p>
 <pre><code>\
 domain git.mtkn.jp {
         domain key "/etc/ssl/private/git.mtkn.jp.key"
         domain full chain certificate "/etc/ssl/git.mtkn.jp.fullchain.pem"
         sign with letsencrypt
 }
 </code></pre>
 
 <p>
 続いて<code>/etc/httpd.conf</code>を設定する。\
 </p>
 <pre><code>\
 server "git.mtkn.jp" {
         listen on * port 80
         location "/.well-known/acme-challenge/*" {
                 root "/acme"
                 request strip 2
         }
         location "*" {
                 block return 302 "https://$HTTP_HOST$REQUEST_URI"
         }
 }
 
 server "git.mtkn.jp" {
         listen on * tls port 443
         tls {
                 certificate "/etc/ssl/git.mtkn.jp.fullchain.pem"
                 key "/etc/ssl/private/git.mtkn.jp.key"
         }
         location "/.well-known/acme-challenge/*" {
                 root "/acme"
                 request strip 2
         }
         location "/*/git-receive-pack" {
                 block
         }
         location "/*/git-upload-pack" {
                 fastcgi {
                         param SCRIPT_FILENAME "/usr/local/libexec/git/git-http-backend"
                         param GIT_PROJECT_ROOT "/git"
                         param GIT_HTTP_EXPORT_ALL "true"
                 }
         }
         location "/*/info/refs" {
                 fastcgi {
                         param SCRIPT_FILENAME "/usr/local/libexec/git/git-http-backend"
                         param GIT_PROJECT_ROOT "/git"
                         param GIT_HTTP_EXPORT_ALL "true"
                 }
         }
 }
 </code></pre>
 <p>
 <code>location "/*/git-receive-pack"</code>はpushの設定。\
 今回はhttpsでのpushを受付けないので<code>block</code>する。\
 </p>
 <p>
 <code>location "/*/git-upload-pack"</code>は手元のパソコンから\
 <code>git clone</code>や<code>git pull</code>したときのもの。\
 <code>location "/*/info/refs"</code>は上記を含むアクセスがあったときのもの。\
 ここではCGIを使って<code>git-http-backend</code>を呼んでいるだけである。\
 <code>SCRIPT_FILENAME</code>は<code>httpd(8)</code>のchroot環境でのパスである。\
 必要なファイルは後でこのchroot環境にコピーする。
 </p>
 <p>
 httpsが必要ない場合は1つ目の<code>server</code>に各<code>location</code>を書くだけ\
 でいい。
 </p>
 <p>
 <code>httpd(8)</code>と<code>slowcgi(8)</code>を起動する:
 </p>
 <pre><code>\
 # echo httpd_flags= &gt;&gt; /etc/rc.conf.local
 # echo slowcgi_flags= &gt;&gt; /etc/rc.conf.local
 # rcctl start httpd
 # rcctl enable httpd
 # rcctl start slowcgi
 # rcctl enable slowcgi
 </code></pre>
 <p>
 サーバー証明書の発行:
 </p>
 <pre><code>\
 # acme-client -b git.mtkn.jp
 </code></pre>
 <p>
 <code>crontab(1)</code>にサーバー証明書の自動更新を登録:
 </p>
 <pre><code>\
 #minute hour    mday    month   wday    [flags] command
 ~ 2 * * * acme-client git.mtkn.xyz && rcctl reload httpd
 </code></pre>
 
 <h3>gitパッケージのインストールとchroot環境の整備</h3>
 <p>
 gitパッケージをインストールし、ssh接続用のユーザーを作成する。\
 httpsでも公開するので、gitユーザーのホームディレクトリは<code>/var/www</code>\
 下にする:
 </p>
 <pre><code>\
 # pkg_add git
 # useradd -b /var/www -m -s /usr/local/bin/git-shell git
 </code></pre>
 <p>
 ssh接続用の公開鍵を<code>/var/www/git/.ssh/authorized_keys</code>に登録する。\
 セキュリティ大丈夫かこれ。\
 一応所有者は<code>git:git</code>、権限は<code>-rw-------</code>。\
 </p>
 
 <p>
 httpsでアクセスするためにchroot環境を整備する。\
 <code>httpd(8)</code>は既定では/var/wwwにchrootして実行されるので、\
 CGIに必要なファイルをこのディレクトリ以下に用意する必要がある。\
 まずはgitのコマンドをコピー:
 </p>
 <pre><code>\
 # mkdir -p /var/www/usr/local/libexec/git
 # cp /usr/local/libexec/git-{http-backend,receive-pack,upload-pack} /var/www/usr/local/libexec/git/
 # mkdir -p /var/www/usr/local/bin
 # cp /usr/local/bin/git /var/www/usr/local/bin/
 </code></pre>
 <p>
 続いてコマンドの実行に必要なライブラリをコピー:
 </p>
 <pre><code>\
 # mkdir -p /var/www/usr/lib /var/www/usr/local/lib /var/www/usr/libexec
 # find /var/www/{bin,usr} -type f | grep git | xargs ldd | awk '{print $7}' | grep -v -e '^/var/www/' -e '^$' -e 'Name' | sort | uniq | awk '{printf "cp %s /var/www%s\ n", $1, $1}' | sh -s
 </code></pre>
 <p>
 <code>/dev/null</code>をコピーする(<code>mknod(8)</code>参照):
 </p>
 <pre><code>\
 # mkdir /var/www/dev
 # mknod -m 666 /var/www/dev/null c 2 2
 </code></pre>
 <p>
 最後に、<code>/var/www/dev/null</code>を作成するために\
 <code>/etc/fstab</code>の<code>/var</code>エントリーから\
 <code>nodev</code>オプションを削除し、再起動する。
 </p>
 
 <h2>レポジトリの作成</h2>
 <p>
 レポジトリを作成するにはサーバーで以下のようにする。\
 </p>
 <pre><code>\
 $ cd /var/www/git
 $ doas -u git mkdir <i>repo</i>.git
 $ cd <i>repo</i>.git
 $ doas -u git git init --bare
 </code></pre>
 
 <p>
 これで手元のパソコンからクローンできる:
 </p>
 <pre><code>\
 $ git clone https://git.mtkn.jp:<i>repo</i>.git
 </code></pre>