留意事項
本手順を実施する場合は、次のように読み替えること.
・アカウント名の「robozushi10」を各ユーザのアカウントにする
・ホストIP「192.168.10.115」を各ユーザの IP やホスト名にする
概要
次の構成の Jenkins on Docker のセットアップ手順である.
一度構築すれば、他のホスト上でも一部書き換えるだけ※ でセットアップができる.
(※ ホストIP の書き換えのみ)
| 役割 | ホスト側ポート | コンテナ側ポート | 補足 |
|---|---|---|---|
| Jenkins Master | 43080 | 43080 | |
| Jenkins Slave(1) | - | - | Docker on Docker 可能である |
手順
1. 素の Jenkins on Docker を起動させる
1. docker-compose.yml を作成する.
version: "3"
services:
jenkinsmaster:
container_name: myjenkinsmaster
user: root
image: jenkins/jenkins:latest
environment:
- JENKINS_OPTS="--httpPort=43080"
ports:
- 43080:43080
- 43000:43000
volumes:
- ./PV/jenkinsmaster/jenkins_home:/var/jenkins_home
jenkinsslave1:
container_name: myjenkinsslave1
user: root
image: jenkinsci/slave
volumes:
- ./PV/jenkinsslave1:/home/jenkins
- /var/run/docker.sock:/var/run/docker.sock
- /usr/bin/docker:/usr/bin/docker:ro
command: /bin/bash -c 'java -jar /home/jenkins/agent.jar -jnlpUrl http://jenkinsmaster:43080/computer/slave1-local/jenkins-agent.jnlp -secret @/home/jenkins/secret-file -workDir "/home/jenkins"'
2. docker-compose up -d を実行する
$ docker-compose ps
Name Command State Ports
----------------------------------------------------------------------------------------------------------------------------------
myjenkinsmaster /sbin/tini -- /usr/local/b ... Up 0.0.0.0:43000->43000/tcp, 0.0.0.0:43080->43080/tcp, 50000/tcp, 8080/tcp
myjenkinsslave1 /bin/bash -c java -jar /ho ... Up
2. WEB-UI で localhost:43080 にログインする
1. 初期ログインパスワードを入手する
$ docker-compose exec jenkinsmaster bash -c 'cat /var/jenkins_home/secrets/initialAdminPassword'
87e4804b07124cbf934d3c9346378de2
2. 推奨プラグインをインストールする
300MB ほどディスクを喰うが仕方ない.
3. 管理者アカウントを作成する
「Create First Admin User」で管理者アカウントを作る.
今回は次のアカウントを作成した.
アカウント ... root
パスワード ... rootroot
3. 開発用アカウントを作成する
1. アカウント作成
http://localhost:43080/securityRealm/addUser にアクセスして開発用アカウントを作成する.
今回は次のアカウントを作成した.
アカウント ... robozushi10
パスワード ... robozushi10
2. APIキーを作成する
下記にアクセスして「APIトークン」を「生成」してから「保存」する.
http://localhost:43080/user/robozushi10/configure
「APIトークン」生成したら控えておくこと.
115055bf04f7f0508abacc987625165188
4. Jenkins Master の設定をする
1. Jenkins URL を設定する
「Jenkinsの管理」→「システムの設定」より、
ホストの IPアドレス「192.168.10.115」を設定する.
5. 新規ノード「slave1-local」を立ち上げる
1. 「slave1-local」を作成する
http://localhost:43080/computer/new にアクセスして、ノード名で「slave1-local」でノードを作成する.
このとき次のようにする.
| 項目 | 値 | 補足 |
|---|---|---|
| リモートFSルート | 「/home/jenkins」と入力する | docker-compose.yml での volumes と合わせている |
| ラベル | 「slave1」と入力する | |
| 用途 | 「このマシンを特定ジョブ専用にする」を選択する | |
| 起動方法 | 「Launch agent by connecting it to the master」を選択する |
2. 「slave1-local」のパラメータを控えておく
作成したノード「slave1-local」の状態確認ページ(下記) を開いて起動パラメータを控える.
http://localhost:43080/computer/slave1-local/
次のような情報が表示されているので控えておく.
echo 93d7204e5036a10274696a371cb5531747056ec637d50b1aa7691217e8a5ee9b > secret-file
java -jar agent.jar -jnlpUrl http://localhost:43080/computer/slave1-local/jenkins-agent.jnlp -secret @secret-file -workDir "/home/jenkins"
3. Agents のポート番号を 43080 へと変更する
下記「グローバルセキュリティの設定」より、
「Agents」のポート番号を「50000」から「43000」へと変更する.
http://localhost:43080/configureSecurity/
4. ホストで次を実行する
上記 2 で表示されたシークレットを、./PV/jenkinsslave1/secret-file として書き出す.
$ cat <<'EOL' | sudo tee PV/jenkinsslave1/secret-file
93d7204e5036a10274696a371cb5531747056ec637d50b1aa7691217e8a5ee9b
EOL
5. Slave上に agent.jar を配置する
ホストで次の操作をして ./PV/jenkinsslave1/agent.jar として配置する.
$ sudo wget http://localhost:43080/jnlpJars/agent.jar -O PV/jenkinsslave1/agent.jar
6. Jenkins を再起動させる
$ sudo docker-compose restart
以上.
デバッグ
Master と Slave が繋がらない場合
ホストで次のように実行して接続可能かチェックをすれば良い.
$ java -jar PV/jenkinsslave1/agent.jar -jnlpUrl http://localhost:43080/computer/slave1-local/jenkins-agent.jnlp -secret 93d7204e5036a10274696a371cb5531747056ec637d50b1aa7691217e8a5ee9b
参考サイト
| URL |
|---|
| https://www.slideshare.net/miyajan/jenkins-61133952 |
| https://qiita.com/sugiyasu-qr/items/85a1bedb6458d4573407 |
| ［改訂第3版］Jenkins実践入門 |