老衣的微服务实践简要指引2017版
這是老衣在2017年5月份總結的，適用于中小團隊跨平臺微服務開發的實踐指引（簡化版）。若有有不當之處，歡迎指點更正
因本文涉及到大量第三方庫或工具，詳細學習和了解需要參考相關官方文檔。若您在使用Mac電腦，建議安裝使用Dash軟件下載查閱；其他操作系統上則考慮使用Chrome瀏覽器在http://devdocs.io/offline?上查閱文檔，值得一提的是該網頁的文檔支持離線模式。
環境準備
全局必要項
node.js?可根據實際情況選擇安裝當前版或是長期支持版
docker最新版?根據實際需要決定使用免費的Docker CE版或是收費的Docker EE版。注意?Windows 10 64位專業版和64位企業版可以直接安裝（依賴hyper-v），其他舊版Windows，需要使用docker toolbox。
根據自己的喜好選擇安裝下列Git客戶端:
git scm
Source Tree
TortoiseGit?僅支持Windows
SmartGit
全局可選項
lua 最新版
python最新版
.NET Core 1.1或以上
開發環境
Visual Studio 2017：僅支持Windows系統
Visual Studio for MAC：故名思議，僅支持Mac系統
Visual Studio Code，跨平臺代碼編輯器。建議至少安裝以下擴展，其他擴展由團隊根據使用的開發語言和相關工具鏈自行決定是否安裝：
Docker?：支持DockerFile的加亮和智能提示
Angular 1 JavaScript and TypeScript Snippets for VS Code?：支持angular1.x的一些代碼片段和智能提示
Azure Extension Pack?：微軟官方出品的在VSCode中處理Azure相關功能的一些擴展
Azure Tools for Visual Studio Code?：一些方便在VSCode使用的Azure工具
Beautify?：代碼格式整理插件
Bootstrap 3 Snippets?：bootstrap框架的代碼片段
Bower?：Bower的VSCode擴展
C# Extensions?：增加一些C#開發時的功能
C# XML Documentation Comments?：支持C#的///注釋
Can I Use?：檢查當前行的CSS屬性兼容的瀏覽器版本
HTML CSS Support?：支持各種Web語言（html、Razor、Vue、pug、php等）
Icon Fonts?：字體圖標(例如Font Awesome)的樣式支持
Lua linter?：支持Lua語言智能提示和語法檢查等
mssql?：可在VSCode中方便使用微軟SQL Server數據庫
nginx.conf?：支持nginx配置文件的代碼加亮
Python?：支持Python的智能提示和代碼格式化等功能
yo?：將前端項目模板工具Yo的相關命令內置到VSCode
Web前端開發相關工具：
Yeoman，簡稱Yo?- 前端項目模板工具，可以快速搭建前端項目模板
Bower?- 前端包管理工具，類似于Visual Studio種的Nuget
用于打包發布的工具:?Grunt、Gulp、webpack?中的至少一種，看個人喜歡或團隊熟悉度
動態CSS語言:?LESS、SASS?根據團隊需要選擇其一
Angular 1.x?適用于企業管理等相關用戶場景的開發，因為其對IE瀏覽器支持的版本相對較低，適用面較廣
后端數據庫，建議向跨平臺的數據庫種類傾斜，比如MySQL、PostgreSQL，甚至是一些NOSQL數據庫：MongoDB。微軟的SQL Server 2017支持Linux和Docker，目前尚處于預覽版狀態，不建議在生產環境使用，等官方正式版發布后再嘗試使用。PostgreSQL數據庫對SQL標準的語法支持非常完整，建議更多考慮。
代碼托管環境
為了最大限度提功開發部署靈活性，建議使用Git方式托管。所以可根據實際情況選擇下列之一：
支持Git庫的TFS
GitHub?私有庫或企業版
Coding.net?私有庫或企業版
開源免費，私有部署的Gogs，具有豐富的認證方式選擇，并支持Slack平臺的WebHook
GitLab?可托管部署或私有部署
建議在以上任何一種git服務中，建立或使用一個支持證書登錄的用戶，該證書用于構建環境自動拉取代碼時使用，不建議使用賬號密碼方式，因為安全性較差。該證書對應的用戶應該有所有需要自動構建的代碼庫讀權限。不建議給該用戶開放寫權限，避免一些潛在安全問題和代碼沖突問題
構建環境
構建環境是專門用來自動化、編譯、集成、測試、打包、發布的環境，建議使用獨立的計算機和服務器做為構建環境。因為該環境對代碼和測試、生產環境都有較高的權限，也會涉及到大量的安全證書或密鑰等極敏感信息，所以強烈建議該環境所在設備僅限極少數高度可信賴的人訪問管理，并有嚴格的安全規定，不允許隨便安裝軟件或向外復制數據
建議使用linux作為構建環境的操作系統，因為windows的命令行工具能力有限。并確保安裝如下工具：
Node.js?我們需要依賴很多nodejs工具鏈，所以這是必須安裝的。通過下列命令確認是否安裝，以及什么版本
node --version還需要確認npm是否安裝：
npm --versionnpm安裝新版，可以通過自更新實現
npm install -g npmShellJS?是在Node.js API之上的便攜式(Windows/Linux/OS X)Unix Shell命令實現，可以消除或減少您的Shell腳本對特定操作系統的依賴。通過下面的命令全局安裝
npm install -g shelljs老衣的實踐是利用shelljs的腳本能力以及js語言的豐富特性和靈活度，通過編寫腳本的方式結合其他工具或平臺實現編譯、測試、打包、發布、通知等的自動化處理
Docker?幾乎是微服務架構的必需品，我們通過Docker隔離和構建相關的服務，通過下列命令確認是否安裝，以及什么版本
docker --versiongit?確保安裝使用了最新的git命令行客戶端,可通過下列命令確認是否安裝，以及什么版本
git --versionPython?很多輔助工具是用python開發的，所以有備無患，通過下列命令確認是否安裝，以及什么版本
python --versionMono?是跨平臺的.NET框架實現，目前5.0以上版本已經完整匹配.NET 4.6.2的API集，幾乎除了Windows平臺特有的API外，Mono和.NET框架幾乎是完全兼容的。所以如果你的微服務是用的.NET開發的，這是必須安裝的——當然如果你只打算在Windows上用，可以不安裝這個。通過下列命令確認是否安裝，以及什么版本
mono --version.NET Core?如果你的微服務有用的.NET Core開發的，這是必須安裝的。通過下列命令確認是否安裝，以及什么版本
dotnet --versionCake?是C# Make的縮寫，是一個基于C# DSL的跨平臺自動化構建系統。它可以用來編譯代碼，復制文件以及文件夾，運行單元測試，壓縮文件以及構建Nuget包等等。
TeamCity、Jenkins?這兩個是獨立的自動構建服務器軟件，如果不愿意使用shelljs之類的腳本自行編寫構建任務，可以通過他們在管理界面上設置，不過學習成本和復雜度蠻高的，如果團隊內沒有人熟悉這兩個工具，早期不建議使用。
其他語言的基礎框架根據實際的每個微服務所使用的語言環境決定安裝哪些基礎支持工具、框架、模塊等
自動構建服務，在拉取代碼、獲取依賴包、編譯、測試、打包、發布等各個環節都可能會發生錯誤或異常，而編譯不通過或測試不通過等情況也應該第一時間跟團隊或項目管理者報告，我們在實踐中更推薦使用Slack來實現,實現方式請參考官方文檔?https://api.slack.com/incoming-webhooks，絕大部分情況下1-3行代碼即可實現，非常方便，當然了這里有個小問題Slack的所有客戶端（web、手機App、桌面應用等）都沒有中文版。當然了你愿意使用電子郵件或企業微信或微信服務號來實現也可以，只是實現成本和效果跟Slack比完全不在一個級別上。注意：Slack的webhook地址通常類似于https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX?這屬于保密的地址，不應該在公開的文檔或代碼中體現，否則容易在Slack的相關頻道中產生虛假的信息，切記！！！
當然了上述構建所需到基礎依賴，也可以在準備好到Docker容器中做，可減少不同服務對基礎依賴（比如php、java、nodejs等）版本不同而帶來的構建沖突。早期團隊可通過技術選型很大程度上避免基礎依賴沖突，所以可先不考慮使用大量Docker容器隔離不同到構建環境，待團隊逐漸成熟壯大后，可根據需要慢慢向這個方式靠攏。
我們在實踐中更傾向于使用Docker構建相應的鏡像來部署最終的微服務，所以需要一些必要的基礎鏡像提前做準備。推薦安裝如下鏡像：
docker pull alpine docker pull busybox docker pull centos docker pull ubuntu docker pull postgres docker pull microsoft/dotnet docker pull microsoft/aspnetcore docker pull mono docker pull node docker pull golang docker pull mongo docker pull mysql docker pull redis docker pull rabbitmq docker pull memcached docker pull nginx docker pull openresty/openresty以上鏡像，如果需要安裝特定版本，可通過加tag參數來獲取對應版本的鏡像。特別一提的是其中alpine和busybox都是使用廣泛的超小型基礎鏡像，大小僅有幾M而已，對最終鏡像大小很敏感的可考慮使用這些鏡像作為基礎。
通過下列命令可在部署環境中確認上述鏡像是否已經pull到：
docker images私有Docker Registry服務器
Docker Store上已經有大量官方鏡像和公開鏡像，可供參考使用，但通常我們自己到私有服務的鏡像是不希望公開讓別人下載使用的。所以需要搭建自己的鏡像庫，所以我們需要使用Docker Registry來搭建自己的私有鏡像庫。
注意：新版到registry要求必須使用https協議，所以搭建時需要考慮購買或使用免費的SSL證書。目前國內的騰訊云和阿里云貌似都有免費一年到二級域名證書，可考慮使用。
使用私有的Docker Registry服務后，每次構建好的服務鏡像都是先push到私有服務上，然后再在生產環境中pull最新版，并部署使用。
測試&&生產環境
測試或生產環境，基本上僅需要安裝Docker，通過相關的命令來拉取相關鏡像，并部署或維護所需服務的容器即可。單服務器上多個微服務如果有依賴關系或啟動先后順序等要求時，建議使用Docker Compose對微服務的相關容器進行編排。是否使用Docker Swarm來做集群化編排更新則由實際業務要求和團隊對Docker的熟練度來決定。
需要特別指出的是關于數據庫的處理，微服務架構通常強調服務的無狀態化，其中原因主要是為了服務的可復制性和可遷移性，所以目前的主流實踐是，數據庫在正式生產環境時，使用公有云的獨立數據庫服務或自己機房的獨立數據庫服務器的數據庫，不建議使用容器作為數據庫的宿主——但測試環境可以根據情況考慮使用，以方便模擬和測試各種情況。
生產環境的服務發現，考慮使用分布式服務發現和配置工具Consul。但如果微服務整體全部都是基于Docker的，而且集群使用等Docker Swarm實現的，那么就不必使用其他工具來做服務發現了，因為docker swarm內置了服務發現機制。
開發過程
根據業務和系統架構，拆分微服務
為每個微服務設計 RESTful Web API的文檔，建議使用API Designer工具，借助于RAML語言設計API
根據API設計文檔，使用json-server來編寫API的Mockup
Web前端或App通過調用mock出來的api開發相關功能頁面，同時后端人員根據API設計文檔開發后端API，測試人員則根據設計文檔和mockup版的API表現編寫自動化測試腳本
構建服務定期從git服務器上拉取最新代碼，根據項目的定義自動編譯、測試相關微服務，并通過Slack通知團隊或項目負責人；
構建服務在編譯和測試都通過后，通過腳本自動構建Docker鏡像，然后push到私有的docker鏡像庫中，并通過Slack通知團隊或項目負責人；
測試&&生產環境根據提前編寫好的腳本，自動從私有鏡像庫中拉取最新版的服務鏡像，部署運行對應的新服務
注意事項：
期間測試人員通過編寫的自動化API測試腳本不斷驗證服務的最終表現是否正確，不正確的不應該進入生產環境
單元測試是開發人員自行編寫的，但是需要明確測試的命令行調用方式，以便構建服務器能夠不停的測試驗證代碼
每個用到數據庫的微服務都應該具備數據庫的自動化遷移能力，比如新增的表在服務啟動時應該會自動創建，而如果服務回滾到舊版本時必須能夠將數據庫對應回滾到原來的結構，比如刪除增加的表或字段等。
前后端應該完全隔離在不同的鏡像中，在服務的總出口處（通常是nginx之類帶有反向代理的服務器）將api和頁面集成到同一域名下
生產環境盡可能利用nginx服務器的熱部署和熱更新能力
API的自動化測試，可通過如下nodejs工具開發測試腳本：
chakram
mock
mochajs
實際演練
微服務有幾個要點：
功能獨立
獨立部署
獨立進程
可替換性
功能獨立容易理解，而難度是整體服務如何合理拆分，其基本原則就是看該服務的數據是否需要關聯另外一個服務的數據表才能查出，如果是則應該合并到一個服務中，否則可獨立拆分；獨立部署和獨立進程?告訴我們，每個服務運行在獨立的進程或服務器中，每個服務都應該可以獨立部署，且不應該影響其他服務的運行；可替換性，則是說每個服務都應該可以隨時用任何編程語言重新實現并替換掉舊有的服務而不會影響其他服務和整體系統的正常運行。
鑒于每個微服務都可能隨時更新，為了保證整體系統運行的穩定性，我們需要至少做到如下幾點：
每個微服務的更新過程都要足夠的快，要盡可能在1秒內完成，以便減少服務更新時出現的各種異常
每個微服務調用其他服務時最后都具備retry機制，以便在調用到的另外一個微服務出現短期故障（比如更新服務）時，能夠具備過一點時間后再訪問的能力，這樣最前端的用戶或者服務調用者會認為當前的服務調用速度只是比原來慢了而已
集中的日志收集服務，可以通過該服務的界面上查看到各個微服務的日志，以便團隊或項目領導者能夠及時了解和分析系統的運行狀態，及時發現和修復各種問題異常
微服務架構的復雜性決定了微服務總體出現異常的幾率比單體系統要多，所以單元測試和集成測試變得極其重要，甚至可以說是必須的
每個微服務對外的服務接口（如WebAPI），應該都是具備普適性、自釋性、可預見性、明確性的。也就是：
每個微服務的對外接口實現可以不依賴于任何特定的語言
每個微服務調用另外一個服務時，都應該是盡可能使用通用的通信協議，而不是私有的，避免跨語言實現的難度，即通暢是使用HTTP協議
每個服務的最終路由地址是不可隨意變更的
每個服務的路徑自身就是其功能的最簡說明
通過一個api地址就能較為準確的猜出另外一個服務的地址和訪問方式
基于以上觀點，并假定我們大部分的微服務都使用.NET、Mono或.NET Core編寫，那么如下相關的庫和組件則應該是必須的或優先考量的：
NancyFx?這是一個非常優秀的Web框架，獨立于ASP.NET以外，也就是說他自身不依賴System.Web命名空間下的任何東西。具有極好的跨平臺支持能力和極佳的可測試性、組件可替換性、路由可視性。用它編寫微服務，會讓開發過程變得很簡單。當然如果你實在不喜歡這套框架的風格，依然可以選用ASP.NET、ASP.NET MVC、ASP.NET Core等相對傳統的技術，畢竟這并不影響微服務實現的本身。
Flurl?這是一個新出現的優雅的的Http客戶端庫，它依然基于HttpClient，但是提供了Fluent風格的編程模型，所以寫代碼時會比傳統方式要爽快和高效的多。雖然RestSharp也是一個很優秀的WebAPI訪問庫，但是它目前不支持.NET Core等框架，所以跨平臺能力欠佳。
xUnit.net?這是NUnit.net原作者幾年前重新打造的一個.NET平臺的單元測試框架，具有豐富的工具鏈。微軟官方的ASP.NET MVC等框架也都使用的該框架編寫的所有單元測試，而沒有采用微軟自家的單元測試框架。
KestrelHttpServer?這是微軟官方實現的ASP.NET Core的Host服務器框架，可以實現極高性能的SelfHost服務，而不必依賴IIS。
TinyMapper?比老牌的AutoMapper具有更佳的性能（大概快60倍），而且老衣也曾貢獻了部分代碼增加了一些特性。不過目前對.NET Core支持方面還有點瑕疵，但可以在.NET項目中大規模使用。
Mapster?它跟TinyMapper一樣是新型的Mapper庫，號稱快速、有趣且激動人心的Mapper，老衣目前在.NET Core項目中主要采用這個作為主要的Mapper庫。
Json.NET?.NET平臺下最流行的高性能（但不是最快的）JSON庫。
Polly?是.NET平臺下,讓開發者可以輕松實現線程安全的重試、熔斷、超時代碼，大幅提升應用穩定性的絕對利器
C-Sharp-Promise?Promise在js開發領域大行其道，深得開發者們的喜愛。C#程序員們可以用C-Sharp-Promise，使用Promise的方式編程。一些時候你會發現它比async的方式更好
Topshelf?當你需要將一個.NET的Console或者桌面應用，作為Windows服務運行時，它會很好的幫到你。它還支持Mono，也就是說可以在Linux上玩
Dapper?輕量級的通用ORM,支持市面上大多數關系型數據庫。兼容.NET、Mono和.NET Core
在.NET Core上使用Nancy創建一個Hello World級的微服務
先確保node.js和npm已安裝
node --version npm --version如果上述命令顯示未安裝node.js，請到Node.js官網下載對應操作系統的版本，并安裝好。
確保yeoman已經安裝
yo --version如果上述命令未輸出版本號，提示yo命令不存在則，應該使用下面到命令安裝它
npm install -g yo確保generator-aspnet已經安裝
yo aspnet如果上述命令提示未安裝一個名叫aspnet的generator,則需要使用下面到命令安裝generator-aspnet
npm install -g generator-aspnet上一步命令正常會輸出如下結果
? ? _-----_ ? ? ╭──────────────────────────╮| ? ? ? | ? ?│ ? ? ?Welcome to the ? ? ?│|--(o)--| ? ?│ ?marvellous ASP.NET Core │`---------′ ? │ ? ? ? ?generator! ? ? ? ?│( _′U`_ ) ? ?╰──────────────────────────╯/___A___\ ? /| ?~ ?|__'.___.'__′ ? ` ?|° ′ Y `? What type of application do you want to create? (Use arrow keys) ? Empty Web ApplicationEmpty Web Application (F#)Console ApplicationConsole Application (F#)Web ApplicationWeb Application Basic [without Membership and Authorization]Web Application Basic [without Membership and Authorization] (F#) (Move up and down to reveal more choices)按鍵盤的?鍵，直到?出現在Nancy ASP.NET Application這一行后，按回車鍵
在? What's the name of your ASP.NET application? (NancyApplication)后面輸入你的服務的名字（比如：hi）后回車。
提示: 由于這個名字會出現在代碼中，所以請使用類似C#變量的命名規范輸入，不要使用任何中文字符或-，也不要是純數字。
假設上一步輸入的名字是hi，使用下列命令進入hi目錄,并使用Visual Studio Code打開該目錄
cd hi code .用Visual Studio Code打開后，查看修改global.json文件中的sdk version為最新安裝的.NET Core SDK的版本。如果不知道當前安裝的.NET Core SDK是什么版本，可通過執行下列命令查看
dotnet --version如果你安裝的是1.0.4版，則此時應該會看到結果是1.0.4。
此時把global.json文件中version后面的版本號，改為剛才命令中輸出的版本號（例如1.0.4）。
查看hi.csproj文件中的TargetFramework節點的值，如果你打算使用.NET Core 1.0則應該是netcoreapp1.0,如果打算使用.NET Core 1.1則應該是netcoreapp1.1。你還需要根據自己選擇版本修改Nuget引用的相關庫的版本。還要修改AssemblyName的值為你期望的程序集名，通常我們跟服務名一致，本例中應該是hi
這里我們使用.NET Core 1.1版來開發，那么此時應該將hi.csproj文件的內容調整為如下：
<Project ToolsVersion="15.0" ?Sdk="Microsoft.NET.Sdk.Web"><PropertyGroup><TargetFramework>netcoreapp1.1</TargetFramework><DebugType>portable</DebugType><AssemblyName>hi</AssemblyName><OutputType>Exe</OutputType></PropertyGroup><ItemGroup><PackageReference Include="Microsoft.AspNetCore.Hosting" Version="1.1.2" /><PackageReference Include="Microsoft.AspNetCore.Server.Kestrel" Version="1.1.2" /><PackageReference Include="Microsoft.AspNetCore.Owin" Version="1.1.2" /><PackageReference Include="Nancy" Version="2.0.0-clinteastwood" /></ItemGroup></Project>注意：?Nancy的版本號應該使用最新支持.NET Core的版本。2.0.0-clinteastwood是編寫此文時的NancyFx最新版。實際操練時需要根據新的情況對應修改。
執行下列命令，加載依賴包、編譯并運行這個hi服務
dotnet restore dotnet build dotnet run會看到如下結果
Hosting environment: ProductionContent root path: /Users/yimingzhi/Projects/wang/hiNow listening on: http://localhost:5000Application started. Press Ctrl+C to shut down.在瀏覽器中訪問http://localhost:5000地址，可以看到Hello from Nancy running on CoreCLR。
這樣一個最簡單的Hellow World級的微服務已經開發完成。其中HomeModule.cs文件就是這個服務的核心邏輯代碼：
namespace hi {using Nancy;public class HomeModule : NancyModule{public HomeModule(){Get("/", args => "Hello from Nancy running on CoreCLR");}} }是不是非常簡單呢?_
目前這個服務看起來很美，但是存在如下問題：
因此我們需要借助Docker這個容器工具來解決它，如果你不確定是否安裝了docker，請運行下面的命令確認
docker --version當然你也可以通過
docker info查看docker的一些信息,還可以通過
docker images查看已經pull到本地的docker鏡像列表，需要確認.NET Core的1.1.2運行時（編寫此文時的最新版本）鏡像是否存在,如果不存在請使用下列命令拉取鏡像:
docker pull microsoft/dotnet:1.1.2-runtime拉取完畢后我們就可以準備構建hi服務的docker鏡像了
需要運行主機上安裝.NET Core的sdk或者運行時
如果多個服務用的不同版本的.NET Core則可能會出現版本沖突等問題
部署起來比較麻煩，需要用ftp、rdp、ssh或rsync等工具部署大量文件
基本不具備規模化橫向部署能力，比如一次性部署100個節點
一旦服務崩潰或其他異常退出時，無法自動重啟
在hi目錄下創建一個名字為Dockerfile的文件——注意：這個文件名是區分大小寫并沒有任何擴展名的
用Visual Studio 2017或Visual Studio Code打開剛才創建的Dockerfile文件，并將以下內容寫入并保存：
FROM microsoft/dotnet:1.1.2-runtime ENV TZ=Asia/Shanghai COPY ./dist /app WORKDIR /app EXPOSE 5000/tcp ENTRYPOINT ["dotnet","./hi.dll"]提示：
ENV TZ Asia/Shanghai?表示該鏡像的容器默認的運行時時區為上海時區，這對于大陸的服務來說至關重要，不加這行默認情況一般都是UTC時間，切記?EXPOSE 5000/tcp?表示該鏡像的容器默認向外暴露5000端口，這里就是hi服務的默認端口?ENTRYPOINT ["dotnet","./hi.dll"]?中的hi.dll，為服務的主運行程序，不同服務這個地方會有所不同
之所以使用runtime版的基礎鏡像而不是sdk版，是因為sdk版的鏡像太大（大了幾百兆），對publish后的.NET Core應用也是沒有必要的。
在hi目錄下運行下面的一組命令構建正式發布版的hi服務鏡像
dotnet restore dotnet build -c Release dotnet publish -c Release -o dist docker build -t hi .使用docker images命令查看是否有名為hi的鏡像出現在列表中。如果沒有，請檢查上面的這組命令是否輸出了什么錯誤信息，修改代碼并重新執行上面這組命令，直到docker鏡像列表中有名為hi的鏡像出現為止。
提示
上面這組命令中hi服務被發布在dist目錄中，因此需要在.gitignore中將dist目錄設置為忽略項，不做版本控制。
通過下面的命令執行hi鏡像：
docker run --name hiServ --rm -p 5000:5000 hi此時會收到如下結果:
Hosting environment: ProductionContent root path: /appNow listening on: http://localhost:5000Application started. Press Ctrl+C to shut down.第1行告訴你運行環境是產品環境還是開發環境；第3行意思是你可以通過訪問本機的http://localhost:5000看到結果。但是這時候我們在瀏覽器中訪問http://localhost:5000，會提示你:無法訪問此網站。
在另外一個控制臺窗口(Windows下叫命令行窗口)中運行下面的命令進入容器：
docker exec -it hiServ bash運行命令:
curl http://localhost:5000/此時會看到輸出結果為Hello from Nancy running on CoreCLR,這說明hi服務可從內容內訪問，是容器外無法訪問。
輸入exit命令退出容器
打開Program.cs文件，在.UseKestrel()下插入一行新代碼.UseUrls("http://*:5000/")，即Program.cs的代碼變為：
namespace hi {using System.IO;using Microsoft.AspNetCore.Hosting; ? ?public class Program{ ? ? ? ?public static void Main(string[] args){var host = new WebHostBuilder() ? ? ? ? ? ? ? ?.UseContentRoot(Directory.GetCurrentDirectory()) ? ? ? ? ? ? ? ?.UseKestrel() ? ? ? ? ? ? ? ?.UseUrls("http://*:5000/") ? ? ? ? ? ? ? ?.UseStartup<Startup>() ? ? ? ? ? ? ? ?.Build();host.Run();}} }再次運行下面這組命令,重新構建hi服務的鏡像：
dotnet restore dotnet build -c Release dotnet publish -c Release -o dist docker build -t hi .運行下面的命令臨時將hi鏡像以名為hiServ的容器運行：
docker run --name hiServ --rm -p 5000:5000 hi打開瀏覽器，訪問http://localhost:5000/,看到了Hello from Nancy running on CoreCLR。
這樣我們的hi服務容器鏡像就算成功了。
提示
docker run --name hiServ --rm -p 5000:5000 hi?中的--name hiServ是為容器起一個特定名字hiServ;?--rm是讓這個容器在退出時立即刪除;?-p 5000:5000?是為了將容器的5000端口映射到當前主機的5000端口上，以便在真機中可以測試訪問這個服務。 最終生產環境中不會以當前用戶的前置進程方式運行，否則用戶退出時容器就會結束運行。所以我們通常會額外附加-d參數讓服務在后臺執行，詳情請參考Docker CLI的官方文檔。
將hi服務增加數據有關的API
前面，我們演示了如何使用docker將一個.NET Core跑起來。下面為hi服務增加幾個復雜的API
增加一個服務狀態的api
在hi這個項目中增加一個新文件StatusModule.cs,內容如下
namespace hi{using Nancy; ? ?using System; ? ?public class StatusModule : NancyModule{public StatusModule(){Get("/status", _ =>{ ? ? ? ? ? ? ? ?return new{running = true,time = DateTime.Now};});}} }用下面的一組命令運行起hi服務：
dotnet restore dotnet build dotnet run用postman或非windows系統的命令行工具curl，訪問http://localhost:5000/status，會收到一個json數據，類似于：
{"running": true,"time": "2017-05-16T18:03:34.4867970+08:00"}但是，如果你用瀏覽器訪問http://localhost:5000/status你會收到一個錯誤頁，標題是500 - Internal Server Error，不過你看不到錯誤內容——讓你改一下代碼才能看到錯誤。
在hi目錄中新建一個文件Bootstrapper.cs，內容如下：
namespace hi{using Nancy; ? ?public class Bootstrapper : DefaultNancyBootstrapper{public override void Configure(Nancy.Configuration.INancyEnvironment environment){#if DEBUGenvironment.Tracing(enabled: false, displayErrorTraces: true);#endif}} }再次編譯運行，
dotnet restore dotnet build dotnet run用瀏覽器訪問http://localhost:5000/status，會看到一個很詳細的Nancy.ViewEngines.ViewNotFoundException異常報告，意思是找不到名為><f__AnonymousType0'2的任何視圖文件。
這其實是Nancy框架的一個特性，他可以實現一個地址即是webapi又是網頁，其具體的原理就是判斷當前請求的Content-Type中是否以text/html開頭，如果是說明當前請求是一個瀏覽器，那么Nancy就會使用當前地址返回的model類型名作為視圖名查找視圖文件，找到了就用類似于mvc的方式顯示視圖頁面，如果找不到就報錯。
如果我們不希望用這個特性，就是期望該地址永遠返回一個json數據，則需要使用Response.AsJson方法。StatusModule.cs應該修改為：
namespace hi{using Nancy; ? ?using System; ? ?public class StatusModule : NancyModule{public StatusModule(){Get("/status", _ =>{ ? ? ? ? ? ? ? ?return Response.AsJson(new{running = true,time = DateTime.Now});});}} }再次編譯運行，
dotnet restore dotnet build dotnet run用瀏覽器訪問http://localhost:5000/status，我們會看到與在postman看到的一樣漂亮的json數據。Great！
準備一個數據庫，為了跨平臺我們選擇PostgreSQL數據庫。當然了在計算機上安裝一個數據庫是很麻煩的事情，這里我們用Docker直接用官方的postgres鏡像運行起一個容器即可。執行下列命令：
docker run --name pgdb -e POSTGRES_PASSWORD=123456 -p 5432:5432 -d postgres此時我們就準備好了一個postgres數據庫，賬號是postgres，密碼是123456，并可以通過本機的5432端口訪問到它。你可以使用pgAdmin鏈接并管理這個數據庫，老衣假定你已經學會使用pgAdmin的基本功能，才繼續下面的演練的。
使用pgAdmin在pgdb這個數據庫容器中創建一個新的數據庫hiDB
在hi項目上，從Nuget引用最新版的Npgsql，先在Bootstrapper.cs中通過Nancy自帶的容器注冊一個數據庫連接：
namespace hi{using System.Data; ? ?using Nancy; ? ?public class Bootstrapper : DefaultNancyBootstrapper{public override void Configure(Nancy.Configuration.INancyEnvironment environment){#if DEBUGenvironment.Tracing(enabled: false, displayErrorTraces: true);#endif} ? ? ? ?protected override void ConfigureApplicationContainer(Nancy.TinyIoc.TinyIoCContainer container){base.ConfigureApplicationContainer(container);container.Register<IDbConnection>((c, p) =>{ ? ? ? ? ? ? ? ?return new Npgsql.NpgsqlConnection("Host=localhost;Username=postgres;Password=123456;Database=hiDB;Timeout=3");});}} }然后增加一個DbConnectExtensions.cs文件，代碼：
using System.Data;namespace hi { ? ?public static class DbConnectExtensions{ ? ? ? ?public static bool IsConnectable(this IDbConnection conn){ ? ? ? ? ?bool connectable = false; ? ? ? ? ?try{conn.Open();var cmd = conn.CreateCommand();cmd.CommandText = "select 1;"; ? ? ? ? ? ? ?int r = (int)cmd.ExecuteScalar();connectable = r == 1;} ? ? ? ? ?catch{connectable = false;} ? ? ? ? ?finally{ ? ? ? ? ? ? ?if (conn.State == ConnectionState.Open){conn.Close();}} ? ? ? ? ?return connectable;}} }之后在StatusModule.cs中增加數據庫可連接性的狀態檢測，代碼如下：
namespace hi{using System; ? ?using System.Data; ? ?using Nancy; ? ?public class StatusModule : NancyModule{public StatusModule(IDbConnection conn){Get("/status", _ =>{ ? ? ? ? ? ? ? ?return Response.AsJson(new{running = true,dbConnectable = conn.IsConnectable(),time = DateTime.Now});});}} }再次調試運行hi項目，然后訪問http://localhost:5000/status會收到類似于下面這樣的json數據:
{running: true,dbConnectable: true,time: "2017-05-17T14:47:47.1287050+08:00" }其中dbConnectable表示數據庫可連接性狀態。如果你把數據庫容器停止：
docker stop pgdb再次調試運行，并訪問http://localhost:5000/status，會發現dbConnectable的值變為false了。 嗯，腦袋聰明的你一定會想: 這個數據庫檢測的代碼應該封裝成一個方法，這樣就可以多個服務中都能方便做這個檢查了; 而數據庫連接字符串，也應該用配置文件。老衣在這里先提示你這未必是好的，至于原因嗎，后面會有討論。
當然了，你也可以在這個api中增加CPU、內存等實時環境狀態數據，用于監控服務通過這個api定時獲取到該服務的相關狀態數據
先確保數據庫容器pgdb處于啟動狀態：
docker start pgdb在數據庫hiDB上建一張news表:
create table news (id serial primary key,title varchar(200) not NULL,content text NOT NULL)在hi項目上，從Nuget引用最新版的Dapper和Dapper.Contrib
在hi項目中，新建一個文件NewModule.cs:
using System.Data;using Dapper.Contrib.Extensions;using Nancy;using Nancy.ModelBinding;namespace hi{public class NewsModule : NancyModule{public NewsModule(IDbConnection conn){Get("/api/news", _ =>{ ? ? ? ? ? ? ? ?return Response.AsJson(conn.GetAll<News>());});Post("/api/news", _ =>{ ? ? ? ? ? ? ? ?var model = this.Bind<News>(); ? ? ? ? ? ? ? ?var insertNumber = conn.Insert(model); ? ? ? ? ? ? ? ?return Response.AsJson(insertNumber > 0);});Get("/api/news/{id:int}", x =>{ ? ? ? ? ? ? ? ?int id = x.id; ? ? ? ? ? ? ? ?var model = conn.Get<News>(id);if (model == null){ ? ? ? ? ? ? ? ? ? ?return Response.AsJson(new { error = "該新聞不存在" }).WithStatusCode(HttpStatusCode.NotFound);} ? ? ? ? ? ? ? ?return Response.AsJson(model);});}}[Table("news")] ? ?public class News{public int id{ ? ? ? ? ? ?get; ? ? ? ? ? ?set;} ? ? ? ?public string title{ ? ? ? ? ? ?get; ? ? ? ? ? ?set;} ? ? ? ?public string content{ ? ? ? ? ? ?get; ? ? ? ? ? ?set;}} }為了簡單期間，我把News的定義放在了同一個文件中，實際項目中不應該這樣寫
即增加了3個API：
用postman向http://localhost:5000/api/news?POST 一條json數據:
{"title":"test","content":"this is only one test"}收到true說明添加成功，接著GET請求http://localhost:5000/api/news會獲取含有剛添加的新聞的數組json：
[{"id": 1,"title": "test","content": "this is only one test"} ]GET 請求?http://localhost:5000/api/news/1會獲取id為1的新聞數據json:
{"id": 1,"title": "test","content": "this is only one test"}GET 請求?http://localhost:5000/api/news/2會獲取一個狀態碼為404的json數據:
{"error": "該新聞不存在"}很棒啊, 3個API都表現正常了。是不是感覺用Nancy替代ASP.NET MVC，用Dapper替代EntityFramework?寫代碼變得更暢快淋漓呢？嗯，不過也不是說這些替代就任何場合都會更好，這完全可以由開發者或團隊根據實際情況自由控制。 但老衣在這里主要是想說，一些其他選擇也許可以讓你的開發變得輕松有趣一些了，甚至更多好處。
總之，以后我們也就可以使用以上類似的方式，很快速的創建其他微服務了。
所有新聞的列表
添加一個新聞
獲取指定id的新聞
嗯，到這里不知道你是否想起了前面的數據庫連接字符串中，包含了Host=localhost?也就是說數據庫服務器的所在地是本機。而我們的數據庫實際上是在另外一個容器中，只是因為我們運行容器時把本機端口和容器做了個映射，所以造成了數據庫在本機的假象。我們到底應該如何處理呢？一臺生產環境的機器上可能會有多個數據庫容器，或者其他服務的容器，我們不能也不應該把所有服務的端口都在真實生產環境中上進行映射暴露。生產環境中數據庫容器或類似的涉及信息安全的容器，都應該盡可能不允許外部直接訪問，而是使用容器的相關通信手段。這樣一來，我們的hi服務訪問的數據庫應該是pgdb這個容器。所以在部署（非開發階段）應該將Host的值改為pgdb，并使用link方式將hi服務的容器與pgdb進行連接，直接通過容器通信。改完數據庫連接字符串后，重新制作hi服務的容器鏡像
dotnet restore dotnet build -c Release dotnet publish -c Release -o dist docker build -t hi .構建完成后，以容器方式連接pgdb并運行
docker run --name hiServ --rm -p 5000:5000 --link pgdb:pgdb hi訪問http://localhost:5000/status，收到
{running: true,dbConnectable: true,time: "2017-05-18T14:52:30.3009050+08:00" }可以看出數據庫連接是成功的，很棒。即使你把pgdb容器的端口映射移除，也會發現hi服務仍可以訪問pgdb容器的數據庫，但是你的pgadmin就訪問不了，挺安全吧 :D 至于如何跨服務器連接容器通信，這屬于高級話題，有機會再細聊或者直接查相關文檔和書籍研究一下。
看起來這時候我們用一個數據庫容器和一個hi服務容器實現了期望的功能，是不是完美了呢？當然不完美，因為不完美的人類永遠造不出完美的事物來，只能盡力無限趨向完美！（來自老衣語錄^_^）把數據庫容器也作為一個微服務，我們都知道：是個服務就有升級、更新、重啟或宕機的時候。我們希望數據庫容器中的數據庫因某原因出現崩潰退出時能夠自動重啟數據庫服務，以便達到整體系統的高可用度。docker運行容器時指定--restart參數就可以非常簡單做到這一點，Great！看起來很美是不是，但請想一下如果用戶剛好在數據庫崩潰時訪問了hi服務，是不是就會收到服務器端異常呢？就前面實現的代碼來說，答案是肯定的。那么怎么能夠讓用戶感受不到這中間的短時間數據庫失聯呢？前文中我們提到過.NET領域有個很好的庫Polly，可以再遇到一些異常時實現Retry。現在用它改造一下hi服務的代碼，讓新聞有關的幾個api實現數據庫鏈接異常時自動Retry：
先在hi項目上用Nuget引用Polly，然后修改NewsModule.cs的代碼為：
using System.Data; using Dapper.Contrib.Extensions; using Nancy; using Nancy.ModelBinding; using Polly;namespace hi { ? ?public class NewsModule : NancyModule{ ? ? ? ?public NewsModule(IDbConnection conn){Get("/api/news", _ =>{var list = DbRetry().Execute(() => { return conn.GetAll<News>(); }); ? ? ? ? ? ? ? ?return Response.AsJson(list);});Post("/api/news", _ =>{var model = this.Bind<News>();var insertNumber = DbRetry().Execute(() => { return conn.Insert(model); }); ? ? ? ? ? ? ? ?return Response.AsJson(insertNumber > 0);});Get("/api/news/{id:int}", x =>{ ? ? ? ? ? ? ? ?int id = x.id;var model = DbRetry().Execute(() => { return conn.Get<News>(id); }); ? ? ? ? ? ? ? ?if (model == null){ ? ? ? ? ? ? ? ? ? ?return Response.AsJson(new { error = "該新聞不存在" }).WithStatusCode(HttpStatusCode.NotFound);} ? ? ? ? ? ? ? ?return Response.AsJson(model);});}Policy DbRetry(){ ? ? ? ? ? ?return Policy.Handle<System.Net.Sockets.SocketException>() ? ? ? ? ? ? ? ? ? ? ? ? .Or<Npgsql.NpgsqlException>() ? ? ? ? ? ? ? ? ? ? ? ? .RetryForever();}}[Table("news")] ? ?public class News{ ? ? ? ?public int id{get;set;} ? ? ? ?public string title{get;set;} ? ? ? ?public string content{get;set;}} }編譯運行hi服務后，不要著急訪問news相關api，先模擬數據庫失聯：
docker stop pgdb等數據庫停止后，用瀏覽器訪問http://localhost:5000/api/news，你會發現瀏覽器一直在等待服務器響應…… 立即再切換到剛才的命令行窗口，啟動數據庫容器：
docker start pgdb再次切換到剛才訪問http://localhost:5000/api/news那個瀏覽器窗口，你會驚奇的發現有數據了，而不是返回數據庫異常！這就是Polly的強大之處。當然了這個庫還有很多強大功能，請移步到官方網站查看文檔學習一下吧。
到這里，聰明的你是否已經聯想到，其他情況一個微服務請求另外一個微服務的時候也可以用Polly實現高可用呢？
用用OpenResty吧
OpenResty?是一款基于?NGINX?和?LuaJIT?的 動態Web 平臺。你可以根據自己的需求設定啟用的模塊，并編譯生成自己定制的OpenResty。官方的Docker鏡像默認包含了一些模塊：
file-aio
http_addition_module
http_auth_request_module
http_dav_module
http_flv_module
http_geoip_module=dynamic
http_gunzip_module
http_gzip_static_module
http_image_filter_module=dynamic
http_mp4_module
http_random_index_module
http_realip_module
http_secure_link_module
http_slice_module
http_ssl_module
http_stub_status_module
http_sub_module
http_v2_module
http_xslt_module=dynamic
ipv6
mail
mail_ssl_module
md5-asm
pcre-jit
sha1-asm
stream
stream_ssl_module
threads
其中http_auth_request_module可以實現簡單的登錄后訪問某資源的功能，并且身份驗證和資源是分開的，具體介紹可參考http://ohmycat.me/nginx/2016/06/28/nginx-ldap.html；http_image_filter_module模塊則可以輕松實現實時縮略圖、圖片旋轉等,可參考?https://ruby-china.org/topics/31498?了解。其他模塊功能請自行Google吧。
OpenResty繼承了Nginx的高性能、反向代理等優點外，還支持使用Lua腳本編寫動態邏輯代碼，甚至是服務器端視圖。這里我們說一下如何用openresty簡單實現前面的新聞列表api的功能。
先在一個新建的目錄中創建一個Dockerfile用來創建帶有postgres訪問能力的openresty鏡像:
FROM centos:7MAINTAINER Evan Wies <evan@neomantra.net># Docker Build Arguments ARG RESTY_VERSION="1.11.2.3" ARG RESTY_LUAROCKS_VERSION="2.3.0" ARG RESTY_OPENSSL_VERSION="1.0.2k" ARG RESTY_PCRE_VERSION="8.39" ARG RESTY_J="1" ARG RESTY_CONFIG_OPTIONS="\ ? ?--with-file-aio \ ? ?--with-http_addition_module \ ? ?--with-http_auth_request_module \ ? ?--with-http_dav_module \ ? ?--with-http_flv_module \ ? ?--with-http_geoip_module=dynamic \ ? ?--with-http_gunzip_module \ ? ?--with-http_gzip_static_module \ ? ?--with-http_image_filter_module=dynamic \ ? ?--with-http_mp4_module \ ? ?--with-http_random_index_module \ ? ?--with-http_realip_module \ ? ?--with-http_secure_link_module \ ? ?--with-http_slice_module \ ? ?--with-http_ssl_module \ ? ?--with-http_stub_status_module \ ? ?--with-http_sub_module \ ? ?--with-http_v2_module \ ? ?--with-http_xslt_module=dynamic \ ? ?--with-ipv6 \ ? ?--with-mail \ ? ?--with-mail_ssl_module \ ? ?--with-md5-asm \ ? ?--with-pcre-jit \ ? ?--with-sha1-asm \ ? ?--with-stream \ ? ?--with-stream_ssl_module \ ? ?--with-threads \ ? ?--with-http_postgres_module \ ? ?"# These are not intended to be user-specified ARG _RESTY_CONFIG_DEPS="--with-openssl=/tmp/openssl-${RESTY_OPENSSL_VERSION} --with-pcre=/tmp/pcre-${RESTY_PCRE_VERSION}"# 1) Install yum dependencies# 2) Download and untar OpenSSL, PCRE, and OpenResty# 3) Build OpenResty# 4) CleanupRUN \ ? ?yum install -y \ ? ? ? ?gcc \ ? ? ? ?gcc-c++ \ ? ? ? ?gd-devel \ ? ? ? ?GeoIP-devel \ ? ? ? ?libxslt-devel \ ? ? ? ?make \ ? ? ? ?perl \ ? ? ? ?perl-ExtUtils-Embed \ ? ? ? ?readline-devel \ ? ? ? ?unzip \ ? ? ? ?zlib-devel \ ? ? ? ?postgresql-devel \ ? ?&& cd /tmp \ ? ?&& curl -fSL https://www.openssl.org/source/openssl-${RESTY_OPENSSL_VERSION}.tar.gz -o openssl-${RESTY_OPENSSL_VERSION}.tar.gz \ ? ?&& tar xzf openssl-${RESTY_OPENSSL_VERSION}.tar.gz \ ? ?&& curl -fSL https://ftp.pcre.org/pub/pcre/pcre-${RESTY_PCRE_VERSION}.tar.gz -o pcre-${RESTY_PCRE_VERSION}.tar.gz \ ? ?&& tar xzf pcre-${RESTY_PCRE_VERSION}.tar.gz \ ? ?&& curl -fSL https://openresty.org/download/openresty-${RESTY_VERSION}.tar.gz -o openresty-${RESTY_VERSION}.tar.gz \ ? ?&& tar xzf openresty-${RESTY_VERSION}.tar.gz \ ? ?&& cd /tmp/openresty-${RESTY_VERSION} \ ? ?&& ./configure -j${RESTY_J} ${_RESTY_CONFIG_DEPS} ${RESTY_CONFIG_OPTIONS} \ ? ?&& make -j${RESTY_J} \ ? ?&& make -j${RESTY_J} install \ ? ?&& cd /tmp \ ? ?&& rm -rf \ ? ? ? ?openssl-${RESTY_OPENSSL_VERSION} \ ? ? ? ?openssl-${RESTY_OPENSSL_VERSION}.tar.gz \ ? ? ? ?openresty-${RESTY_VERSION}.tar.gz openresty-${RESTY_VERSION} \ ? ? ? ?pcre-${RESTY_PCRE_VERSION}.tar.gz pcre-${RESTY_PCRE_VERSION} \ ? ?&& curl -fSL http://luarocks.org/releases/luarocks-${RESTY_LUAROCKS_VERSION}.tar.gz -o luarocks-${RESTY_LUAROCKS_VERSION}.tar.gz \ ? ?&& tar xzf luarocks-${RESTY_LUAROCKS_VERSION}.tar.gz \ ? ?&& cd luarocks-${RESTY_LUAROCKS_VERSION} \ ? ?&& ./configure \ ? ? ? ?--prefix=/usr/local/openresty/luajit \ ? ? ? ?--with-lua=/usr/local/openresty/luajit \ ? ? ? ?--lua-suffix=jit-2.1.0-beta2 \ ? ? ? ?--with-lua-include=/usr/local/openresty/luajit/include/luajit-2.1 \ ? ?&& make build \ ? ?&& make install \ ? ?&& cd /tmp \ ? ?&& rm -rf luarocks-${RESTY_LUAROCKS_VERSION} luarocks-${RESTY_LUAROCKS_VERSION}.tar.gz \ ? ?&& yum clean all \ ? ?&& ln -sf /dev/stdout /usr/local/openresty/nginx/logs/access.log \ ? ?&& ln -sf /dev/stderr /usr/local/openresty/nginx/logs/error.log# Add additional binaries into PATH for convenience ENV PATH=$PATH:/usr/local/openresty/luajit/bin/:/usr/local/openresty/nginx/sbin/:/usr/local/openresty/bin/ENTRYPOINT ["/usr/local/openresty/bin/openresty", "-g", "daemon off;"]用這個文件構建一個鏡像（建議翻墻狀態構建，你懂的）：
docker build -t openresty:postgres .在另外一個新建的目錄（假設名字叫newsOR）中，新建一個index.html文件：
<html ng-app="app"><head><title>新聞列表</title><link href="https://cdn.bootcss.com/bootstrap/3.3.7/css/bootstrap.min.css" rel="stylesheet"></head><body><div class="container" ng-controller="newsListCtrl"><h2>新聞列表</h2><table class="table table-bordered"><thead><th>ID</th><th>標題</th><th>內容</th></thead><tbody><tr ng-repeat="item in list"><td ng-bind="item.id"></td><td ng-bind="item.title"></td><td ng-bind="item.content"></td></tr></tbody></ul></div><script src="https://cdn.bootcss.com/angular.js/1.6.4/angular.min.js"></script><script>angular.module('app', []).controller('newsListCtrl', function ($scope, $http) {$scope.list = [];$http.get('/api/news').then(function (res) {$scope.list = res.data;});}); ? ?</script></body></html>在newsOR目錄中，創建一個nginx.conf文件：
#user ?nobody;worker_processes ?1;events { ? ?worker_connections ?1024; }http { ? ?include ? ? ? mime.types; ? ?default_type ?application/octet-stream; ? ?sendfile ? ? ? ?on; ? ?keepalive_timeout ?65; ? ?upstream pgsql { ? ? ? ?postgres_server pgdb:5432 dbname=hiDB password=123456 user=postgres; ? ? ? ?postgres_keepalive off;} ? ?server { ? ? ? ?listen ? ? ? 80; ? ? ? ?server_name ?localhost; ? ? ? ?charset utf-8; ? ? ? ?location / { ? ? ? ? ? ?root /www; ? ? ? ? ? ?index index.html;} ? ? ? ?location /api/news { ? ? ? ? ? ?postgres_pass pgsql; ? ? ? ? ? ?rds_json on; ? ? ? ? ? ?postgres_query 'select * from news';}} }在上一步創建的目錄中，創建一個Dockerfile文件：
FROM openresty:postgres ENV TZ=Asia/Shanghai COPY ./nginx.conf /usr/local/openresty/nginx/conf/nginx.confEXPOSE 80ENTRYPOINT ["/usr/local/openresty/bin/openresty", "-g", "daemon off;"]構建這個鏡像:
docker build -t news:or .連接pgdb容器運行上一步構建的鏡像:
docker start pgdb docker run --rm -p 8000:80 --link pgdb:pgdb news:or用瀏覽器訪問http://localhost:8000/api/news你會看到跟之前我們訪問hi服務的新聞列表api獲得一樣的json數據。但這里我們實際上只是在nginx.conf中加了幾行配置就實現了。更加簡單快速（雖然第一次準備支持postgres的openresty鏡像有點慢，但是這個鏡像是可以復用的，不必每次都重新構建）！訪問http://localhost:8000/可以看到通過這個api獲取數據后綁定到前端頁面列表
如果我們先把之前的hi服務容器hiServ運行起來，并把前面步驟中的nginx.conf中到/api/news的配置改為:
proxy_set_header Content-Type application/json;proxy_pass http://hiServ:5000/api/news;然后再次構建news:or鏡像，并重新運行這個鏡像的容器，你會發現效果跟第5步一樣。只是原來上是通過反向代理訪問了hiServ上的新聞api而已。
至于如何使用openresty設置更復雜的反向代理、運行Lua腳本等細節，請移步到http://agentzh.org/misc/slides/ngx-openresty-ecosystem/#1?了解一些相關特性，也到https://moonbingbing.gitbooks.io/openresty-best-practices/content/查看相關最佳實踐，一次學習終生受用。
準備 Slack 集成的WebHook:
假設你已經在Slack上注冊并創建了自己的團隊url是https://XXX.slack.com。那么請登錄后訪問https://XXX.slack.com/apps/manage/custom-integrations，在Incoming WebHooks configuration中添加真對您某個頻道(假設是YYYY)的配置，此時會獲得一個WebHook的Url,我們假設這個Url是https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX。incoming-webhooks的使用方式可以查看?https://api.slack.com/incoming-webhooks
切換到hi服務所在目錄的父級目錄中
新建一個用于推送Slack通知的slack.sh文件:
channel=$1nickname=$2msg=$3data="payload={\"text\": \"${msg}\", \"channel\": \"#${channel}\", \"username\": \"${nickname}\", \"icon_emoji\": \":monkey_face:\"}"curl -X POST \ --data-urlencode "${data}" \https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXXXXXXXXXX新建一個build.js：
var SECONDS_FOR_BUILD = 1 * 60; //兩次構建之間間隔的秒數exec('clear');echo('每隔' + SECONDS_FOR_BUILD + '秒檢查git代碼是否更新');
function build_dotnet(){cd('hi'); ? ?echo('從git上拉取最新代碼...');exec('git pull'); ? ?echo('清理編譯環境...'); //清理的目的是為了強制更新，可根據自己的實際需求決定是否需要這樣做rm('-rf', './bin');rm('-rf', './obj');rm('-rf', './dist');exec('dotnet clear'); ? ?echo('編譯并發布...');exec('dotnet restore'); ? ?var buildResult = exec('dotnet build -c Release'); ? ?if (buildResult.code != 0) { ? ? ? ?echo('編譯失敗!');exec('sh slack.sh YYYY CSharp編譯器 糟糕代碼沒有編譯通過', { silent: true }); ? ? ? ?return;}exec('dotnet publish -c Release -o dist'); ? ?echo('構建Docker鏡像...');exec('docker build -t hi .'); ? ?//echo('推送鏡像到私有Docker Registry')//exec('docker push xxx.xxxxx.xxx/hi'); //將 xxx.xxxxx.xxx 改為自己的私有Docker Registry地址echo('完成');exec('sh slack.sh YYYY 構建器 恭喜主人，新版本的鏡像已經準備好了', { silent: true });cd('../'); }build_dotnet(); //立即執行一次構建setInterval(function () {build_dotnet(); }, SECONDS_FOR_BUILD * 1000);運行命令:
shjs build.js這個構建程序會每個一段時間（上面代碼中為60秒）拉取最新代碼，然后編譯、發布、打包docker鏡像、推送docker鏡像等一系列動作。
如果代碼沒有編譯通過，你會在Slack中收到一個來自機器人CSharp編譯器的消息推送糟糕代碼沒有編譯通過；如果編譯通過、打包好新的Docker鏡像，推送至私有Docker Registry上后，你又會在Slack中收到一個來自機器人構建器的消息推送恭喜主人，新版本的鏡像已經準備好了。是不是很酷呢？團隊或項目主管可以第一時間通過Slack了解構建程序執行的情況。
生產環境中則可以用build.js類似的方式定期從私有Docker Registry上使用docker pull xxx.xxxxx.xxx/hi的命令拉取最新hi服務的Docker鏡像，并用新的鏡像替換舊的。甚至可以使用docker-compose或docker-swarm等做docker的編排和集群更新。這里因為各自情況不同，老衣就不給例子代碼了，你發揮一下自己的想象力和編程能力吧。
有基于OpenResty的國產API網關:Orange, 可以參考學習一下，因為中文文檔的產品對國人來說太好了
.NET Core領域的很多優秀庫和項目可以參考https://github.com/thangchung/awesome-dotnet-core
Actor Model(Actor模型)也可以實現一些場景的微服務，建議學習和了解一些成熟的框架(例如?Akka、Akka.NET、Orleans等);目前我比較喜歡的是Proto.Actor
zeit?是一家微服務領域很神奇的公司，開源了不少不錯的庫，比如pkg可以把nodejs項目直接打包成可執行程序，而不必依賴Node.js環境；micro?輕松實現基于Node.js的異步HTTP微服務；hyper?構建在Web技術上的終端控制臺;next.js?是在服務器端渲染React應用的框架。仔細學習研究一下會有很多收獲的
Jint?是一個.NET版的javascript解釋器，它提供了對ECMA5.1的完整兼容，并且可以運行在任何.NET平臺上。由于它不會動態生成.NET代碼，也不使用DLR，所以它可以很快的運行相對較小的js腳本。
NLua?是綁定.NET世界和Lua世界的項目。它可以讓你在Windows, Linux, Mac, iOS , Android, Windows Phone 7 and 8等幾乎任何C#應用中實現.NET與Lua的相互調用。
增加一組簡單的新聞相關API
用shelljs自動拉取代碼構建鏡像并推送Slack通知
你可能已經發現了，我們前面的內容中幾乎所有的編譯、發布、打包、容器的運行停止等都是用命令行來做的。原因就是命令行指令可以寫成批處理腳本，腳本并不涉及鼠標點擊等人工干預，所以就可以讓機器自按照一些計劃安排自動反復執行。我們在前面提到過的xunit.net、mocha等測試框架甚至grunt、gulp、webpack等web前端打包工具也都有對應的命令行（CLI）支持，所以也都可以很方便的自動化執行。
我們選擇shelljs作為批處理工具的原因是使用熟悉的javascript語言寫比其他有很多額外的好處，比如更豐富的基礎類庫、工具鏈、依賴包等。
至于Slack的介紹前面已經講過，我們主要用它把機器和人之間的交互打通，讓機器積極主動的告訴人或團隊，一些代碼發生了什么事情。
提示：
下面的例子代碼可能僅兼容MacOS或Linux，不支持Windows
附錄
原文：http://yimingzhi.net/2018/03/lao-yi-de-wei-fu-wu-shi-jian-jian-yao-zhi-yin-2017-ban
.NET社區新聞，深度好文，歡迎訪問公眾號文章匯總 http://www.csharpkit.com
總結
以上是生活随笔為你收集整理的老衣的微服务实践简要指引2017版的全部內容，希望文章能夠幫你解決所遇到的問題。
- 上一篇： 重磅消息-Service Fabric
- 下一篇： Entity Framework Cor