DevelopTool/CI/Jenkins の履歴(No.30)

• 履歴一覧
• 差分 を表示
• 現在との差分 を表示
• ソース を表示
• DevelopTool/CI/Jenkins へ行く。
  • 1 (2009-07-31 (金) 07:52:14)
  • 2 (2015-01-07 (水) 01:13:09)
  • 3 (2015-02-05 (木) 08:14:26)
  • 4 (2015-02-06 (金) 10:17:54)
  • 5 (2015-02-17 (火) 05:55:14)
  • 6 (2015-02-18 (水) 06:48:30)
  • 7 (2015-02-23 (月) 06:08:21)
  • 8 (2015-03-10 (火) 02:19:37)
  • 9 (2015-03-16 (月) 02:44:55)
  • 10 (2015-03-30 (月) 05:36:52)
  • 11 (2015-04-03 (金) 02:37:51)
  • 12 (2015-04-06 (月) 02:24:12)
  • 13 (2015-04-08 (水) 00:34:14)
  • 14 (2015-04-13 (月) 05:02:18)
  • 15 (2015-04-14 (火) 04:19:26)
  • 16 (2015-04-23 (木) 00:32:58)
  • 17 (2015-04-24 (金) 01:27:14)
  • 18 (2015-05-01 (金) 02:48:36)
  • 19 (2015-05-01 (金) 05:41:02)
  • 20 (2015-05-11 (月) 01:14:59)
  • 21 (2015-05-11 (月) 10:39:13)
  • 22 (2015-05-19 (火) 11:52:17)
  • 23 (2015-05-20 (水) 01:10:18)
  • 24 (2015-07-27 (月) 01:30:50)
  • 25 (2015-09-27 (日) 12:46:07)
  • 26 (2016-01-21 (木) 18:34:06)
  • 27 (2016-01-22 (金) 16:32:25)
  • 28 (2016-02-18 (木) 14:39:40)
  • 29 (2017-06-05 (月) 15:06:36)
  • 30 (2017-06-06 (火) 12:23:47)
  • 31 (2017-06-07 (水) 02:33:51)
  • 32 (2018-10-25 (木) 07:52:41)
  • 33 (2019-08-12 (月) 15:33:57)
  • 34 (2021-02-03 (水) 08:08:00)

---

• Javaで作られたCIツール。昔はHudsonといった。

rpmインストール†

yumもあるけど、実際には一つのrpmっぽいので下記より取得。

http://pkg.jenkins-ci.org/redhat/

コンテキストパスの変更†

--prefix=/jenkins

設定値†

/etc/sysconfig/jenkinsに記載がある

warインストール†

warを配置するだけ。単体でも動く

環境変数やJavaプロパティの確認†

http://example.com/jenkins/systemInfo

CSSやJSなどの場所†

webapps以下のxxxフォルダがhttp://JENKINS_SERVER/jenkins/static/ランダム文字列/xxxとして読み込まれる。ここを直接書き換えて再起動すれば反映される。

起動†

単体で起動†

java -jar jenkins.war

• http://localhost:8080/でアクセスする。そうするとホームディレクトリの.jenkinsに展開される。JENKINS_HOMEを指定するとそこを見るようだ。

サーブレットコンテナ利用†

• warを置くだけ

Apache連携†

/etc/httpd/conf.dに以下のファイルをajp.confとして配置

ProxyRequests     Off
ProxyPass         /jenkins  ajp://localhost:8009/jenkins
ProxyPassReverse  /jenkins  ajp://localhost:8009/jenkins

Plugin install†

• jpiファイルをJENKINS_HOME/pluginsディレクトリに配置しておき再起動

マスター、スレーブ構成†

マスターにだけwarインストールして、スレーブはslave.jarを立ち上げておきSSH接続する。

ディレクトリ構成†

Jobのホームディレクトリ†

HUDSON_HOME/jobs/各ジョブの名前_DIR

Jobsのホームディレクトリ以下の構成†

ファイル†

• config.xml

設定内容

ソース置き場†

• CVSやSVNから取ってきたソースの置き場は各JOB共通のようだ。

ディレクトリ†

• workspace

ビルドしたものが配置される。

Manage and Assign Roles 設定†

Role Strategy Pluginを利用して、不必要なJOBを隠す。

Global roles†

プロジェクト単位のユーザーには全体のRead以外の権限はつけない。Readの権限を付けないと「アクセスできませんxxxには、全体/Read パーミッションがありません。」となるのでReadの権限は最低必要。ViewのRead権限をつけるとタブが全部見えるが、中身のプロジェクトはProject rolesで定義されたものしか見えないので、ViewのRead権限は不要だろう。

Project Roles†

Jobを正規表現で指定して、その単位で権限制御できる。これ単体ではログインしても何も見れないので、全体Viewの権限＋プロジェクトの権限を各ユーザーにアサインする。プロジェクトのメンバーには閲覧＋ビルドのみ。プロジェクトの管理者にはジョブとビルドのすべての権限を付与しておくとよいだろう。

Assign role†

前述のように全体Readのグローバル権限＋プロジェクト単位の権限を二つ付与する必要がある。新規作成ユーザーは何も見れないので権限の作りすぎも要注意である。

リモートからJOB実行†

設定画面でトークンを設定して、指定通りのＵＲＬをたたくと外部からＪＯＢを実施できる。

CUIツール†

Hudson 1.302から、HudsonにはCLIが追加。hudson-cli.jarというものを実行する

CUIツールの入手†

起動しているhudsonからダウンロードする。

http://hudsonURL/cli

実行†

バージョン情報取得†

java -jar hudson-cli.jar -s http://127.0.0.1:8080/ version

コピー実行†

java -jar hudson-cli.jar -s http://127.0.0.1:8080/ copy-job コピー元 コピー先

逆引き†

複数選択のパラメータを渡したい†

パラメータでテキストを用意しておくと、複数のパラメータがスペース区切りで出力される。

• 出力例

JOB1 JOB2 JOB3 JOB4

各ジョブで使うパラメータを外部ファイルで共通化したい†

Extended Choice Parameter pluginかExtensible Choice Parameter pluginを使う。名前が似ているが、よりダウンロード数の多いExtended Choice Parameter pluginを使ってみた。

Extended Choice Parameter plugin†

設定でファイルからの読み込みやデリミタ―を指定してのパラメータ文字列を指定できる。複数選択パラメータも可能(A,B,Cのように出てくる）。複数JOB共通で使いたい場合はファイルにしておく。

• properitesファイルの例

param1=hoge,fuga,piyo
param2=db1,db2,db3

下流ジョブの実行完了を待って、後続ジョブを実施したい→JOIN Plugin†

ただしJOINPluginが実行完了を待つのはビルド後のJOBに限る。

プラグイン†

Role Based Pluginの説明（有効にするには設定画面変更必要）

http://techracho.bpsinc.jp/morimorihoge/2013_09_12/13642

• 以下はおまけ系

build flow plugin 研究†

• 並行制御は下流ジョブの終了までは考慮しない。各並行の中に下流ジョブを定義する
• if文などが使える

// パラメータの表示
out.println params
// if
if (params["TARGET_BRANCH"] == "master") {
  out.println "TARGET_BARNCH is master"
} else {
  out.println "TARGET_BARNCH is not master"  
}
join = parallel ([
       first:  { build("job1", param1: "passed by build flow", TARGET_BRANCH: params.TARGET_BRANCH) },
       second: { build("job2") },
       third:  { build("job3") }
])
out.println join.first.result.name
// job4 will be triggered after jobs 1, 2 and 3 complete
build("job4")

設定ファイル(config.xml)を直接変更†

たくさんのjobを扱う場合ブラウザ経由で操作するとめんどくさい。イレギュラーではあるが設定ファイルやディレクトリを直接変更した場合の反映方法をまとめた

JOBコピー†

初期状態ではユーザホームディレクトリに.hudsonというディレクトリができる。ここのjobsディレクトリにjob毎にディレクトリができているのでこいつをコピーする。

JOBバックアップ†

バックアップするプラグインもあるが、他サーバーにJOBを移行したい場合にはjobs/ジョブ名/config.xmlをtarで固める。

cd $JENKINS_HOME
find jobs/ -name "config.xml" -print0 | tar -cvz -T - --null -f /var/tmp/jenkinsjobs.tar.gz

findとtarの間にxargsを使ってしまうと、アーカイブするファイル数が多い場合に tarが複数回起動されてしまい、すべてのファイルが含まれたアーカイブファイルを作れない。

設定変更†

各ジョブのディレクトリに入りconfig.xmlを変更する。

設定反映†

そのままではhudsonのメモリ上にあるものが使われてしまう。故に強制的にファイルシステムから再読み込みさせる。これはメニューに用意されている。

[hudsonの管理]から[設定の再読み込み]を実行する。

デバッグテクニックなど†

主な環境変数†

トラブルシューティング†

ピン止めされたプラグイン†

このバージョンのJenkinsでは、プラグインマネージャーでピンが設定されている次のプラグインがインストールされています。ピンが設定されているプラグインを、少なくともJenkinsにバンドルされているバージョンにアップデートすることを推奨します。

Jenkins標準のプラグインはJenkins本体をアップデートしたときに合わせてアップデートされるが、バージョンを固定したい時がある。その場合に上記メッセージが出る。

[No valid crumb was included in the request]†

この場合、トークンチェックに引っかかっているようだ。 正常な遷移にもかかわらず出てしまう場合がある。 その場合「Jenkinsの管理」→「グローバルセキュリティの設定」の画面を開き CSRF対策をOFFにすることで回避できる。