Contents

Skaffold debug goland

今年的 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 就會知道

img/skaffold-go-debug-image-4.png

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.jsPythonJavaGo 目前不支援, 不過在 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

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

步驟有一點麻煩

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

  1. 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"}}
  2. 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
    
  3. docker-compose & kubernetes YAML 需要再加註其他的聲明
  4. Cloud Code 上跑 skaffold debug 會自動幫我們建立 port forwarding
  5. 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"
            }
        }