中分享了如何用docker-compose搭建AspNetCore的开发环境,在开发过程中debug是必不可少的,如果你使用VS2017的话,右键就可以了,而作为跨平台的.net core开发的时候却要依赖VisualStudio,那一定算不上真正的跨平台,而且不是所有人都能买得起VS的许可证,买得起windows的授权,(我知道很多人都没买过:)所以这次来分享一下如何使用vscode在docker中debug。
我们知道vscode是可以远程debug的,参考,其原理就是在服务器上安装.NetCore命令行调试工具VSDBG
,然后本地vscode通过ssh隧道建立和服务器之间的连接,控制服务器上的VSDBG
进行断点调试。
根据远程debug的启发,我们可以在docker中安装VSDBG
,vscode访问容器中的VSDBG
进行断点调试,原理和上面的远程debug一样,区别在于可以直接访问容器而不需要ssh。
首先通过命令
curl -sSL https://aka.ms/getvsdbgsh | bash /dev/stdin -v latest -l ~/vsdbg
记得2个月之前用这个命令无法安装的VSDBG
,因为里面的工具包下载不了,只能手动把对应版本的工具包下载下来,然后上传到自己的文件服务器,再替换脚本中的下载地址,折腾的好烦人。现在可以直接下载了,非常开心?。
在容器中安装VSDBG
,具体的Dockerfile如下:
FROM microsoft/aspnetcore:1.1.1ENV TZ=Asia/ShanghaiRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone \ && apt-get update \ && yes | apt-get install curl unzip \ && curl -sSL https://aka.ms/getvsdbgsh | bash /dev/stdin -v latest -l ~/vsdbgWORKDIR /appVOLUME /appENV ASPNETCORE_ENVIRONMENT DevelopmentENTRYPOINT ["dotnet", "Web.dll"]
最近.net core 2.0 发布了,这里的需要做一些更新,如下:
FROM microsoft/aspnetcore:2.0 /*更新到2.0的镜像*/LABEL Name=aspnetcore-debug Version=latestENV TZ=Asia/ShanghaiRUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone \ && apt-get update \ && apt-get install -y curl unzip \ && apt-get install -y procps \ /*最新的镜像中没有ps,所以需要安装*/ && curl -sSL https://aka.ms/getvsdbgsh | bash /dev/stdin -v latest -l ~/vsdbg WORKDIR /appVOLUME /app
在vscode中项目根目录下的.vscode
文件夹中的lunch.json
的configurations
节点中追加一个debug配置:
{ "name": ".NET Core Remote Attach", "type": "coreclr", "request": "attach", "processId": "${command:pickRemoteProcess}", "pipeTransport": { "pipeProgram": "bash", "pipeArgs": [ "-c", "docker exec -i 你的容器名称 ${debuggerCommand}" ], "debuggerPath": "/root/vsdbg/vsdbg", "pipeCwd": "${workspaceRoot}", "quoteArgs": true }, "sourceFileMap": { "/app": "${workspaceRoot}" }, "justMyCode": true}
主机是通过docker exec -i 你的容器名称 ${debuggerCommand}
命令和容器进行交互的,不了解docker exec
的可以去查看一下文档。
"sourceFileMap": { "/app": "${workspaceRoot}" },
sourceFileMap映射容器中程序所在的路径,这里就是之前Dockerfile中的WORKDIR
的路径。
那么现在咱们dotnet publish -c Debug src/Web/Web.csproj
发布这个项目,然后Build容器,docker build -t myweb
,接着docker run -t -name MyDebugWeb myweb
,现在容器已经运行了,在vscode中的Deubg中选择刚才新建的.NET Core Remote Attach
当然也可以不用单独build这个容器,直接放在之前讲的docker-compose中,效果也是一样的。