VisualStudioでビルドしてメール通知するJenkinsの環境をDockerで楽に作る

目的など

• 普段はTeamCityを使っていてJenkinsがどんなものか知りたかったというモチベーションです。
• ビルド → テストとコードチェック → メール配信をします。
• 自分のwindowsでひとまずやって、後できれいに消したいです。
• C++用です。CppUTest, ReSharper。
• ここに晒すことで諸先輩方の指摘を頂けたら嬉しいです。

関連する記事はこちら↓です。

システムの構成

• windows(の中のwsl2)がDockerのホストです。
• DockerコンテナとしてJenkinsを構築します。
• DockerのホストであるwindowsはJenkinsのエージェントを兼任します。
• レポジトリもある。以前の記事の↓を使います。テストコードがあるので。

Dockerのホスト（そしてJenkinsのエージェント）になるwindowsの前提

• Docker Desktop WSL2 バックエンドをインストールしてある。

• Visual Studio（使いたいビルド環境）がインストールしてある。

Jenkinsの起動

公式のdocker imageを使います。

ドキュメントを見るとBlue Oceanプラグインを入れたくなりますが、罠なので避けます。

powershellで以下を実行します。

docker pull jenkins/jenkins:lts-jdk11

dockerコンテナを起動します。データはホスト側に持つようにマウント(-v)します。
ブラウザーからのアクセスとエージェントとの接続のためにポートフォワード(-p)します。

docker run -p 8080:8080 -p 50000:50000 -v jenkins_home:/var/jenkins_home jenkins/jenkins:lts-jdk11

こんなのが出てくるのでパスワードをとっておきます。

*************************************************************
*************************************************************
*************************************************************

Jenkins initial setup is required. An admin user has been created and a password generated.
Please use the following password to proceed to installation:

「本当はここにパスワードの文字列が入っています。後で使います。」

This may also be found at: /var/jenkins_home/secrets/initialAdminPassword

*************************************************************
*************************************************************
*************************************************************

ブラウザでコンテナにアクセスします。↓のアドレスをアドレスバーに入力します。

http://localhost:8080

下の画面になるので先ほどのパスワードを入れます。

Install suggested plugins を選びます。

あとは指示通り。

そのまま。

(脱線)JDKについて

dockerimageは無印(docker pull jenkins/jenkins)だとサポート期限切れのjdk8になり、jenkins上でも警告が出るのでjdk11を選びました。
ちなみにJDKというとライセンスが気になりますが、このイメージに入っていたのはAdoptOpenJDKだった商用利用も無償で可能です。

バージョン確認の結果です。

$ java -version
openjdk version "11.0.11" 2021-04-20
OpenJDK Runtime Environment AdoptOpenJDK-11.0.11+9 (build 11.0.11+9)
OpenJDK 64-Bit Server VM AdoptOpenJDK-11.0.11+9 (build 11.0.11+9, mixed mode)

エージェントの準備

本題に戻ります。

処理を実行するのがエージェントです。
この画面から始まるのでエージェントを設定します。

Permanent Agentを選びます。

executorsはコアのスレッド数に増やして、作業用のフォルダを指定しました。後はデフォルトにしました。

まだこんな感じなので、さっき作ったwindows11を選びます。

agent.jarをエージェントでダウンロードします。
ダウンロードしたフォルダに移動し。赤丸のコマンドを実行します。

こんな風に待機中が並びます。

今度はmasterのほうを選び、Number of executersを0（つまりエージェントとして動かない）にします。
すると右上にあった警告マークが消えます。

SMTPサーバーの準備

gmailのsmtpを使う手もメジャーですが、

Dockerを使える状況ならcatatnight/postfixを利用するのも楽です。

Windowsに戻りpowershellで以下を実行します。

docker pull catatnight/postfix

PowerShellの場合はLinuxと違い、改行のエスケープが「`」なのが注意点です。
パラメータはこの例のまま行きます。あとで使います。

docker run -d -p 25:25 `
  --name mailserver `
  -e maildomain=example.com `
  -e smtp_user=username:password `
  catatnight/postfix

システムの設定

Jenkinsの管理 > システムの設定

「Jenkinsの位置」で、URLは「ホストのIPアドレス:8080」にします。
システム管理者のメールアドレスは通知が来たときに見てわかるように設定します。

設定保存後に↓のように「リバースプロキシがおかしいようです。」と警告が出るようになると思います。
先ほど設定した「ホストのIPアドレス:8080」でJenkinsにアクセスしなおしてください。

拡張E-mail通知で、「ホストのIPアドレス」、SMTPサーバーに設定したユーザー名、パスワード、ポート(25)を設定します。
高度な設定を開く必要があります。

他の設定はこんな感じです。

宛先がgmailだと迷惑メールに届きます。

続きはこちら↓です。