C4 always sleepy

Настраиваем git-сервер с использованием gitosis

В связи с переходом на git у меня появилась необходимость настроить центральный git-репозитарий для всех проектов. Для этой цели я решил использовать gitosis - удобное средство, позволяющее управлять репозитариями, используя всего один пользовательский аккаунт, управляя доступом пользователей к репозитариям на основе ssh-ключей. В этом туториале я постараюсь рассказать по шагам как это сделать. Так как я использую Ubuntu Server на linode.com все материалы будут относиться именно к этой системе. В принципе - настройка на других системах (FreeBSD, Windows итд) будут не сильно отличаться от описанных ниже, единственное надо будет учитывать нюансы соответствующих систем.

Предусловие - у вас должен быть уже установлен git. Если вы этого еще не сделали - самое время выполнить из консоли

$ sudo apt-get install git-core

Мне не удалось найти gitosis в списке доступных приложений в менеджере пакетов, поэтому установку пришлось делать из исходников

$ cd ~/src
$ git clone git://eagain.net/gitosis.git
$ cd gitosis
$ python setup.py install

Также необходимы python и python-setuptools. О необходимости установки вам могут сказать сообщения

-bash: python: command not found

или соответственно

Traceback (most recent call last):
  File "setup.py", line 2, in ?
    from setuptools import setup, find_packages
ImportError: No module named setuptools

Установить setuptools можно с помощью

$ sudo apt-get install python-setuptools

Следующим шагом добавим пользователя, который будет владельцем репозитариев. Пользователь не должен иметь возможности для логина, но шелл ему нужен корректный - иначе gitosis не будет работать.

sudo adduser \
    --system \
    --shell /bin/sh \
    --gecos 'git version control' \
    --group \
    --disabled-password \
    --home /home/git \
    git

Теперь необходимо сгенерировать ssh ключ для пользователя, который будет конфигурировать репозитарий. Да-да - именно репозитарий с настройками Дело в том, что gitosis хранит все свои настройки в отдельном репозитарии и в любой момент можно отследить историю внесенных в них изменений.

$ ssh-keygen -t rsa

В принципе - вы можете сгенерировать ключ как на самом сервере, так и на своей рабочей машине и залить ключ используя scp. Сейчас нас интересует публичный ключ, который находится в $HOME/.ssh/id_rsa.pub

Теперь создадим репозитарий с настройками и добавим наш ключ

$ sudo -H -u git gitosis-init <  /tmp/id_rsa.pub

Давайте приступим к настройкам.

$ git clone git@YOUR_SERVER:gitosis-admin.git
$ cd gitosis-admin
$ vi gitosis.conf

Итак, давайте посмотрим что же у нас в файле gitosis.conf

[gitosis]                  

[group gitosis-admin]
writable = gitosis-admin
members = you@yourhost

Как вы видите - сейчас имеется группа gitosis-admin, в которую добавлены вы с правами редактирования репозитария с конфигурацией. Давайте создадим еще один проект и добавим нового пользователя developer@remotehost c правами на запись. Для этого немного отредактируем наш конфиг:

[gitosis]                  

[group gitosis-admin]
writable = gitosis-admin
members = you@yourhost

[group prj1]
writable = project1
members = you@yourhost developer@remotehost

Как видите - ничего сложного Закачиваем ssh-ключ нового пользователя в keydir, имена пользователей разделяем пробелом (заметьте - расширение .pub в конфиге не указываем), сохраняем конфиг и коммитим изменения

$ git commit -am "Granted access for developer@remotehost to project1"
$ git push

Ок, изменения в конфиг мы внесли, но где же сам репозитарий? Он должен находиться в /home/git/repositories/, поэтому иы делаем следующее:

$ cd /home/git/repositories
$ mkdir project1.git
$ git init project1.git
$ chown -R git:git project1.git

Ну вот в принципе и все что нам требовалось знать для настройки gitosis. В принципе если посмотреть файл ~/src/gitosis/example.conf - то можно найти еще пару нюансов настройки.