.NET Core多平臺項目模板eShopOnContainers編譯手記

以前寫了一個功能性的文件上傳asp.net core的小程序，加上點七七八八的東西，勉強可以應付了，打算學習一下微軟的官方.NET CORE微服務示例https://github.com/dotnet-architecture/eShopOnContainers。這個例子很全面地展示了微服務、docker以及.net core的魅力。裏面使用了不少知識點，好比單點登陸、API資源受權，權限控制，用戶管理等，能夠做爲一個應用開發的學習模板。

重要的事情強調三遍：多平臺！多平臺！多平臺！

一個項目包含了.NET Core在多個目標平臺上的應用，包括ASP.NET CORE上的WEB SPA（單頁應用）、傳統網頁以及移動APP（基於Xamarin，同時支持Android、iOS、windows phone）。能夠獨立部署或者直接部署到Azure上，很是贊！

---

具體分析結構的文章已經有很多了，我重點說下安裝和編譯的幾個小坑，以便你們可以更快地開始。主要的參考連接是https://github.com/dotnet-architecture/eShopOnContainers/wiki/02.-Setting-eShopOnContainers-in-a-Visual-Studio-2017-environment，在vs2017上搭建windows服務，跑個WEBSPA程序。

1.工具要求

• 源代碼
• Windows 10 專業版以上（支持Hyper-V）
• Docker for windows
• Visual Studio 2017 15.3以上
• npm(裝上NODE.JS)用於跑SPA程序

聽說VS2017 15.4版本在docker compose上有點問題，可是我仍是義無反顧的升級了，下文將講到這個坑。

1.下載代碼

git clone https://github.com/dotnet-architecture/eShopOnContainers.git

我用的是dev分支，默認就是。

2.配置Docker

在上面那個docker連接裏面安裝docker for windows，選什麼版本都不要緊，我選的穩定版。直接一路next，若是以前沒啓用hyper-v，會提示重啓，照作就好。

而後是在Docker的設置->advanced裏面，配置利用CPU核心數量和內存大小，按照官方說法，CPU分配3核心，內存分配4G。因爲我使用vs2017直接compose docker，因此，下一步就是共享磁盤，在Shared drives裏面配置共享的磁盤，共享源文件所在的磁盤便可。

共享磁盤的時候，會提示輸入windows帳戶用戶名和密碼，若是windows帳戶沒有密碼的話，這步就點不過去了。

對本地開發來講，不須要其餘操做了，若是須要經過外部鏈接服務的話，那麼還須要配置防火牆，打開5100-5110這一段的端口。

3.Visual Studio 2017配置

若是全新安裝vs2017，須要如下幾個workloads：

• ASP.NET和web開發
• .Net Core跨平臺開發支持

不部署到Azure上，就不須要Azure開發這個選項了。固然，若是你須要開發移動端，或者桌面端的，甚至是UWP，那麼對應的勾上就好了。

有一個關鍵點，若是勾上了移動開發的話，須要取消Google Android Emulator和Intel Hardware Accelerated Execution Manager，由於他們和Hyper-V不兼容。

4.編譯SPA程序

下載的代碼有不少sln文件，咱們測試WEBSPA，關注一個eShopOnContainers-ServicesAndWebApps.sln就能夠了。咱們找到eShopOnContainers\src\Web\WebSPA這個文件夾，先編譯SPA程序。

a.安裝npm

直接從https://nodejs.org/en/下載最新穩定版node.js，一路next安裝，我安裝的是8.9.1LTS，記得勾上ADD TO PATH選項。

b.配置vs2017 npm路徑

在工具->選項->項目與解決方案->Web package management->外部web工具裏面，加一行你剛剛安裝的node的路徑（若是是一路next的話，那麼就是C:\Program Files\nodejs）。而後調整順序，注意新增長的要在第二行，要在WEB\External的上面。

c.編譯SPA程序

運行powerhsell，定位到eShopOnContainers\src\Web\WebSPA這個文件夾。
輸入npm install回車，等一下子就行了。而後按照教程，輸入回車。

錯誤，提示找不到node-sass，還好文檔裏面有，若是不行了，輸入npm rebuild node-sass回車

沒有提示直接結束了，那麼繼續npm run build:prod

額。。。和說好的劇本不同啊。是否是node-sass有點問題了，那我安裝一下總行了吧。

仍是不行，npm，你怕嗎?

搜索了一下這個錯誤Cannot read property '0' of undefined，找到了一個https://github.com/npm/npm/issues/17858，提示應該是npm版本有bug的問題，我運行的的npm版本是5.5.1的（運行npm -v能夠查看），在bug沒修復前，臨時解決方案：

npm install -g npm@5.2.0

仍是不行。應該是剛剛版本install以後不兼容形成了，從npm install開始從頭來一遍就行了。若是npm run build:prod正常結束了，就說明OK了。

5. debug docker

上面工做作完了，用vs2017打開eShopOnContainers-ServicesAndWebApps.sln文件，右鍵解決方案管理器裏面的docker-compose，點設爲啓動項目。

F5，開始編譯。而後等了一下子。

提示不少錯誤，有配置沒有值？啥，還要配置！

定位源文件夾根目錄下的.env文件。裏面有不少配置項，若是不用azure的話，保持默認就能夠了，可是最後的這個必定要設置true或者false。

重來，發現仍是不行。最後一個error:invalid reference format仍是存在。這就是vs2017 15.4的坑了。
參考http://www.cnblogs.com/dadream/p/7800104.html，定位源文件夾，刪除docker-compose.yml中全部鏡像的 ':${TAG:-latest}' 後綴。

從新F5，編譯經過了，可是docker要下載各類鏡像，是更漫長的等待。

最後出現這個東西，說明成功了。再仔細研究吧~HAVE FUN!