在 Kubernetes 上调试 daprd
概述
有时需要了解 Dapr 边车(daprd)的运行状态，它作为边车运行在你的应用旁边，尤其是在诊断 Dapr 应用并怀疑 Dapr 本身存在问题时。此外，你可能正在为 Kubernetes 上的 Dapr 开发新功能，并希望调试你的代码。
本指南介绍如何在 Kubernetes Pod 中使用内置的 Dapr 调试功能来调试 Dapr 边车。要了解如何在 Kubernetes 中查看日志和排查 Dapr 问题，请参阅配置和查看 Dapr 日志指南
前置条件
以调试模式初始化 Dapr
如果 Dapr 已经安装在你的 Kubernetes 集群中，请先卸载它：
dapr uninstall -k
我们将使用 ‘helm’ 来安装 Dapr 调试二进制文件。更多信息请参考使用 Helm 安装。
首先配置一个名为 values.yml 的 values 文件，包含以下选项：
global:
registry: docker.io/<your docker.io id>
tag: "dev-linux-amd64"
然后进入从你克隆的 dapr/dapr 仓库中的 ‘dapr’ 目录，并执行以下命令：
helm install dapr charts/dapr --namespace dapr-system --values values.yml --wait
要为 daprd 启用调试模式，你需要在应用的部署文件中添加一个额外的注解 dapr.io/enable-debug。让我们以 quickstarts/hello-kubernetes 为例。修改 ‘deploy/node.yaml’ 如下：
diff --git a/hello-kubernetes/deploy/node.yaml b/hello-kubernetes/deploy/node.yaml
index 23185a6..6cdb0ae 100644
--- a/hello-kubernetes/deploy/node.yaml
+++ b/hello-kubernetes/deploy/node.yaml
@@ -33,6 +33,7 @@ spec:
dapr.io/enabled: "true"
dapr.io/app-id: "nodeapp"
dapr.io/app-port: "3000"
+ dapr.io/enable-debug: "true"
spec:
containers:
- name: node
注解 dapr.io/enable-debug 将提示 Dapr 注入器以调试模式注入 Dapr 边车。你还可以使用注解 dapr.io/debug-port 指定调试端口，否则默认端口为 “40000”。
使用以下命令部署应用。完整指南请参考 Dapr Kubernetes 快速入门：
kubectl apply -f ./deploy/node.yaml
使用以下命令找出目标应用的 pod 名称：
$ kubectl get pods
NAME READY STATUS RESTARTS AGE
nodeapp-78866448f5-pqdtr 1/2 Running 0 14s
然后使用 kubectl 的 port-forward 命令将内部调试端口暴露给外部 IDE：
$ kubectl port-forward nodeapp-78866448f5-pqdtr 40000:40000
Forwarding from 127.0.0.1:40000 -> 40000
Forwarding from [::1]:40000 -> 40000
完成。现在你可以指向端口 40000 并从你喜欢的 IDE 启动到 daprd 的远程调试会话。
常用 kubectl 命令
在 Kubernetes 上调试 daprd 和应用时使用以下常用 kubectl 命令。
获取所有 pods、事件和服务：
kubectl get all
kubectl get all --n <namespace>
kubectl get all --all-namespaces
分别获取每一项：
kubectl get pods
kubectl get events --n <namespace>
kubectl get events --sort-by=.metadata.creationTimestamp --n <namespace>
kubectl get services
检查日志：
kubectl logs <podId> daprd
kubectl logs <podId> <myAppContainerName>
kuebctl logs <deploymentId> daprd
kubectl logs <deploymentId> <myAppContainerName>
kubectl describe pod <podId>
kubectl describe deploy <deployId>
kubectl describe replicaset <replicasetId>
通过运行以下命令重启 pod：
kubectl delete pod <podId>
这将导致 replicaset 控制器在删除后重启 pod。
观看演示
请参阅 Dapr Community Call #36 中关于在 Kubernetes 上排查 Dapr 问题的演示。