Установка Gerrit на облачный сервер Ubuntu

Что такое Gerrit?

Gerrit (также Gerrit code review) – это синхронизированный с git инструмент для инспекции исходного кода, позволяющий толкнуть код для проверки в надежный репозиторий, прежде чем переводить его на стадию производства. Приложение Gerrit многофункционально, что позволяет создать на его основе надежную платформу, заменить стандартную базу данных H2 более популярными MySQL или Postgres, использовать Gerrit вместе с веб-сервером и даже изменить способ авторизации (например, оставив только логин; стандартный логин – open_id).

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

Примечание: Строки, которые необходимо ввести самостоятельно или отредактировать, выделены красным! Остальной код можно просто скопировать и вставить.

1: Установка Git

Прежде чем приступить к установке Gerrit, нужно убедиться, что система контроля версий Git установлена на сервере. Чтобы выполнить быструю установку Git, используйте менеджер apt-get:

sudo apt-get install git

Примечание: Более подробные инструкции по установке Git можно найти в этом руководстве.

2: Установка Java

Для корректной работы Gerrit также необходимо установить Java. Сначала проверьте, нет ли на сервере готовой установки Java:

java -version

Если команда не вернула версию, значит, Java нужно установить. Для этого используйте apt get:

sudo apt-get install default-jdk

3: Установка Gerrit

Установив Git и Java, можно приступать к установке Gerrit. Сама программа размещена на сайте Google Code; последняя версия программы на момент написания статьи – 2.7.

Загрузите war-файл:

wget https://gerrit.googlecode.com/files/gerrit-2.7-rc1.war

После загрузки  необходимо инициализировать Gerrit. Для этого используйте приведенную ниже команду.

Чтобы загрузить настройки по умолчанию, используйте опцию –batch. Кроме того, по умолчанию gerrit ограничивает пользователей их домашними каталогами; чтобы создать специальный каталог для хранения файлов, добавьте флаг –d:

java -jar gerrit-2.7-rc1.war init --batch -d ~/gerrit_example

Если этот процесс был выполнен автоматически, приложение gerrit будет доступно по каноническому URL-адресу localhost.

4: Доступ к Gerrit

Сразу после установки Gerrit можно получить доступ к приложению при помощи любого удобного пользователя.

Gerrit доступен по каноническому URL-адресу, который можно найти в настройках при помощи команды:

git config -f ~/gerrit_example/etc/gerrit.config gerrit.canonicalWebUrl

Появившийся на экране результат будет выглядеть примерно так:

http://localhost:8080/

Настройки Gerrit можно редактировать в конфигурационном файле gerrit.config:

vi  ~/gerrit_example/etc/gerrit.config

Внеся все нужные изменения, не забудьте перезапустить Gerrit:

~/gerrit_example/bin/gerrit.sh restart

Если в каноническом URL есть localhost, то доступ к gerrit модно получить, указав IP-адрес сервера.

При этом страница будет иметь такой вид:

gerrit_install

Учетную запись на сервере можно создать при помощи OpenID. По умолчанию первый зарегистрированный аккаунт становится суперпользователем (т.е. аккаунтом администратора).

5: Создание пользователя Gerrit

Во время создания пользователя экран выглядит так:

gerrit_user

На данном этапе нужно заполнить несколько полей: Email, Username, и SSH-ключ пользователя.

Примечание: Чтобы зарегистрировать пользователя, указанный электронный адрес нужно подтвердить.

Обратите внимание на большое поле на этой странице; оно предназначено для SSH-ключа пользователя. Создайте новый или используйте уже существующий SSH-ключ. Чтобы создать ключ, следуйте инструкциям на странице.

Чтобы убедиться, что SSH-ключ работает, попробуйте войти в gerrit при помощи командной строки, указав имя пользователя. По умолчанию приложение gerrit запускается на порт 29418.

ssh username@localhost -p 29418

После успешной авторизации на экране появится следующий текст:

ssh username@localhost -p 29418
The authenticity of host '[localhost]:29418 ([cannonicalURL]:29418)' can't be established.
RSA key fingerprint is 19:73:55:9d:63:8b:c5:6f:cb:ee:4c:51:b4:e6:69:e4.
Are you sure you want to continue connecting (yes/no)? yes
Warning: Permanently added '[ocalhost]:29418' (RSA) to the list of known hosts.
****    Welcome to Gerrit Code Review    ****
Hi, you have successfully connected over SSH.
Unfortunately, interactive shells are disabled.
To clone a hosted Git repository, use:
git clone ssh://username @localhost:29418/REPOSITORY_NAME.git
Connection to cannonical URL closed.

Tags: , , , , , ,

Добавить комментарий