歡迎光臨
每天分享高質量文章

Drone 搭配 Kubernetes 部署 Go 語言專案

在之前寫過一篇『Drone 搭配 Kubernetes 升級應用程式版本』,裡面內容最主要介紹 honestbee 撰寫的 drone 外掛: drone-kubernetes,但是此外掛並非用 Go 語言所撰寫,而是用 Shell Script 透過 kubectl set image 方式來更新專案專案,但是這邊會有幾個缺點,第一點就是假設在 Develop 環境永遠都是吃 master 分支,也就是讀取 Image 的 latest 標籤,這時候此外掛就無法作用,第二點此外掛無法讀取 kubernetes YAML 檔案,假設專案要修正一個 ENV 值,此外掛也無法及時更新。綜合這兩點因素,只好捨棄此外掛,而本篇會帶給大家另一個用 Go 語言所撰寫的外掛,是由 @Sh4d1 所開發的專案,用法相當容易,底下會一步一步教大家如何部署 Go 語言專案。

GitHub 工作流程及部署

團隊只會有兩種環境,一種是 Staging 另一種則是 Production,而前者是根據只要 master 分支有變動,則會更新 Staging,而後者則需要下 Tag 才會正式部署到 Production,在 Drone 預設值內,是不開啟 Tag 事件,所以需自行到後臺開啟 (如下圖),未來可以透過 drone-cli 用 command 方式開啟,目前此功能正在 Review 中。

底下會來一步一步教大家如何設定 Drone。

準備 Go 專案

本篇會用 Go 語言寫個小型 Http 服務,來證明使用 tag 事件及 master 分支都可以正確部署,底下先看看 Go 的程式碼:

package main

import (  
   "log"    "net/http"    "os"    "strings"

)
   
var version = "master"

func showVersion(w http.ResponseWriter, r *http.Request) {    log.Println(version)    w.Write([]byte(version)) }

func sayHello(w http.ResponseWriter, r *http.Request) {    message := r.URL.Path    message = strings.TrimPrefix(message, "/")    message = "Hello, drone got the message: " + message    log.Println(message)    w.Write([]byte(message)) }

func main() {  
   // use PORT environment variable, or default to 8080    port := "8080"    if fromEnv := os.Getenv("PORT"); fromEnv != "" {        port = fromEnv    }    http.HandleFunc("/version", showVersion)    http.HandleFunc("/", sayHello)    log.Println("Listen server on " + port + " port")    if err := http.ListenAndServe(":"+port, nil); err != nil {        log.Fatal(err)    } }

從上面程式可以看到,在編譯 Go 語言專案時,可以從外部帶入 version 變數,證明目前的 App 版本。請參考 Makefile 內的

build:
ifneq ($(DRONE_TAG),)
    go build -v -ldflags "-X main.version=$(DRONE_TAG)" -a -o release/linux/amd64/hello
else    go build -v -ldflags "-X main.version=$(DRONE_COMMIT)" -a -o release/linux/amd64/hello endif

只要是 master 分支的 commit,就會執行 -X main.version=$(DRONE_COMMIT),如果是 push tag 到伺服器,則會執行 -X main.version=$(DRONE_TAG)。最後看看 Drone 如何編譯

pipeline:
  build_linux_amd64:
    image: golang:1.10
    group: build
    environment:
      - GOOS=linux
      - GOARCH=amd64
      - CGO_ENABLED=0
    commands:
      - cd example19-deploy-with-kubernetes && make build

記得將 GOOSGOARCH 和 CGO_ENABLED 設定好。

上傳容器到 DockerHub

上一個步驟可以編譯出 linux 的二進位制檔案,這時候就可以直接放到容器內直接執行:

FROM plugins/base:multiarch

ADD example19-deploy-with-kubernetes/release/linux/amd64/hello /bin/

ENTRYPOINT ["/bin/hello"]

其中 plugins/base:multiarch 用的是 docker scratch 最小 image 搭配 SSL 憑證檔案,接著把 go 編譯出來的二進位制檔案放入,所以整體容器大小已經是最小的了。看看 drone 怎麼上傳到 DockerHub。

  docker_golang:
    image: plugins/docker:17.12
    secrets: [ docker_username, docker_password ]
    repo: appleboy/golang-http
    dockerfile: example19-deploy-with-kubernetes/Dockerfile
    default_tags: true
    when:
      event: [ push, tag ]

其中 default_tags 會自動將 master 分支上傳到 latest 標籤,而假設上傳 1.1.1 版本時,drone 則會幫忙編譯出三個不同的 tag 標籤,分別是 11.11.1.1 這是完全符合 Semantic Versioning,如果有在開源專案打滾的朋友們,一定知道版本的重要性。而 Drone 在這地方提供了很簡單的設定讓開發者可以上傳一次 tag 做到三種不同的 image 標籤。

部署更新 Kubernetes

這邊推薦大家使用 Sh4d1/drone-kubernetes 外掛,使用之前請先設定好三個引數:

  1. KUBERNETES_SERVER

  2. KUBERNETES_CERT

  3. KUBERNETES_TOKEN

KUBERNETES_SERVER 可以開啟家目錄底下的 ~/.kube/config 檔案直接找到,cert 及 token 請先透過 pod 找到 secret token name:

$ kubectl describe po/frontend-9f5ccc8d4-8n9xq | grep SecretName | grep token
    SecretName:  default-token-r5xdx

拿到 secret name 之後,再透過底下指令找到 ca.crt 及 token

$ kubectl get secret default-token-r5xdx -o yaml | egrep 'ca.crt:|token:'

其中 token 還需要透過 base64 decode 過,才可以設定到 drone secret。完成上述步驟後,可以來設定 drone 部署:

  deploy:
    image: sh4d1/drone-kubernetes
    kubernetes_template: example19-deploy-with-kubernetes/deployment.yml
    kubernetes_namespace: default
    secrets: [ kubernetes_server, kubernetes_cert, kubernetes_token ]

其中 deployment.yml 就是該服務的 deploy 檔案:

apiVersion: extensions/v1beta1
kind: Deploymentmetadata:
  name: frontend 
 # these labels can be applied automatically  # from the labels in the pod template if not set  labels:    app: gotraining    tier: frontend
 spec:  # this replicas value is default  # modify it according to your case  replicas: 3
 # selector can be applied automatically  # from the labels in the pod template if not set  # selector:  #   app: guestbook  #   tier: frontend  strategy:    type: RollingUpdate    rollingUpdate:      maxSurge: 1      maxUnavailable: 1  minReadySeconds: 5  template:    metadata:      labels:        app: gotraining        tier: frontend    spec:      containers:      - name: go-hello        image: appleboy/golang-http:VERSION        imagePullPolicy: Always        resources:          requests:            cpu: 100m            memory: 100Mi        ports:        - containerPort: 8080        env:        - name: FOR_GODS_SAKE_PLEASE_REDEPLOY          value: 'THIS_STRING_IS_REPLACED_DURING_BUILD'

大家可以找到 image: appleboy/golang-http:VERSION,這邊需要寫個 sed 指令來取代 VERSION,部署到 staging 則是 latest,如果是 tag 則取代為 DRONE_TAG

ifneq ($(DRONE_TAG),)
    VERSION ?= $(DRONE_TAG)
else    VERSION ?= latest endif prepare:    sed -ie "s/VERSION/$(VERSION)/g" deployment.yml

這邊有個問題就是,我們怎麼讓在同一個 image:latest 下,也可以保持更新 App 呢,首先必須設定 imagePullPolicy 為 Always,以及設定一個 env 讓 drone 可以動態修改 template 檔案

        env:
        - name: FOR_GODS_SAKE_PLEASE_REDEPLOY        
         value: 'THIS_STRING_IS_REPLACED_DURING_BUILD'

目的是讓每次 kubernetes 都可以讀取不一樣的 template 確保 image 都可以即時更新,假設少了上述步驟,是無法讓 staging 保持更新狀態。畢竟使用 kubectl apply 時,如果 yaml 檔案是沒有更動過的,就不會更新。

prepare:
    sed -ie "s/VERSION/$(VERSION)/g" deployment.yml
    sed -ie "s/THIS_STRING_IS_REPLACED_DURING_BUILD/$(shell date)/g" deployment.yml
    cat deployment.yml

而 Tag 就不用擔心,原因就是 VERSION 就會改變不一樣的值,所以肯定會即時更新,那假設團隊想要上傳相同 tag (這是不好的做法,請盡量不要使用),這時候動態修改 env 的作法就發揮功效了。從上面的教學,現在我們看安新的透過 GitHub Flow 來完成部署 Staging 及 Production 了。

影片簡介

下麵影片並無包含實作部分,會介紹我在團隊怎麼使用 GitHub Flow 部署,更多實作詳細細節,可以參考 Udemy 上面影片

心得

作者我尚未深入玩過 GitLab CI 或者是 Jenkins 搭配 Kubernetes 來部署專案,但是我相信以複雜及學習難度來說,用 Drone CI 是比較簡單的,這部分就不多說了,大家實際操作比較過才知道。希望能帶給有在玩 Drone 的開發者有些幫助。另外我在 Udemy 上面開了兩門課程,一門 drone 另一門 golang 教學,如果對這兩門課有興趣的話,都可以購買,目前都是特價 $1800

  • Go 語言實戰 $1800 (臺幣)

  • 一天學會 DEVOPS 自動化流程 $1800 (臺幣)

線上程式碼

文章連結:https://gocn.vip/article/825、

文章來自: 『Drone 搭配 Kubernetes 部署 Go 語言專案

贊(0)

分享創造快樂