Skaffold debug goland

2019-10-04 892 words 2 minutes

Contents

今年的 Google Cloud Summit 台北場於 9/24 在內湖萬豪酒店舉行，在主題演講中再次聽到 Cloud Code 的部份也看到比較有感覺的 Live demo

Cloud Code 隨附的工具能協助您以輕鬆快速的方式編寫、部署及偵錯雲端原生的應用程式。這項產品提供 Visual Studio Code 和 IntelliJ 等 IDE 的擴充功能，方便您在 Kubernetes 上針對程式碼快速進行疊代、偵錯及部署等作業。 Cloud Code 是基於 GoogleContainerTools/skaffold: Easy and Repeatable Kubernetes Development 為基礎上再整合 Visual Studio Code 和 IntelliJ IDE, 讓開發者可以直接在 IDE 上就可以快速開發 Kubernetes 上的應用程式

基本上來說 Cloud Code 給 Visual Studio Code 和 IntelliJ IDE 的 plugin 就是基於 skaffold 打造的(如下圖)，當你在 Visual Studio Code 執行(cmd+shift+p) Cloud Code: Continues Deploy 的 log 就會知道

Cloud Code & debug

在談談 Skaffold debug k8s golang 的程式前，先來看看目前 Cloud Code debug 的部份支援幾種程式語言

Visual Studio Code 中 Cloud code 可以新增的專案範本

/posts/skaffold-debug-goland/img/skaffold-go-debug-image-5.png

依照官方文件，現在 Cloud Code 有整合 debug 的部份有 Node.js、 Python、Java。 Go 目前不支援, 不過在 skaffold v38.0 的時候終於加進了. (Add Go container debugging support #2306)，所以就有了這一篇文章。至於本來 Cloud Code 就有整合的語言就依照官方的操作流程應該就可以正常運作，所以這邊就不在說明了

Golang debug & skaffold

當我們開發 kubernetes 應用程式(golang)會有 remote debug 的需求，在 skaffold v38.0 版之前 remote debug golang 是需要比較複雜的方式(docker-compose or kubernetes))

之前我們怎麼進行 remote debug golang

編譯 binary 時需要加入 github.com/derekparker/delve/cmd/dlv
執行 binary 時需要帶入 CMD ["/go/bin/dlv", "--listen=:2345", "--headless=true", "--api-version=2", "exec", "/exe"]
docker-compose & kubernetes YAML 檔都需要加入額外的聲明(完整的 yaml 範例可以看這)
1 2 3 4 5 6
... security_opt: - apparmor:unconfined cap_add: - SYS_PTRACE ...
需要 port forwarding dlv debug port 到本機
透過 localhost port forwarding 就可以 attach 到 remote 的 golang

步驟有一點麻煩

當 skaffold v38.0 開始支援 container debugging support，事情就變簡單了

remote debug 還是需要 dlv，不過 skaffold 透過 kubernetes 中的 initContainers 的方式來幫我們載入(Mount)相關的套件(dlv/dbg)，且會自動識別 runtime 來決定載入的套件，需 golang 的部份就在 gcr.io/gcp-dev-tools/duct-tape/go，(其他的 runtime 可由 https://github.com/GoogleContainerTools/container-debug-support/ 查詢)，並且會在 metadata 的 anootation 中加上 debug.cloud.google.com/config: {"addsvc":{"dlv":56268,"runtime":"go"}}

remote debug 還是需要 dlv 相關的啟動參數，skaffold 會自動幫我載入

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
Containers:
    addsvc:
        Container ID:  docker://493a405f1dc0ee462f4e5f269ae2fdb352e8468c186cbb26905c42e0bf5675cf
        Image:         cage1016/skaffold-debug-go-demo-addsvc:88f846061af2d34e8347a6325dcf48bb638f6baa50fd4599240fa5280054048e
        Image ID:      docker://sha256:88f846061af2d34e8347a6325dcf48bb638f6baa50fd4599240fa5280054048e
        Ports:         8020/TCP, 8021/TCP, 56268/TCP
        Host Ports:    0/TCP, 0/TCP, 0/TCP
        Command:
            /dbg/go/bin/dlv
            exec
            --headless
            --continue
            --accept-multiclient
            --listen=localhost:56268
            --api-version=2
            /exe

docker-compose & kubernetes YAML 不需要再加註其他的聲明
Cloud Code 上跑 skaffold debug 會自動幫我們建立 port forwarding

Cloud Code 上進行 deubg 的設定，

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
        {
        "type": "cloudcode",
        "language": "Go",
        "request": "attach",
        "debugPort": 56268,
        "localRoot": "${workspaceFolder}/go",
        "remoteRoot": "/go/",
        "name": "skaffold-debug-go-demo",
        "podSelector": {
            "app": "addsvc"
        }
    }