VersionCtl/git/Gerrit の編集

#topicpath

//////////////////////////////////////////////////////////////////////////////
* 目次 [#r9489306]
#contents();

//////////////////////////////////////////////////////////////////////////////
* インストールと設定 [#vbe202f4]

//============================================================================
** ユーザ <gerrit-user> を作成 [#kb13275f]
- adduser でユーザ <gerrit-user> （実際に作成したユーザ名は"gerrit"）を作成
- <gerrit-user> の ${HOME} (= /home/<gerrit-user>) を、 <gerrit-group>  グループに対して rwx を許可する。
 # chmod g+rwx /home/<gerrit-user>
 $ ls -l /home/
 合計 12
 drwxrwxr-x  3 gerrit gerrit   88  8月 28 08:40 gerrit

//============================================================================
** DB [#y37550cd]
- ここでは PostgreSQL を選択した。
 # apt-get install postgresql postgresql-contrib

//----------------------------------------------------------------------------
*** PostgreSQL の設定 [#b508915c]
- ユーザ "postgres" になる（See also: [[sudo>Security/sudo]]）
 $ sudo -i -u postgres
- そこから更に Postgres prompt を呼び出すのに、以下をタイプする：
 $ psql
 postgres@localhost:~$
- Postgres prompt から抜けるには、以下をタイプする：
 postgres@localhost:~$ \q

- role の新規作成
 postgres@localhost:~$ createuser --username=postgres -RDIElPS <gerrit-user>
 postgres@localhost:~$ createdb --username=postgres -E UTF-8 -l ja_JP.UTF8 -T template0 -O <gerrit-user> reviewdb

//============================================================================
** Gerrit の DL/Install [#a07c2055]
- /etc/apt/sources.list.d に Gerrit のエントリを追加する
 # echo "deb mirror://mirrorlist.gerritforge.com/deb gerrit contrib" > /etc/apt/sources.list.d/gerritforge.list
- GPG key を追加
 # apt-key adv --keyserver keyserver.ubuntu.com --recv-keys 1871F775
- 取得
 # aptitude update
 # aptitude install gerrit

//----------------------------------------------------------------------------
*** Gerrit の設定編集 [#t22c2363]
- Gerrit の設定は /var/gerrit/etc/gerrit.config にある。
- /var/gerrit/etc/gerrit.config を以下のように変更する：
 # diff gerrit.config gerrit.config.orig 
 3c3
 <       canonicalWebUrl = http://<your-host-name>:8080/gerrit
 ---
 >       canonicalWebUrl = http://<your-host-name>:8080/
 16c16
 <       listenUrl = proxy-http://<your-host-name>/gerrit
 ---
 >       listenUrl = http://*:8080/
- 設定を変更したら、 Gerrit を再起動する。下記のように "OK" が出れば再起動成功。
 # /etc/init.d/gerrit restart
 Stopping Gerrit Code Review: OK
 Starting Gerrit Code Review: OK

- ユーザが Gerrit から Sign out した際、 canonicalWebUrl の URI へ自動遷移するようになっている。

//============================================================================
** apache2 [#c3b4ed56]
- /etc/apache2/sites-enabled/000-default.conf を以下のように修正する
 # diff -u 000-default.conf 000-default.conf.orig 
 --- 000-default.conf
 +++ 000-default.conf.orig
 @@ -26,8 +26,6 @@
         # following line enables the CGI configuration for this host only
         # after it has been globally disabled with "a2disconf".
         #Include conf-available/serve-cgi-bin.conf
 -
 -       AllowEncodedSlashes On
  </VirtualHost>
  
  # vim: syntax=apache ts=4 sw=4 sts=4 sr noet
- apache2 を再起動する
 # /etc/init.d/apache2 restart
 Restarting apache2 (via systemctl): apache2.service.

//////////////////////////////////////////////////////////////////////////////
* Gerrit を使う [#yf624a94]
- 上記設定を行った後、ブラウザでアクセスする
 http://<your-host-name>:8080/gerrit

//============================================================================
** ユーザの追加 [#a4414b0a]
+ 右上から"Become" リンクをクリックする
+ Register の "New Account" ボタンをクリックする
+ ユーザ名、メールアドレス等を登録する。ここで登録するメールアドレスは、ユーザが実際に git で使用しているアドレス（git config で設定したもの）を登録する必要がある。

//============================================================================
** 初期設定 [#za5bf88b]
+ 右上から"Become" リンクをクリックする
+ 右上の自分のアカウント名をクリックし、PopUp から "Settings" をクリックする。
+ 左メニューの "SSH Public Keys" をクリックし、表示されたテキストボックス内に、自分の [[ssh 公開鍵>Security/ssh]]を貼り付ける

//============================================================================
** プロジェクトの追加 [#add-new-repos]
+ Administrator で Sign In する
+ "Projects" → "Create New Project" を選択
+ "Project Name:", "Rights Inherit From:" に適切な値を設定し、 "Create initial empty commit" にチェックを入れる。
-- Project Name には、 <project-repos-name> として適切なものを入れること。
+ "Create Project" をクリック
+ "Projects" → "General" を選択し、 "Require Change-Id in commit message:" を "FALSE" にする。

//============================================================================
** ユーザグループの追加 [#ff2b4719]
- ユーザが各リポジトリにアクセスするための権限を設定するため、 Group を設定する。
-

//============================================================================
** 追加したプロジェクトの checkout [#x63c3402]
- 以下のコマンドで checkout 出来る：
 $ git clone ssh://<user-name>@<your-host-name>:29418/<project-repos-name>

//////////////////////////////////////////////////////////////////////////////
* 参考リンク [#x594e543]
- [[Ubuntu ServerにGerritをインストールする >http://ameblo.jp/dumbobambino/entry-11938447999.html]]
-- 最終的に参考にしたのはこれ。
- [[Gerrit Code Review - Standalone Daemon Installation Guide>https://gerrit-documentation.storage.googleapis.com/Documentation/2.9.1/install.html#cryptography]]

- [[Gerrit + Jenkins StartUp: Gerrit + Jenkins StartUp- Install Gerrit>http://beta.mybetabook.com/showpage/4f56073e0cf2f3f0a3dd1876]]
-- 説明が分かりやすい。しかし情報が古くなっているのか、wget する URI などは既に存在しなくなっている。
- [[Narrow Escape gerritのインストール方法>http://www.hiroom2.com/2015/08/23/gerrit%E3%81%AE%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB%E6%96%B9%E6%B3%95/]]
-- Debian8 に Ubuntu package をインストールする方法の紹介