Docker + ASP.NET Core 远程调试
2018-06-04
开发
- 开发环境：VS2017，VSCode也可以
- 本地：Win10 + Docker CE
- 远端：Server 2016 或者 CentOS 7.4，Ubuntu 18.04 也行。
- Code Demo，放在Github
- Test:
http://localhost:5000/api/values - Return:
["value1","value2"]
- Test:
- 开发时，可以先正常创建ASP.NET或者ASP.NET Core项目，然后再添加Docker Support。Debug按钮后面使用
IISExpress还是Docker，取决于Solution的Start Project是ASP.NET/ASP.NET Core项目，还是Docker-Composer。 - Dockerfile中，Asp.net的官方Base Image默认是
FROM microsoft/aspnetcore:2.0，这里取决于docker-compose.dcproj文件，DockerTargetOS是Linux还是Windows，类似这样<DockerTargetOS>Linux</DockerTargetOS>。如果DockerTargetOS是Windows，默认是Nano，反之，是Debian9，Stretch。参考。注意，Latest images for 2.1 and newer are now available on microsoft/dotnet.
部署
- 如果不涉及Docker，Windows环境中可以使用 WebDeploy 推送到VM上，参考官方文档。
- 涉及Docker，推荐通过Docker Hub，或者Private Registery Server。Docker Hub需要Create Account，如果在创建用户时Signup按钮一直是灰色的不能点击，请翻墙，XXX。
- 将Docker Image上传到Docker Hub或者Private Hub后，可以在远程服务器（Win/Linux）上Pull下来Run，这样就完成了部署。
- VS Deployment: Container Registry: Docker Hub
- Publish
- Then on CentOS, pull:
sudo docker pull maodouzi/aspdotnetcorewebapi: 20180605014624, not latest - Then run:
sudo docker run -p 8080:80 -p 8081:22 -it maodouzi/aspdotnetcorewebapi:20180605014624, remember open 8080/8081 ACL in Azure portal.
- 也可以将编译好的DLL发送到Remote Linux Server，在Linux Server上完成Docker Build工作，参考这里。
本地调试
- Win10 Docker CE非常方便，可以在Linux Container和Win Container之间切换，方法参考这里。
- Browser访问的起始路径在
docker-compose.dcproj文件中定义：<DockerServiceUrl>{Scheme}://localhost:{ServicePort}/api/values</DockerServiceUrl> - 参考：官方视频教程
- 参考：官方调试文档
远程调试
- 对Win-Docker，远程调试可以参考：Github文档
- 对Linux-Docker环境，远程调试的原理是在Docker Container上开一个SSH端口，VS通过SSH端口Attach到对应的进程，借助vs-debugger完成调试，参考文档。
- 注意事项1：SSH端口，首先确保Docker Container上可以SSH登录；其次，VS上进行配置，先创建RemoteConnection, Tools > Options > Crossplatform > Connection Manager ，参考StackOverflow。配置完成后，可以在VS上Attach Process，选Remote/SSH即可，参考文档。
- 注意事项2：Portalable PDB，参考文档，在ASP.NET Core的.csproj文件里添加
<DebugType>portable</DebugType>，参考文档。完整的写法见Demo，参考了StackOverflow，针对SSH/Root/Passwd部分略作修改。 - 注意事项3：如果在设置断点时报错：
The breakpoint will not currently be hit. No symbols have been loaded for this document.，参考MSDN Forum，我选了”Enable .NET Framework Source Stepping”，从而自动Disable了”Enable Just My Code”，就可以远程调试了。 - 我的远程Docker主机在Azure的东亚服务器上，受限于距离和网速，远程调试起来非常慢，Sigh。
