三、使用vscode在docker中debug

上篇博文中分享了如何用docker-compose搭建AspNetCore的开发环境,在开发过程中debug是必不可少的,如果你使用VS2017的话,右键就可以了,而作为跨平台的.net core开发的时候却要依赖VisualStudio,那一定算不上真正的跨平台,而且不是所有人都能买得起VS的许可证,买得起windows的授权,(我知道很多人都没买过:)所以这次来分享一下如何使用vscode在docker中debug。

我们知道vscode是可以远程debug的,参考OminiSharp的Wiki,其原理就是在服务器上安装.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.1

ENV TZ=Asia/Shanghai

RUN 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 ~/vsdbg

WORKDIR /app

VOLUME /app

ENV ASPNETCORE_ENVIRONMENT Development

ENTRYPOINT ["dotnet", "Web.dll"]

最近.net core 2.0 发布了,这里的需要做一些更新,如下:

FROM microsoft/aspnetcore:2.0 /*更新到2.0的镜像*/

LABEL Name=aspnetcore-debug Version=latest

ENV TZ=Asia/Shanghai

RUN 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 /app

VOLUME /app

在vscode中项目根目录下的.vscode文件夹中的lunch.jsonconfigurations节点中追加一个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

F5进入Debug模式,在程序中设置一个断点,当程序运行到这里的时候就变黄了,

和VisualStudio一摸一样。

当然也可以不用单独build这个容器,直接放在之前讲的docker-compose中,效果也是一样的。

posted @ 2017-07-11 16:42  蝌蝌  阅读(12802)  评论(1编辑  收藏  举报