Vagrant環境のDockerでJenkinsサーバを構築し、スレーブのWindowsマシンを接続する(前半)

イントロ

以前自分のWikiに「Dockerサーバに、Jenkinsサーバを構築する」って記事を書いたのですが、そのときはdocker run ... って多少チマチマと構築してましたが、今回は同じ環境を docker-compose で作成します。
そして、Jenkinsサーバを構築したのち、スレーブとなるWindowsPCをそのJenkinsにぶらさげて、JenkinsからそのWindowsマシンに何か処理をさせてみようとおもいます。

あ、一応 UiPathをリモート実行出来るかな？？ってのを調査するための環境構築という位置づけです。¹
ちなみに UiPath社は「スケジューラなどからの定期起動はライセンスポリシー違反」としていますので、実運用へ適用する際はライセンス的に問題ないかキチンとご確認ください。

UiPath社がだしている UiPath Robots の外部トリガーによる実行についてによると「直接のユーザ操作によらない起動はNG」と書いてありますが「スケジューラを用いた直接ユーザ操作による起動はサポート外だが実施してよい」 みたいなので、Jenkinsからの実行自体は問題がなさそうですね。

作成する環境

• 1つのVagrantfileで Jenkinsサーバを立ち上げます。
• Vagrantfileでは、Ubuntu Linux 上にDockerサーバを構築し、Docker上にJenkinsサーバを立ち上げます。
• リアルのネットワークに「スレーブにしたいWindowsPC」が存在していて、それをJenkinsにスレーブとして設定します。

図にすると、こんな感じです。

ちなみに今回作業する環境は下記の通り。

$ sw_vers
ProductName:    Mac OS X
ProductVersion: 10.14.6
BuildVersion:   18G84
$
$ vagrant --version
Vagrant 2.0.4
$

Microsoft Windows [Version 10.0.17763.615]
(c) 2018 Microsoft Corporation. All rights reserved.

C:\>ver

Microsoft Windows [Version 10.0.17763.615]

C:\>java -version
java version "1.8.0_221"
Java(TM) SE Runtime Environment (build 1.8.0_221-b11)
Java HotSpot(TM) Client VM (build 25.221-b11, mixed mode)

UiPathのバージョンは、2018.4.5 でした。

コードの取得、Jenkinsサーバの構築

使用するファイル群をGitHubから取得します。

$ git clone --branch feature/for_qiita_jenkins https://github.com/masatomix/environment_template.git
$ cd environment_template/
$ vagrant up

と実行することで、Ubuntu Linuxの構築から Dockerのインストール、Dockerサーバ上でのJenkinsサーバのインストールまでが行われます。
環境が構築できたら、http://localhost:8888/jenkins/²へアクセスしてください。何か画面が出てきたらOKです。

初回アクセス時に Administrator password を入れろと出ますが、vagrant ssh でJenkinsが稼働するLinuxサーバにログインし、

$ vagrant ssh
vagrant@ubuntu-xenial:~$ cat /vagrant/jenkins/jenkins_home/secrets/initialAdminPassword
744a5ab5c95f4b438ecd2ac7cb74b960

で表示される値を入れればOKです。

Continueをクリックすると、初回に入れたいプラグインを指定する画面となりますが、とりあえず左を選択します。

インストールが始まりました。

完了したら、アカウント作成画面が表示されるので、、、適当に入力。

URLもデフォルトでよいでしょう。「Save and Finish」をクリックして、、

完了です。

トップページが表示されました！

docker-compose.yml はこちら

vagrant up が実行されると、Ubuntu Linux上のDockerで、下記の docker-compose.yml が実行されてJenkinsが構築されます。

version: '3.5'
services:
  jenkins-master:
    image: jenkins/jenkins:${VERSION}
    environment:
      - JENKINS_OPTS= --prefix=/jenkins
    ports:
      - 8080:8080
      - 50000:50000
    volumes:
      - ./jenkins_home:/var/jenkins_home
    restart: always

VERSION=2.187-centos

Jenkinsを立ち上げるだけなので、シンプルですね。Jenkinsの構築は完了です。

さて次の記事で、スレーブにしたいWindowsPC を設定していきましょう。

おつかれさまでした。

関連リンク

• Vagrant環境のDockerでJenkinsサーバを構築し、スレーブのWindowsマシンを接続する(後半)
• UiPath Robots の外部トリガーによる実行について
• GitHub
• Jenkins Continuous Integration and Delivery server