1         安裝Dapr開發除錯環境

1.1         Dapr 完整安裝模式不支援開發除錯

在上一篇隨筆《Blazor+Dapr+K8s微服務之服務呼叫》中，我們通過為每個微服務執行dapr run ….dotnet run命令，以自宿主的方式在本地開發環境成功運行了服務呼叫的例子。

但是，這種執行方式是不支援除錯的，我們無法在程式中進行斷點。這就很不實用了！

搜尋一番，找到這麼一篇文章：Simple approach to run and debug multiple .NET Dapr projects (w/o Docker) - DEV Community，根據文章，我們可以不依賴Docker，就可以對我們的Dapr微服務本地進行除錯。

其主要原理是：通過Dapr簡易安裝的Daprd命令，以自宿主方式先啟動每個微服務的Dapr SideCar,  指定這些SideCar 監聽的每個微服務的Http埠，然後，我們就可以在VS中按照監聽埠啟動每個微服務，這樣我們的微服務就能夠和Dapr的SideCar實現通訊，從而實現服務呼叫，狀態儲存的功能。

1.2         修改Dapr完整安裝模式為簡易模式

我們需要先解除安裝我們已經安裝好的完整模式，命令如下：

Dapr uninstall

然後安裝簡易模式，命令如下：

dapr init --slim

2         通用Dapr開發除錯指令碼

我對文章中作者的指令碼做了簡化處理，實現了一個”通用Dapr 微服務開發除錯資料夾”，以方便我們可以利用這個資料夾對任何Dapr微服務進行除錯。該資料夾結構如下：

2.1         微服務Dapr SideCar啟動指令碼。

其中start-daprd.ps1為啟動每個微服務SideCar的PowerShell指令碼，內容如下：

# pre-requisites:

# - initialized with: dapr init --slim

#   so that redis is running as container and placement service is started on demand

# --------------------------------------------------------------------------------

# projects

# - appId       = needs to be Dapr id commonly used to address service

$configProjects = @(

    @{

        appId       = "blazorweb"

    }

    @{

        appId       = "serviceapi1"

    }

)

# --------------------------------------------------------------------------------

# INIT

$ErrorActionPreference = "Stop"

# stop and remove previous jobs

$jobNamePattern = $configProjects | Join-String -Property appId -Separator "|" -OutputPrefix "(placement|" -OutputSuffix ")"

Get-Job | ? { $_.Name -match $jobNamePattern } | Stop-Job -PassThru | Remove-Job

# --------------------------------------------------------------------------------

# MAIN

$jobs = @()

# start placement service/job

$DAPR_PLACEMENT_PORT = 6050

$jobName = "placement"

Start-Job -Name $jobName -ScriptBlock {

    param( $port )

    placement --port $port

} -Argument $DAPR_PLACEMENT_PORT

Write-Host "started" $jobName "in background, listening port:"$DAPR_PLACEMENT_PORT

"-" * 80

$jobs += $jobName

# start jobs for app and dapr sidecar

$DAPR_HTTP_PORT = 3500

$DAPR_GRPC_PORT = 50001

$METRICS_PORT = 9091

$APP_PORT = 5000

foreach ($configProject in $configProjects) {

    $jobName = $configProject.appId + "-daprd"

    $componentsPath = "components/"

    $configFile = "config.yaml"

    Start-Job -Name $jobName -ScriptBlock {

        param( $appId, $appPort, $DAPR_HTTP_PORT, $DAPR_GRPC_PORT, $DAPR_PLACEMENT_PORT, $METRICS_PORT, $componentsPath, $configFile)

        daprd --app-id $appId  `

            --app-port $appPort `

            --placement-host-address $("localhost:" + $DAPR_PLACEMENT_PORT) `

            --log-level debug `

            --components-path $componentsPath `

            --config $configFile `

            --dapr-http-port $DAPR_HTTP_PORT `

            --dapr-grpc-port $DAPR_GRPC_PORT `

            --metrics-port $METRICS_PORT

    } -Argument $configProject.appId, $APP_PORT, $DAPR_HTTP_PORT, $DAPR_GRPC_PORT, $DAPR_PLACEMENT_PORT, $METRICS_PORT, $componentsPath, $configFile

    Write-Host "started "$jobName" in background, DAPR_HTTP_PORT: "$DAPR_HTTP_PORT "DAPR_GRPC_PORT:"$DAPR_GRPC_PORT "METRICS_PORT:"$METRICS_PORT

    Write-Host "expecting "$configProject.appId" to be started on listening port:"$APP_PORT

    "-" * 80

    $jobs += $jobName

    $DAPR_HTTP_PORT += 10

    $DAPR_GRPC_PORT += 10

    $APP_PORT += 10

    $METRICS_PORT += 1

}

# handle menu

$running = $true

while ($running) {

    Write-Host "s: job status"

    Write-Host "e: check all logs for errors"

    Write-Host "q: stop jobs and quit"

    $jobId = 0

    foreach ($job in $jobs) {

        Write-Host $($jobId.ToString() + ": show log of " + $job)

        $jobId += 1

    }

    $option = Read-Host "Enter option"

    switch ($option.ToUpper()) {

        "S" {

            Get-Job | ? { $_.Name -match $jobNamePattern } | Format-Table Name, State

        }

        "E" {

            foreach ($job in $jobs) {

                $errors = $null

                if ($job -match "-app$") {

                    $errors = (Receive-Job -Name $job -Keep) -match "(error|fail)\:"

                }

                else {

                    $errors = (Receive-Job -Name $job -Keep) -match "level\=error"

                }

                if ($errors) {

                    "-" * 80

                    Write-Host "ERROR IN JOB:" $job -ForegroundColor Red

                    $errors

                }

            }

        }

        "Q" {

            Get-Job | ? { $_.Name -match $jobNamePattern } | Stop-Job -PassThru | Remove-Job

            $running = $false

        }

        default {

            if ([int32]::TryParse($option , [ref]$jobId )) {

                if ($jobId -ge 0 -and $jobId -lt $jobs.Count) {

                    Receive-Job -Name $jobs[$jobId] -Keep | code -

                }

            }

        }

    }

}

對於每個微服務，我們需要在變數configProjects中定義每個微服務的名字/ID，這裡使用的是上一節服務呼叫中的兩個微服務的名字 blazorweb和serviceapi1。其它內容不需要變動。

2.2         其它配置檔案

其中components資料夾和config.yml 分別定義了SideCar啟動需要的元件和配置。元件包括訂閱釋出元件和狀態儲存元件，如下：

這兩個元件的內容很簡單，都是連結到一個Redis服務，提供訂閱釋出需要的訊息佇列和狀態儲存需要的快取。這兩個元件的檔案和config.yml配置檔案其實我是拷貝的完整安裝目錄（C:\Users\XXX\.dapr）下面的檔案。

3         除錯服務呼叫

3.1         為每個微服務啟動Dapr SideCar 服務

啟動每個微服務的SideCar：

可以看到，我們以Job方式分別啟動了三個服務，分別是，placement, blazorweb-daprd 和serviceapi1-daprd,  placement 服務是Dapr用來實現Actor模式的。而blazorweb-daprd 和serviceapi1-daprd則分別是我們兩個微服務的Dapr SideCar。兩個SideCar分別要求我們的微服務在5000和5010埠啟動。

需要說明的是，啟動微服務SideCar之前，先要啟動Dapr元件需要的Redis服務，我這邊啟動了一個簡易的Windows Redis Server。

這時候，我們檢視每個服務的狀態都是執行狀態：

3.2         啟動每個微服務

我們在VS中，修改每個微服務宿主專案的launchSettings檔案，分別在5000埠和5010埠啟動我們的兩個微服務：

3.3         除錯服務呼叫

訪問http://localhost:5000,

我們在DaprTest1.ServiceApi1專案的WeatherForecastController.cs檔案中打個斷點，然後點選Blazor介面中的Fetch Data選單，可以看到程式停在了我們的斷點上。

這裡需要說明一個問題，我們在做服務呼叫的時候，在簡易安裝模式下，Dapr會始終呼叫127.0.0.1的3500埠，例如http://127.0.0.1:3500/v1.0/invoke/serviceapi1/method/WeatherForecast，並不會呼叫當前微服務SideCar指定的Dapr Http 埠。其實，我們如果訪問http://127.0.0.1:3510/v1.0/invoke/serviceapi1/method/WeatherForecast，也是可以呼叫微服務的。

相關程式碼：iamxiaozhuang/dapr-test (github.com)