上一篇【.Net Core微服務入門全紀錄(七)——IdentityServer4-授權認證】中使用IdentityServer4完成了鑑權中心的搭建,配合網關實現了統一的授權認證。進行到這裡,系統環境已經比較複雜了,想把整個系統運行起來會非常繁瑣:要運行Consul、業務服務、網關、鑑權中心、web客戶端,還要安裝資料庫、MQ等等。。。那麼本篇將使用Docker Compose來解決以上問題,僅需一個簡單的命令,即可啟動整個環境。
什麼是Docker Compose?
Compose 是用於定義和運行多容器 Docker 應用程式的工具。通過 Compose,您可以使用 YML 文件來配置應用程式需要的所有服務。然後,使用一個命令,就可以從 YML 文件配置中創建並啟動所有服務。
簡單來理解,Compose類似一個批量工具,可以執行一組命令,支持批量構建鏡像,批量啟動容器,批量刪除容器等等功能。
Windows的Docker Desktop中已經包括了Compose,Linux下Compose則需要單獨安裝一下。
yml文件是使用Compose必不可少的,在編寫yml文件之前還需要準備Dockerfile。
之前的章節中,有些服務不是在Docker中運行的,現在全部放到Docker中。確保解決方案中每個項目都添加Docker支持。
在根目錄新建docker-compose.yml文件:
以下是docker-compose.yml文件內容:
version: &39; 服務 auth: 34;auth&構建 context: . Dockerfile文件目錄 ports: 39;9080:9080&容器外部9080 容器內部9080 environment: 程序在容器內部http://+:9080運行 也可以寫成http://0.0.0.0:9080 networks: 自定義網絡my-net web: 34;web&39;5000:5000&&34;服務依賴於&34;服務和&34;服務,此服務會在依賴服務之後執行 - auth - apigateway apigateway: 34;apigateway&39;9070:9070&定義&34;服務 對應的產品服務項目 image: productapi 39;9050:9050&程序參數 - ConsulSetting:ServicePort=9050 指定鏡像名稱為productapi,productapi1服務中已經構建了productapi鏡像,所以不用重複構建 ports: - &39; environment: - ASPNETCORE_URLS=http://+:9051 - ConsulSetting:ServiceIP=productapi2 - ConsulSetting:ServicePort=9051 networks: - my-net depends_on: - productapi1 productapi3: image: productapi ports: - &39; environment: - ASPNETCORE_URLS=http://+:9052 - ConsulSetting:ServiceIP=productapi3 - ConsulSetting:ServicePort=9052 networks: - my-net depends_on: - productapi1 orderapi1: image: orderapi build: context: . dockerfile: ./Order.API/Dockerfile ports: - &39; environment: - ASPNETCORE_URLS=http://+:9060 - ConsulSetting:ServiceIP=orderapi1 - ConsulSetting:ServicePort=9060 networks: - my-net depends_on: - consul - postgres - rabbitmq orderapi2: image: orderapi ports: - &39; environment: - ASPNETCORE_URLS=http://+:9061 - ConsulSetting:ServiceIP=orderapi2 - ConsulSetting:ServicePort=9061 networks: - my-net depends_on: - orderapi1 orderapi3: image: orderapi ports: - &39; environment: - ASPNETCORE_URLS=http://+:9062 - ConsulSetting:ServiceIP=orderapi3 - ConsulSetting:ServicePort=9062 networks: - my-net depends_on: - orderapi1 consul: image: consul 39;8500:8500&定義容器網絡 my-net: 網絡模式為bridge
以上yml文件定義了auth,web,apigateway,productapi1,productapi2,productapi3,orderapi1,orderapi2,orderapi3,consul,postgres,rabbitmq 12個服務(容器),和一個容器網絡 my-net。這裡的productapi和orderapi相當於是基於同樣的鏡像各運行了3個容器,這其實不太合理,正常他們應該分布在多個docker中。。。
文件的內容雖然有點多,但是應該不難理解,上面的關鍵字我都有注釋(注意,正式使用最好還是不要加中文注釋,可能會出現編碼格式錯誤問題)。下面再簡單介紹一下文件中的networks容器網絡。
前面的章節中有提到過,默認情況下容器之間的通訊是比較麻煩的,之前是通過host.docker.internal或者容器的IP去訪問,雖然是可以訪問但有些不友好。更好的方式是,我們可以自定義一個bridge網絡,將所有服務(容器)加入這個網絡中,那麼容器之間就可以直接通過服務名稱通信了。bridge模式只是docker網絡模式中的一種,有興趣的話可以自行搜索一下。
既然程序都運行在docker中,那就不能寫localhost,host.docker.internal之類的主機名了,統一改為docker-compose.yml文件中定義的服務名。如下:
還有多處修改就不全貼出來了,都是些類似的改動。這些配置還是不要寫在代碼裡,改動起來比較亂。
這裡有一個特殊的就是identityserver4鑑權服務,這個服務是容器內外部都需要訪問的(容器內部ids4發現文檔等接口的調用,外部瀏覽器訪問),所以不能直接寫服務名auth,寫auth的話外部無法訪問,寫localhost的話內部又無法訪問。最後是參考eShopOnContainers項目,使用docker.for.win.localhost來滿足內外部的訪問需求:
理論上用host.docker.internal或許也可以,沒去測試。。。這個配置放到Compose的環境變量裡會比較好,這裡只是為了方便。
eShopOnContainers項目是微軟官方出品的開源項目,對於學習微服務,docker等技術非常有幫助。
項目地址:https://github.com/dotnet-architecture/eShopOnContainers
完成以上操作後,進入項目根目錄執行docker-compose build
build完成後,執行docker-compose up -d,-d代表在後臺運行
(第一次up,orderapi2,orderapi3,productapi2,productapi3這4個服務會起不來,是因為他們啟動時有創建資料庫的操作,同時啟動會導致後起來的4個重複的服務創建資料庫時報錯,因為orderapi1和productapi1在創建同樣的資料庫。。。這個前面說過的。這裡等up完再執行一次up就好了)
瀏覽器訪問:http://localhost:5000/
登錄後:
這樣運行系統是不是非常簡單呢?想要摧毀這個環境也很簡單,只需要一句docker-compose down
如果不習慣docker命令,推薦使用vscode,裝一下docker插件,很方便。
上文用到了Docker-Compose的3個命令:
構建:docker-compose build
啟動:docker-compose up
銷毀:docker-compose down
其實build命令也可以省略,執行up時如果沒有build的話會自動build,無論多複雜的系統環境,只需要一個docker-compose up命令即可啟動。不過鏡像需要重新bulid的時候,還是要用到build命令。Compose還有一些其他命令,需要的話可以自行搜索。
主要的工作量在於docker-compose.yml文件的編寫。
需要代碼的點這裡:https://github.com/xiajingren/NetCoreMicroserviceDemo
原文地址:https://www.cnblogs.com/xhznl/p/13268940.html