動機

Kubernetesは便利だけれど結構作り直したり、マルチクラスタ管理してるので、Jenkinsはクラスタの外に立ててる。ローカルの開発環境を作っておくと、捗る。

準備

Install Docker-Desktop

公式からインストーラーに従ってインストールする。
https://www.docker.com/products/docker-desktop

インストールしたら、設定→KubernetesからKubernetesを有効にする。

Install Java

Javaが入っていない人は、Javaから入れる。
ちなみに、いきなりJenkinsから入れようとしたら、まずはJavaをインストールしなよってインストールコマンド教えてくれた。親切。

$ brew cask install homebrew/cask-versions/adoptopenjdk8

Install Jenkins

$ brew install jenkins

Change listening port

デフォルトだと、localhostからしかアクセスできないので、Kubernetes上のPodからアクセスできるようにする。listenしてるアドレスを、0.0.0.0に変えるだけです。
この変更を行うと、同じネットワーク上の任意のマシンからアクセスが可能になるので、Jenkins adminのパスワード管理はしっかりしましょう。

$ sudo vi /usr/local/opt/jenkins/homebrew.mxcl.jenkins.plist
17c17
<       <string>--httpListenAddress=127.0.0.1</string>
---
>       <string>--httpListenAddress=0.0.0.0</string>

Initialize Jenkins

$ brew services start jenkins

Jenkins立ち上げたら、http://localhost:8080 をブラウザで開き、初期化パスワードを入力して、オススメのPluginsをインストールする。

5分ほどかかるので、小休止する。

余談

今後、困ったらとりあえず再起動する http://localhost:8080/safeRestart

Jenkinsがハングしたとしても、落ち着いてサービスを再起動する

$ brew services restart jenkins

Integrate with a Kubernetes

Permit Agent → Jenkins Master

特に理由がなければ、Randomで大丈夫です。
http://localhost:8080/configureSecurity/

Install Kubernetes plugin

kubernetes何ちゃら等々ヒットすると思いますが、そのものズバリkubernetesってのをインストールしてください。
http://localhost:8080/pluginManager/available

Configure Kubernetes info

一番下に、クラウドの追加というボタンが増えていると思うので、そこからKubernetesを選択する。
http://localhost:8080/configure

ひとまず、下記の３つを埋めておけば良いです。

Kubernetes URL

$ kubectl config view --flatten -o jsonpath='{.clusters[?(@.name=="docker-desktop")].cluster.server}'
https://127.0.0.1:6443

もしくは

$ kubectl config view --flatten -o jsonpath='{.clusters[?(@.name=="docker-for-desktop-cluster")].cluster.server}'
https://127.0.0.1:6443

Kubernetes server certificate key

$ kubectl config view --flatten -o jsonpath='{.users[?(@.name=="docker-desktop")].user.client-certificate-data}' | base64 --decode
-----BEGIN CERTIFICATE-----
xxx
xxx
xxx
-----END CERTIFICATE-----

もしくは

$ kubectl exec -it kube-apiserver-docker-for-desktop -n kube-system -- cat /run/config/pki/ca.crt
-----BEGIN CERTIFICATE-----
xxx
xxx
xxx
-----END CERTIFICATE-----

Jenkins URL

127.0.0.1だと、KubernetesのPodからJenkins Masterに繋ぎこみができなくなるので注意。

$ ip addr show en0

お疲れ様です、準備完了です。
小休止する。

テスト

Kubernetes pluginのgithubに、いくつかサンプルがあるので、適当に選んで実行する。
https://github.com/jenkinsci/kubernetes-plugin/tree/master/examples

新規ジョブを、Pipelineとして作成する。
http://localhost:8080/view/all/newJob

Scriptに下記のコードをコピペする。

pipeline {
  agent {
    kubernetes {
      //cloud 'kubernetes'
      label 'mypod'
      yaml """
apiVersion: v1
kind: Pod
spec:
  containers:
  - name: maven
    image: maven:3.3.9-jdk-8-alpine
    command: ['cat']
    tty: true
"""
    }
  }
  stages {
    stage('Run maven') {
      steps {
        container('maven') {
          sh 'mvn -version'
        }
      }
    }
  }
}

初回実行時は、maven imageのダウンロード等で多少時間がかかりますが、２回目以降はすぐ終わりますのでご安心を。

成功した場合は、このような出力になるはずです。

Started by user takitake.job@gmail.com
Running in Durability level: MAX_SURVIVABILITY
[Pipeline] Start of Pipeline
[Pipeline] podTemplate
[Pipeline] {
[Pipeline] node
Still waiting to schedule task
‘mypod-br97w-6pr07’ is offline
Agent mypod-br97w-6pr07 is provisioned from template Kubernetes Pod Template
Agent specification [Kubernetes Pod Template] (mypod): 
yaml:

apiVersion: v1
kind: Pod
spec:
  containers:
  - name: maven
    image: maven:3.3.9-jdk-8-alpine
    command: ['cat']
    tty: true


Running on mypod-br97w-6pr07 in /home/jenkins/workspace/maven
[Pipeline] {
[Pipeline] stage
[Pipeline] { (Run maven)
[Pipeline] container
[Pipeline] {
[Pipeline] sh
+ mvn -version
Apache Maven 3.3.9 (bb52d8502b132ec0a5a3f4c09453c07478323dc5; 2015-11-10T16:41:47+00:00)
Maven home: /usr/share/maven
Java version: 1.8.0_121, vendor: Oracle Corporation
Java home: /usr/lib/jvm/java-1.8-openjdk/jre
Default locale: en_US, platform encoding: UTF-8
OS name: "linux", version: "4.9.125-linuxkit", arch: "amd64", family: "unix"
[Pipeline] }
[Pipeline] // container
[Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // node
[Pipeline] }
[Pipeline] // podTemplate
[Pipeline] End of Pipeline
Finished: SUCCESS

失敗した場合は、ログを見てみましょう。
エラーメッセージでググれば、大抵は解決方法が見つかります。
http://localhost:8080/log/all

終わりに

Kubernetesクラスタを作り直した場合やPCを再起動した場合に、KubernetesやJenkinsのIPが変わることがあるので、その都度更新する必要があるのが玉に瑕ですが、やはりローカルで試せるとフィードバックサイクルが圧倒的に早いのでお試しくださいませ。