本章节代码已经上传至 https://github.com/siegrainwong/.NET-Core-with-Docker/tree/master/Part3
系列大纲
这次我们讲第三篇:
用 docker-compose 启动 WebApi 和 SQL Server
在容器中集成 Skywalking APM
通过 nginx-proxy 对 Portainer、Skywalking、WebApi 实现自动反向代理和 HTTPS
通过 Azure DevOps 进行 CI/CD 和蓝绿发布
本章的东西很简单,没有特定的故障排除章节。
这里先纠正一个之前在大纲上的笔误,之前本章的标题其实是通过 nginx-proxy 对 ES、Skywalking、WebApi 实现自动反向代理和 HTTPS,ES 是错的,ES 没啥好反代的因为它不需要外网访问,这里是纯笔误,需要反代的是 Portainer。
经过我们第一章、第二章的学习,docker-compsoe
的对外服务已经有了两个,经过本章新加的 Portainer 后会达到三个,这时候就会有个问题,能不能用一个统一的服务器来管理这些外网入口,从而在负载均衡、安全性、隔离性等问题上都有所保证?
答案就是用 nginx 反向代理,但 nginx 配置写起来也挺麻烦的,有没有能根据 docker-compose 上的配置自动生成 nginx 配置的东西?答案就是 nginx-proxy 。
除此之外,nginx-proxy 还能自动帮你从 Let's Encrypt 上申请免费的 HTTPS 证书,简直是不要太好用,不过因为申请证书要验证网站所有权,你的服务器必须要被外网访问到才行,所以这一章只能先配置好,效果是看不到的。
集成 Portainer
我们现在的容器经过这几章后会“膨胀”到七个或者更多,每次都通过命令来查看容器的状态太麻烦,效率也低,那么 Portainer 就成了解放双手的好工具了。
我们先把上一章在 docker-compose.yml 中注释掉的 webapi 放出来,因为本章不需要改 webapi 的代码。
接下来,Portainer 的集成肥肠简单,在 docker-compose.yml 中添加一个 service 多挂载个 volume 就行了:
# another services... portainer: image: portainer/portainer container_name: portainer command: -H unix:///var/run/docker.sock restart: always ports: - 9000:9000 volumes: - //var/run/docker.sock:/var/run/docker.sock - portainer_data:/datavolumes: # another volumes... portainer_data:
然后,在项目根目录执行docker-compose up -d
访问localhost:9000
,将出现如下的初始化界面:
进去之后,可以很方便的查看各个容器的情况、资源占用、日志、网络等信息,大家就进去多点两下就知道有多好使了。
集成 nginx-proxy
添加 docker-compose.prod.yml
看名字应该就知道,这是专门用于发布的 docker-compose 配置文件,因为我们开发阶段是不需要用到这个反向代理的。
在 docker-compose.yml 相同目录位置添加 docker-compose.prod.yml 文件
version: '3.3'services: coreapi: environment: VIRTUAL_HOST: coreapi.com VIRTUAL_PORT: 5000 sw-ui: environment: VIRTUAL_HOST: s.coreapi.com VIRTUAL_PORT: 8080 portainer: environment: VIRTUAL_HOST: d.coreapi.com VIRTUAL_PORT: 9000 nginx-proxy: container_name: nginx-proxy image: jwilder/nginx-proxy:alpine ports: - 80:80 - 443:443 volumes: - conf:/etc/nginx/conf.d - vhost:/etc/nginx/vhost.d - html:/usr/share/nginx/html - dhparam:/etc/nginx/dhparam - certs:/etc/nginx/certs:ro - /var/run/docker.sock:/tmp/docker.sockvolumes: conf: vhost: html: dhparam: certs:
新建 launch.prod.ps1 脚本
docker-compose -f docker-compose.yml -f docker-compose.prod.yml up -d
添加 docker-compose.dev.yml
在我们发布上线后,唯一对外的流量入口就只能有 nginx 反向代理,所以要把 docker 对于宿主机的映射端口都去掉,并转移到 docker-compose.dev.yml 中
docker-compose.yml:
version: '3.3'services: coreapi: container_name: coreapi image: siegrainwong/coreapi:latest depends_on: - sqlserver links: - sqlserver volumes: - ./Core.API/appsettings.docker.json:/app/appsettings.json:ro environment: ASPNETCORE_HOSTINGSTARTUPASSEMBLIES: SkyAPM.Agent.AspNetCore SKYWALKING__SERVICENAME: coreapi restart: always sqlserver: image: mcr.microsoft.com/mssql/server:2017-latest container_name: sqlserver restart: always environment: ACCEPT_EULA: Y MSSQL_PID: Developer SA_PASSWORD: 'NetCore123!@#' volumes: - coredata:/var/opt/mssql ports: - 1433 elasticsearch: image: wutang/elasticsearch-shanghai-zone:6.3.2 container_name: elasticsearch restart: always ports: - 9200 - 9300 environment: discovery.type: single-node ES_JAVA_OPTS: "-Xmx256m -Xms256m" ulimits: memlock: soft: -1 hard: -1 sw-oap: image: siegrainwong/skywalking-oap:6.1.0 container_name: sw-oap depends_on: - elasticsearch links: - elasticsearch restart: always ports: - 11800 - 12800 environment: SW_STORAGE: elasticsearch SW_STORAGE_ES_CLUSTER_NODES: elasticsearch:9200 sw-ui: image: apache/skywalking-ui:6.1.0 container_name: sw-ui depends_on: - sw-oap links: - sw-oap restart: always environment: SW_OAP_ADDRESS: sw-oap:12800 portainer: image: portainer/portainer container_name: portainer command: -H unix:///var/run/docker.sock restart: always volumes: - //var/run/docker.sock:/var/run/docker.sock - portainer_data:/datavolumes: coredata: portainer_data:
docker-compose.dev.yml:
version: "3.3"services: coreapi: ports: - 5000:5000 sw-ui: ports: - 8080:8080 portainer: ports: - 9000:9000
修改 launch.ps1,注意替换脚本中的路径哟。
docker-compose -f docker-compose.yml -f docker-compose.dev.yml up -ddocker run --rm -it ` -v F:\Projects\docker-netcore\Part3:/app/ ` -v F:\Projects\docker-netcore\Part3\Core.API\appsettings.docker.json:/app/Core.API/appsettings.Development.json:ro ` -p 5000:5000 ` --link sw-oap ` --link sqlserver ` --name coreapi_dev ` --network part3_default ` --env ASPNETCORE_HOSTINGSTARTUPASSEMBLIES=SkyAPM.Agent.AspNetCore ` --env SKYWALKING__SERVICENAME=coreapi ` -w /app/Core.API mcr.microsoft.com/dotnet/core/sdk:2.2-stretch dotnet watch run
执行 launch.prod.ps1 脚本
等待容器重新创建完毕,你会发现 localhost:9000、localhost:5000 等等都不能访问了,因为我们关掉了映射,现在只有 nginx 可以访问。
那么我们通过 curl 命令对 nginx 反代的服务进行访问,以下命令二选一:
# powershellcurl -H @{'Host' = 'coreapi.com'} localhost/api/values# cmdurl -H "Host: coreapi.com" localhost/api/values
如果你想查看生成出来的 nginx config 是什么样的,或者你想通过这个来排错,可以进入到 nginx-proxy 的控制台执行cat /etc/nginx/conf.d/default.conf
不出意外的话,此刻你已经将三个需要外部访问的容器全都通过 nginx 反代成功了。
配置 Let's Encrypt
这个配置也非常简单,所以虽然看不出效果,但我还是放在这一章来讲了,因为几乎不会有坑,或者说我的这个方法几乎不会有坑。
把 docker-compose.prod.yml 改成这样,添加了三个环境变量跟一个服务,注意几个加了注释的地方:
version: '3.3'services: coreapi: environment: VIRTUAL_HOST: coreapi.com VIRTUAL_PORT: 5000 LETSENCRYPT_HOST: yourdomain.com # <- your domain here sw-ui: environment: VIRTUAL_HOST: s.coreapi.com VIRTUAL_PORT: 8080 LETSENCRYPT_HOST: s.yourdomain.com # <- your domain here portainer: environment: VIRTUAL_HOST: d.coreapi.com VIRTUAL_PORT: 9000 LETSENCRYPT_HOST: d.yourdomain.com # <- your domain here nginx-proxy: container_name: nginx-proxy image: jwilder/nginx-proxy:alpine ports: - 80:80 - 443:443 volumes: - conf:/etc/nginx/conf.d - vhost:/etc/nginx/vhost.d - html:/usr/share/nginx/html - dhparam:/etc/nginx/dhparam - certs:/etc/nginx/certs:ro - /var/run/docker.sock:/tmp/docker.sock letsencrypt: # <- add letsencrypt service image: jrcs/letsencrypt-nginx-proxy-companion container_name: letsencrypt environment: DEFAULT_EMAIL: youremail@gmail.com # <- using your email address NGINX_PROXY_CONTAINER: nginx-proxy volumes: - conf:/etc/nginx/conf.d - vhost:/etc/nginx/vhost.d - html:/usr/share/nginx/html - dhparam:/etc/nginx/dhparam - certs:/etc/nginx/certs:rw - /var/run/docker.sock:/var/run/docker.sock:ro network_mode: bridgevolumes: conf: vhost: html: dhparam: certs:
这里的 yourdomain.com 顾名思义就是要修改成你的域名,letsencrypt 服务会在你的网站开始执行并能够被外网访问之后试图从 Let's Encrypt 根据你填写的 LETSENCRYPT_HOST 环境变量来申请证书。
需要注意的是每个月能申请的域名是有限的,所以不要乱写,然后没有发布到外网之前这个 compose file 我也不建议你执行 23333。
如果你自己有服务器那就自便了,具体方法是把 coreapi publish 到 dockerhub 或其他镜像服务器,将几个 compose 文件和脚本文件扔到服务器上跑就行了。
如果你还没有域名话就买一个,而且下一章会用到服务器,没有服务器的同学参照第一章开头的介绍来获取一个服务器,这里要说明的是我们要用的是 linux 的服务器,我个人使用的是 CentOS 7,配置要求单核,有个 4G 的内存就行了,因为 Skywalking 是 java 的那一套所以会比较吃内存(黑 java 成就达成)。
原文地址:https://siegrain.wang/article/2019/07/21/using-nginx-proxy-with-docker-compose
.NET社区新闻,深度好文,欢迎访问公众号文章汇总 http://www.csharpkit.com