## 前言

1. 本實踐中已經的示例程式碼及jenkins-agent映象已經推送歸檔至github，[-->傳送門](https://github.com/Kubernetes-Best-Pratice/)
2. 注意本實踐中均為內網資料，你測試時一定要改為自己的環境的有效資料。
3. 由於本實踐涉及元件較多，若有操作不明確的話，你可以後臺留言，我們一起完善。
4. 具體操作時若有不清楚，或是錯誤可以留言，大家一起解決。

### 1. 準備基礎資料

1.配置gitlab

- 建立專案
- 上傳示例程式碼

_注_: 本次示例使用的gitlab專案地址為：`http://gitlab.hanker.com/colynn/hanker-hello.git`

2.配置harbor

- 建立專案, 用於儲存構建的映象
  _注_: 本次示例使用的harbor地址為 `10.0.0.185:5000/hanker/hanker-hello:v1`

3.jenkins 驗證資訊

- 新增 gitlab 帳號資訊

_操作指引_：【Credentials】-> 【System】-> 【Global credentials】-> 【Add Credentials】

![](http://img.blog.itpub.net/blog/2019/10/24/604130086c8d260a.jpeg?x-oss-process=style/bb)

- harbor 資訊

_操作指引_：【Credentials】-> 【System】-> 【Global credentials】-> 【Add Credentials】

![](http://img.blog.itpub.net/blog/2019/10/24/08400963dddbe478.jpeg?x-oss-process=style/bb)

- k8s namespace驗證資訊

在你的k8s master節點上執行如下操作：

1.建立serviceaccount

```
$ kubectl -n devops create serviceaccount jenkins-robot
```

命令輸出：

```
serviceaccount/jenkins-robot created
```

2.角色繫結

```
$ kubectl -n devops create rolebinding jenkins-robot-binding --clusterrole=cluster-admin --serviceaccount=devops:jenkins-robot
```

命令輸出：

```
rolebinding.rbac.authorization.k8s.io/jenkins-robot-binding created
```

3.獲取 ServiceAccount

```
$ kubectl -n devops get serviceaccount jenkins-robot -o go-template --template='{{range .secrets}}{{.name}}{{"\n"}}{{end}}'
```

jenkins-robot-token-n8w6b

4.基於base64解碼 ServiceToken

```
$ kubectl -n devops get secrets jenkins-robot-token-n8w6b -o go-template --template '{{index .data "token"}}' | base64 --decode
```

命令輸出：

```
eyJhbGciOiJSUzI1NiIsImtpZCI6IiJ9.eyJpc3MiOiJrdWJlcm5ldGVzL3NlcnZpY2VhY2NvdW50Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9uYW1lc3BhY2UiOiJkZXZvcHMiLCJrdWJlcm5ldGVzLmlvL3NlcnZpY2VhY2NvdW50L3NlY3JldC5uYW1lIjoiamVua2lucy1yb2JvdC10b2tlbi1uOHc2YiIsImt1YmVybmV0ZXMuaW8vc2VydmljZWFjY291bnQvc2VydmljZS1hY2NvdW50Lm5hbWUiOiJqZW5raW5zLXJvYm90Iiwia3ViZXJuZXRlcy5pby9zZXJ2aWNlYWNjb3VudC9zZXJ2aWNlLWFjY291bnQudWlkIjoiOTcyZTY0OGYtMTYxZC00NmM5LWI0ZjgtYjFkNTdlOWY4NTBjIiwic3ViIjoic3lzdGVtOnNlcnZpY2VhY2NvdW50OmRldm9wczpqZW5raW5zLXJvYm90In0.ArQvcaEqCaeU1ZcJ6nOC5rLaTZr_vLDrpLCt87asltMUWj2gSli_mXUTrl09hBnBDXI3A1D4rJXHKLHjIAA4nN8qRIRGbpqSNzDwmqJr-jmmmWWZFrZ3n3Al9-13KJnNOK8pcWr70rt3Rsigt4B6CIQ0-ZLK8BZhvROJSifeOfJ6xe2KBqdXBv1ccZZZfEhPLgGbaR5yWm5jLvOMr2MQiPDrZoHOEkcMt-C0xipytOp4sJCJ4bQhb-UoMu1owYydxbd6O7xO71fvqP_bMDpZXC601nA2ggK7h-vi6CJffHv5MM59q8X_DWe1NnZS6KXiMmkXqAmBn10Yu20PNj-kjg
```

5.新增 `Secret text`驗證資訊

_操作指引_：【首頁】->【Credentials】-> 【System】-> 【Global credentials】-> 【Add Credentials】-> 選擇【Secret text】型別

然後將上一步 解碼的結果 更新至 `Secret`, Pipeline 中

![](http://img.blog.itpub.net/blog/2019/10/24/f9d2cc55692a89dc.jpeg?x-oss-process=style/bb)

### 2. 如何建立 jenkins pipeline

#### 1. 建立jenkins pipeline item

_操作指引_：【首頁】->【New Item】

![](http://img.blog.itpub.net/blog/2019/10/24/86a8e2ebd53e0883.jpeg?x-oss-process=style/bb)

#### 2. pipeline script 步驟說明

_注_: pipeline主要包含三個階段（檢出程式碼、製作映象、部署服務），下面跟大家解釋下，如何編寫pipeline， 藉助Pipeline Syntax生成的只是部分程式碼，你可以根據語言規範將其完善。

1.階段1，檢出程式碼

_操作指引_：【首頁】->【hanker-hello-demo】-> 【Pipeline Syntax】

![](http://img.blog.itpub.net/blog/2019/10/24/a497555dd94b477f.jpeg?x-oss-process=style/bb)
_注_: 本實踐中選取的 `git: Git` 型別，當然你也可以選擇 `checkout: Check out from version control`

獲取到該步驟的指令碼

```
git credentialsId: 'gitlab-project-auth', url: 'http://gitlab.hanker.com/colynn/hanker-hello.git'
```

2.階段2，構建映象
   _操作指引_：類似於 階段1，

![](http://img.blog.itpub.net/blog/2019/10/24/12678222f20cbbba.jpeg?x-oss-process=style/bb)

完善獲取該步驟指令碼

```
script {
    withDockerRegistry(credentialsId: 'harbor-auth', url: 'http://10.0.0.185:5000') {
        def customImage =  docker.build("10.0.0.185:5000/devops/hanker-hello:v1")
        customImage.push()
    }
}
```

_注_: 支援本階段需要jenkins-agent映象裡包含docker命令。

3.階段3. 部署服務

_參考_: [jenkins kubernetes cli plugin](https://github.com/jenkinsci/kubernetes-cli-plugin/blob/master/README.md)

_注_: 支援本階段需要jenkins-agent映象裡包含kubectl命令。

#### 3. 設定 pipeline

_注_:

- General/ Build Triggers/ Advanced Project Options 這三塊你可以根據自己需要設定，將各階段的指令碼合併，更新至 Pipline -> Script內。

合併後的pipeline指令碼內容如下：

```
pipeline {
    agent any
    stages {
        stage('checkout') {
            steps {
                git credentialsId: 'gitlab-project-auth', url: 'http://gitlab.hanker.com/colynn/hanker-hello.git'    
            }
        }
        
        stage('docker-publish') {
            steps{
                script {
                    withDockerRegistry(credentialsId: 'harbor-auth', url: 'http://10.0.0.185:5000') {
                        def customImage =  docker.build("10.0.0.185:5000/devops/hanker-hello:v1")
                        customImage.push()
                    }
                }
            }
        }
        
        stage('application-deploy') {
            steps {
                withKubeConfig([credentialsId: '5a5517f3-3d38-459d-bafc-12b55beeb588', serverUrl: 'https://10.0.0.182:6443']) {
                    sh '/usr/bin/kubectl apply -f k8s-setup.yml'
                }
            }
        }
    }
}

```

![](http://img.blog.itpub.net/blog/2019/10/24/2e90098c4f6d3f0c.jpeg?x-oss-process=style/bb)

### 3. 觸發構建

![](http://img.blog.itpub.net/blog/2019/10/24/1d1771646c168556.jpeg?x-oss-process=style/bb)

### 4. 結果確認

1.確認 jenkina-agent 啟動狀態；

```
$ kubectl -n devops get pods |grep jnlp
jnlp-sh8zl                                 1/1     Running   0          14s

// 檢視jenkins-agent pod日誌
$ kubectl -n devops logs -f [jenkins-agent-pod-name]
```

_注_: 如果長時間沒有啟動jenkins-agent, 可以確認下叢集內是否有足夠的資源。

2.確認pipeline 執行狀態；

![](http://img.blog.itpub.net/blog/2019/10/24/9a2835cd68892035.jpeg?x-oss-process=style/bb)

3.確認harbor映象倉庫裡是否已經有新推送的映象
![](http://img.blog.itpub.net/blog/2019/10/24/2d1ebdfbd401113a.jpeg?x-oss-process=style/bb)

_注_: harbor裡的專案是需要你先建立好的，不然推送時會報錯。

4.確認部署的服務狀態

k8s master節點上執行如下操作:

```
$ kubectl -n devops get pod,deployment,svc,ingress |grep hanker-hello

pod/hanker-hello-5b7586f86d-5j7kk              1/1     Running   0          173m

deployment.extensions/hanker-hello              1/1     1            1           3h8m
service/hanker-hello-svc          ClusterIP   10.233.22.19    <none>        8080/TCP             3h8m
ingress.extensions/hanker-hello-ingress              hanker-hello-demo.dev.hanker.net                   80      3h8m
```

![](http://img.blog.itpub.net/blog/2019/10/24/efae9654e0a6c9c7.jpeg?x-oss-process=style/bb)

## 附錄

### 1.自定義jenkins-agent映象

```
## 基於 https://github.com/Kubernetes-Best-Pratice/jenkins-jnlp-agent.git

$ git checkout  https://github.com/Kubernetes-Best-Pratice/jenkins-jnlp-agent.git

$ cd jenkins-jnlp-agent
$ docker build .
$ docker tag tag-name custom-private-repository-addr

```

_注_: 你也可以基於[基礎映象](https://github.com/jenkinsci/docker-jnlp-slave)建立自定義的映象

### 2.可以做的更完善

1. 配置webhook, 自動觸發jenkins job;
2. 當前我們實踐時構建的映象版本使用的是固定的, 你是否可以將其替換為依賴pipeline環境變數或是傳參的形式，將其變是更有意義；
3. 上一篇文章中在設定【配置Kubernetes Pod Template】時，我們提到可以掛載主機或是網路共享儲存，你是否可以透過這個將你的構建快起來；
4. 我們的示例程式碼使用的go, 直接是映象內打包，如何更好的就好的其他語言的構建，你可以參考[Using Docker with Pipeline](https://jenkins.io/doc/book/pipeline/docker/)；
5. 你想過如何下載構建過程中的產物嗎，等等。

參考連結 ：

1. https://github.com/jenkinsci/kubernetes-cli-plugin/blob/master/README.md
2. 下載kubectl: https://docs.docker.com/ee/ucp/user-access/kubectl/</none>

【Kubernetes系列】第8篇 CI/CD之全流程實踐

相關文章