CentOS 7にLAMP環境を構築。GitBucketとJenkinsを動かし、自動ビルドや自動デプロイまでやってみます。

なぜGitBucketか

GitBucketはGitHubクローンで、似たものに有名なGitLabがあります。 GitLabも最近はrpmコマンド一発でインストールできるほど簡単になっていますが、今回はより簡単 (.warファイルを置くだけ) で、見た目や使い勝手もGtiHubに近いGitBucketを選びました。

概要

• ソースからのビルドは行わず、yumパッケージや.warファイルを使用
• Apacheのmod_proxy_ajpを使い、Tomcatへはポート8080ではなく80でアクセス
• GitBucketでリポジトリにpushがあったらJenkinsで自動ビルド
• Jenkinsのビルドでは、rsyscでApacheの公開ディレクトリに自動デプロイ
• 自動デプロイ時のユーザーはtomcatではなくapacheで行う

動作環境

CentOS 7のミラーサイト一覧で、日本のミラーから最新版をダウンロードしてください。 Vagrantで起ち上げた仮想マシンやDockerのコンテナでも構いませんが、一部読み替えたり、ポートマッピング等の追加設定が必要になります。

リポジトリの準備

デフォルトではパッケージが少なかったり古かったりするので、EPELとremiのリポジトリを追加します。

EPELリポジトリの追加

yum install -y epel-release

remiリポジトリの追加

rpm -ivh http://rpms.famillecollet.com/enterprise/remi-release-7.rpm

パッケージのインストールと起動設定

とりあえずは最新の状態にしておきます。

yum -y update

必須パッケージに加え、普段よく使うパッケージも入れておきます。

yum --enablerepo=epel,remi install -y sudo vim-enhanced syslog httpd httpd-devel php php-devel php-pear php-mysql php-gd php-mbstring php-pecl-imagick mariadb-server phpmyadmin wget git java-1.7.0-openjdk-devel tomcat

各種サービスを起動し、さらに再起動時にもサービスが有効になるように設定します。

CentOS 6まではservice(または/etc/rc.d/init.d/のスクリプト)とchkconfigコマンドを使用しましたが、CentOS 7ではsystemctlに変更されています。

systemctl enable --now httpd
systemctl enable --now tomcat
systemctl enable --now mariadb

サービスの状況は以下のコマンドで確認できます。

systemctl list-unit-files

GitBucketをインストール

先述の通り、.warファイルを置くだけの簡単インストールです。

https://github.com/gitbucket/gitbucket

releaseから最新版のgitbucket.warをダウンロードして、実行用のディレクトリにコピーします。

cp gitbucket.war /var/lib/tomcat/webapps/

Jenkinsをインストール

こちらも.warファイルを置くだけです。

りゅう

簡単でいいですね！

https://jenkins.io/

最新版のJava Web Archive (.war)をダウンロードして、以下のディレクトリにコピーします。

cp jenkins.war /var/lib/tomcat/webapps/

ここでTomcatを再起動しておきます。

systemctl restart tomcat

ファイアウォールの設定

CentOS 6まではiptablesを使用しましたが、CentOS 7ではfirewalldに変更されています。

firewall-cmd --add-port=80/tcp --permanent

Apacheのプロキシ設定

AJPというプロトコルによって、ApacheとTomcatの相互通信を行い、外部への配信はApacheが担当するようにします。

TomcatのAJP通信は、ポート8080ではなく8009を用います。

以下のファイルを作成します。

/etc/httpd/conf.d/gitbucket.conf

<Location /gitbucket>
    ProxyPass ajp://localhost:8009/gitbucket
</Location>

/etc/httpd/conf.d/jenkins.conf

<Location /jenkins>
    ProxyPass ajp://localhost:8009/jenkins
</Location>

ファイルを作成したら、Apacheを再起動しておきます。

systemctl restart httpd

アクセスしてみる

まずはGitBucketにアクセスしてみます。

http://[hostname]/gitbucket

• ユーザー名：root
• パスワード：root

ログイン後はrootのパスワードを変更し、新規ユーザーを作成しておきます。

次にJenkinsにアクセスしてみます。

http://[hostname]/jenkins

正常に起動し、アクセスできました。

Jenkinsにプラグインをインストールする

「Jenkinsの管理」→「プラグインの管理」→「利用可能」へと進みます。

フィルタに「git」と入力して、以下のプラグインを選択して「再起動後にインストール」します。

• Git Plugin
• GitBucket Plugin

必要なプラグインがインストールされますので、「インストール完了後、ジョブがなければJenkinsを再起動する」にチェックを入れて待ちましょう。

長時間インストールが終わらない場合、実は既に終っているのに表示に変化がないだけということもあります。

GitBucketとJenkinsの連携設定

GitBucketのリポジトリを作成し、pushがあった際にJenkinsで自動デプロイを行うよう設定します。

GitBucket の設定

画面右上のレンチ型アイコンから設定画面へ進み、「System Settings」を選択します。

GitBucketでリポジトリを作成する

「new repository」からリポジトリ名を入力、「Initialize this repository with a README」にチェックを入れて新規リポジトリを作成します。

これで、リポジトリのトップページに表示されるREADME.mdのみがInitial commitされた状態になります。

次にリポジトリの「Settings」→「Service Hooks」と進み、「WebHook URLs」を入力します。

http://[hostname]/jenkins/gitbucket-webhook/

GitBucket側での設定は、このWebHookのみです。

apacheユーザーでデプロイするための設定

普通にデプロイの設定をすると、ファイル群はtomcatユーザーのままデプロイされます。
これだとApache的に都合が悪い場合もあるため、デプロイをapacheユーザーで行うようにします。

そのためには、Jenkinsを動かしているtomcatユーザーが、sudo -u apacheできるようにしなければなりません。

visudo

▼ 変更前

Defaults    requiretty

▼ 変更後（コメントアウトする）

$ Defaults    requiretty

さらにtomcatユーザーがパスワード無しでsudoできるよう設定します。

以下の行を追加

tomcat  ALL=(ALL)       NOPASSWD: ALL

そして、デフォルトでは/var/www/htmlの所有者がrootになっており、このために自動デプロイが失敗するので、権限を変更しておきます。

chown -R apache. /var/www/html

Jenkinsの自動デプロイ用ジョブを作成

新規ジョブ作成から、ジョブ名を入力 (例：project01)、「フリースタイル・プロジェクトのビルド」を選択してOKをクリックします。

りゅう

GitBucketのリポジトリページからコピペできる項目が多いです。

最後に「ビルド手順の追加」から「シェルの実行」を選択し、下記シェルスクリプトを記入します。割とここが目玉です。

sudo -u apache rsync -vr --delete --exclude ".git/" /usr/share/tomcat/.jenkins/jobs/project01/workspace/ /var/www/html/project01/

動作確認

gitコマンド、またはお使いのGitクライアントから、ファイルに適当な修正を加えてコミット → プッシュしてみてください。

※尋ねられるアカウントは、GitBucketのユーザーアカウントです。

GitBucketでは、GitHub同様にコミット履歴が加わっていれば成功です。こちらはまず大丈夫でしょう。

Jenkinsでは、リポジトリに対応するジョブが実行されて、/var/www/html以下に自動デプロイが行われたことを確認できればOKです。

CentOS 6で構築する場合

CentOS 6でも同様に、まずyumのリポジトリとしてEPELとremiをインストールします。

Tomcat 7もインストールできるため、一部CentOS 7独特の部分 (systemctlやファイアウォール等) 以外はそのまま進められます。

しかしJenkinsのGit Pluginがエラーを吐きます。

りゅう

これはCentOS 6にyumでインストールしたGitのバージョンが、1.7.1等の古いバージョンだからです。

解決するためには、最新のソースからGitをインストールすることです。

古いGitを削除

yum remove -y git

必要になるパッケージをあらかじめインストール

yum install -y curl-devel expat-devel gettext-devel openssl-devel zlib-devel

新しいGitのソースファイルをダウンロード

wget https://git-core.googlecode.com/files/git-1.9.0.tar.gz

解凍してインストール

tar zxf git-1.9.0.tar.gz
cd git-1.9.0
./configure --prefix=/usr/local/
make
make install

もし/usr/local/binにPATHが通っていなければ、下記のように.bash_profileに追加しておいてください。

.bash_profile

PATH=$PATH:/usr/local/bin

export PATH

そして上記変更を適用します。

source ~/.bash_profile

一応Gitのバージョンを確認しておきましょう。

git --version

これでJenkinsもエラーを吐くこと無く動作するはずです。

CentOS 7で採用されたApache 2.4の設定は従来とかなり変わっており、そのせいで戸惑うこともあるかと思いますので、馴染めない方は、少々面倒ですが上記の方法でCentOS 6上で構築してみるのも良いかと思います。

CentOS 6の開発環境を一発で構築するスクリプトを公開しました。NetBeansやRedmineも紹介します。

GitHubのリポジトリ

https://github.com/ryu-blacknd/bootstrap

りゅう

気が向いた時に更新するかもしれません。

想定している開発フロー

1. Redmineでプロジェクト管理
2. NetBeansで開発
3. ローカルのGitリポジトリでコミット
4. リモートのベアリポジトリへプッシュ(Redmineが参照するのはココ)
5. 本番環境リポジトリ(/var/www/html以下)で自動プル

スクリプトの概要

• セキュリティ関係の設定(ローカル開発環境なので甘々に設定)
• yumのリポジトリを追加(epel, remi)
• yum updateと、必要なパッケージのインストール
• 不要なサービスの停止
• LAMP環境のインストールと最低限の設定
• RubyとPassenger周りのインストール
• Gitユーザーの作成と関連する設定
• phpMyAdminのインストール
• Redmine本体、テーマ、プラグインをインストール
• おまけ：ベアリポジトリ用フックスクリプトの雛形

詳細は、シェルスクリプトを読んでみてください。たいしてトリッキーなことはしていません。

動作環境

• LAN内のサーバPC、またはVirtualBox等の仮想マシン(Vagrant可)
• CentOS6 x86/64 minimal isoイメージでのインストール直後であること

インストール

rootでログインし、gitをインストール後、取得したbootstrap.shを実行するだけです。

yum -y install git
cd
git clone https://github.com/ryu-blacknd/bootstrap.git
chmod +x bootstrap/bootstrap.sh
bootstrap/bootstrap.sh

ほぼノンストップで進みますが、Passengerのインストール時のみ画面に表示される通りEnterを押して進んでください。

※2013.10.16 追記：Passengerインストール時にEnterを自動入力することで、ノンストップになりました。

インストール後はシステムを再起動します。

reboot

開発に関する情報

*1 NetBeansでのプッシュ先リポジトリ = Redmineでの参照リポジトリ

*2 開発ユーザー毎にSSH公開鍵を作成し、このファイルに追記していく(後述)

初回の開発フロー

初回のみGit絡みで面倒ですが、以下のフローが済めば、以降は自動化され楽になります。

1. [サーバ] ユーザーgituserでSSHログイン
2. [サーバ] /var/repos/[プロジェクト名]を作成し、ディレクトリ内でgit init --bare
3. [ローカル] NetBeansでローカルのリポジトリにファーストコミット
4. [ローカル] NetBeansから先ほど作成したベアリポジトリにプッシュ
5. [ローカル] Redmineで新規プロジェクトを作成、リポジトリを設定、ユーザー割り当て
6. [サーバ] cd /var/www/htmlしてgit clone /var/repos/[プロジェクト名]
7. [サーバ] /var/repos/[プロジェクト名]/.git/hooks/にpost-updateをコピーして編集

post-updateファイルはユーザーrootのホームディレクトリにあるため、gituserはアクセスできません。

chown gituser. post-update

としておき、gituserのホームディレクトリにでもコピーしておくとよいでしょう。

post-updateのコピーと編集

フックスクリプトpost-updateは、プロジェクトを作成する毎に手動でコピー、****の部分を編集します。

#!/bin/sh
/usr/bin/wget -q -O /dev/null http://localhost/redmine/sys/fetch_changesets?key=****
(cd /var/www/html/**** && git --git-dir=.git pull)

2行目は、Redmineの 管理 → 設定 → リポジトリ で生成したAPIキーを記述します。

3行目は、上記手順のプロジェクト名(=リポジトリのディレクトリ名)を記述します。

これで冒頭に書いたようなフローの準備が整いました。

以後はNetBeansで、ローカルコミットとベアリポジトリへのプッシュを繰り返して開発を進めます。

コミット・メッセージでチケットの状態を更新する

NetBeansからのコミット時は、コミット・メッセージの文末にrefs #1 @1.5h等を付与すると、Redmineのチケットと連携することができます。

このとき、作成者とコミッタをRedmineのユーザー名に合わせるようにしてください。

上記ユーザー名がRedmine側と一致しない場合は、チケット連携が正常に行われません。その場合はプロジェクト毎の 設定 → リポジトリ から、ユーザーの関連付けを行ってください。

※詳しくはこちらを参照してください。

http://blog.redmine.jp/articles/new-feature-1_1/automatic-spent-time-logging/

リポジトリへのアクセスにSSH鍵認証を利用する

ユーザー毎のSSH公開鍵をユーザーgituserのauthorized_keysに追記していきます。

以下の手順でSSH公開鍵と秘密鍵のペアを生成します。

ssh-keygen -C user@example.com

なお、この鍵ペアを外部サーバへの接続用途に使わないのであれば、パスフレーズは無視して構いません。

これでユーザーのホームディレクトリに2つの鍵ファイルが作成されます。

この公開鍵をサーバ管理者に渡し、管理者はgituserユーザーで~/.ssh/authorized_keysに追記します。

cd ~/.ssh
cat id_rsa.pub >> authorized_keys

次にNetBeans側で、「秘密鍵ファイル」に上記の秘密鍵ファイルを指定すれば、リポジトリにアクセスすることができるようになります。