@

• 前言
• 1. 相關環境版本：
  • 坑點一：VMware與Win10 Docker沖突
  • 坑點二：20.版本TarsJava(SpringBoot)依賴檔案缺失
• 2. Docker安裝：
  • 坑點三：Docker的鏡像默認安裝在C盤
• 3. Tars部署：
  • 坑點四：Tars框架MySQL密碼錯誤
• 4. 代碼處理：
  • 坑點五：發布包與服務名不匹配
  • 坑點六：[alarm] down, server is inactive
• 5. 介面除錯：
• 最后

前言

受限于網上資源有限，加上小白一枚，筆者在Tars入門部署時踩了不少的坑，不過最侄訓是部署成功了，便想記錄一下其中程序與心得；

Win10下Docker部署TarsJava(SpringBoot)主要分為這幾部分：Docker部署，Tars部署以及測驗，說難不難但里邊處處埋坑，一不小心陷進去頭發沒了幾斤……

這篇文章將從Docker開始描述筆者掉進去的坑，幫助小伙伴們閉坑，

統一說明：這些坑點問題均在2021年7月12號前發現，之后可能會優化，具體以官方訊息為準，

一些參考資料：
TarsdocGitHub在線檔案
B站TarsJava入門實戰視頻
TarsJava GitHub地址

1. 相關環境版本：

為什么要列出環境版本呢？是因為這里邊有坑，

坑點一：VMware與Win10 Docker沖突

大多數Windows作業系統的小伙伴電腦里都會裝VMware虛擬機跑Linux作業系統，這時如果想在Windows里安裝Docker，你可能會發現：要么安裝不了Docker，要么安裝完后VMware不能使用了，具體來說是VMware的虛擬化方案與Windows的Hpyer-V沖突，不能共存，如果想要二者共存，可以采用以下方法：

• 將VMware版本升級到15.5.5以上，同時Win10版本升級到20H1以上；

坑點二：20.版本TarsJava(SpringBoot)依賴檔案缺失

這個問題主要發生在Tars 2.0版本，如果你使用的是2.0版本，你會發現有些依賴標紅，無法從Maven中央倉庫自動匯入，這是因為中央倉庫還沒有這些依賴，

• 解決方法有兩種，一是將Tars2.0版本所需的依賴自己通過install框架到本地，對于mvn來說package&install后可以正常使用；二是回傳到1.7.2版本即可從中央倉庫拉取；

2. Docker安裝：

Docker相關安裝網上在資料與資源已經很足了，這里只提一下筆者遇到的問題，

在Win10上安裝Docker需要開啟Windows本身的虛擬支持，哭具體操作是：

• “左下角win圖示” - “設定” - “應用和功能” - 最下方“程式和功能” - “啟用或關閉Windows功能” - 開啟Hyper或相關虛擬功能；
• 或者直接在Windows搜索框中搜索上述相關關鍵字進行后續操作；
• 開啟后會要求重啟，等待重啟即可，
  
  
  
  
  

接下來到Docker官網下載Docker即可：Docker For Win

坑點三：Docker的鏡像默認安裝在C盤

Docker安裝無腦一直下一步即可，但它會默認將拉來的鏡像保存在C盤（原目錄：C:\Users\用戶名\AppData\Local\Docker\wsl），我們可以通過wsl -l -v --all命令查看：

docker-desktop用來存放程式，docker-desktop-data用來存放鏡像，如果希望它在其他盤，可以參考以下操作（以移動到新目錄：D:\program\wsl\為例）；

1. 匯出wsl子系統鏡像（備份到D:\program\wsl\目錄下），生成.tar壓縮包：

wsl --export docker-desktop "D:\program\wsl\docker-desktop\docker-desktop.tar"
wsl --export docker-desktop-data "D:\program\wsl\docker-desktop-data\docker-desktop-data.tar"

2. 洗掉現有的wsl子系統，原目錄下的ext4.vhdx檔案會被洗掉：

wsl --unregister docker-desktop
wsl --unregister docker-desktop-data

3. 重新創建wsl子系統，在新目錄下生成ext4.vhdx檔案：

wsl --import docker-desktop "D:\program\wsl\docker-desktop" "D:\program\wsl\docker-desktop\docker-desktop.tar" --version 2
wsl --import docker-desktop-data "D:\program\wsl\docker-desktop-data" "D:\program\wsl\docker-desktop-data\docker-desktop-data.tar" --version 2

以上三步就能將wsl子系統轉移到D盤下的\program\wsl\目錄了，如果想要驗證是否成功，可以使用docker隨便拉取一個鏡像，看看原目錄C:\Users\用戶名\AppData\Local\Docker\wsl與新目錄D:\program\wsl在拉取前后的檔案大小，若在拉取后原目錄大小不變，新目錄增大，就成功了，

• 成功后，新目錄下的兩個.tar備份檔案可以洗掉了，

3. Tars部署：

使用docker部署Tars，基本上是一鍵式解決，但這其中也有一些需要注意的點，

1. 先拉取三個鏡像（MySQL、Tars框架、Tars結點）：

#拉取最新的鏡像
docker pull tarscloud/framework:latest
#拉取節點鏡像
docker pull tarscloud/tars-node:latest
#拉取資料庫鏡像
docker pull   mysql:5.6

2. 創建虛擬網路：

docker network create -d bridge --subnet=172.25.0.0/16 --gateway=172.25.0.1 tars

3. 啟動資料庫：

docker run -d \
--net=tars \
-e MYSQL_ROOT_PASSWORD="root@appinside" \
--ip="172.25.0.2" \
--name=tars-mysql \
mysql:5.6

4. 等待30s，資料庫啟動需要時間：

可以進到docker里查看MySQL的日志資訊，如下則啟動成功：

5. 啟動Tars框架：

docker run -d \
--net=tars \
-e MYSQL_HOST=172.25.0.2 \
-e MYSQL_ROOT_PASSWORD="root@appinside" \
-eREBUILD=false  -eSLAVE=false \
-e INET=eth0 \
--ip="172.25.0.4" \
-p 3000-3001:3000-3001 \
tarscloud/framework

6. 等待60s，框架啟動需要時間：

可以進到Docker里查看框架的日志資訊，如下則啟動成功：

7. 啟動Tars結點：

啟動web請求
docker run -d --net=tars --ip="172.25.0.3" -eWEB_HOST=http://172.25.0.4:3000 tarscloud/tars-node

8. Docker日志如下則成功：

9. 訪問http:{"你的主機ip"}:3000，設定登錄密碼，用戶名為admin

若出現如下畫面，恭喜你，Tars部署成功！

10. 點擊運維管理，按照如下圖片進行配置：

需要注意紅框的兩個名字，服務名為將來打成jar包的檔案名，OBJ為介面名，Tars是根據應用.服務名稱.OJB來尋址的，

填寫完配置資訊后，點擊獲取埠可以自動獲取埠，接著點擊確認 - 部署，即可完成服務端與客戶端的部署，

• 服務端配置：
  
• 客戶端配置：
  

坑點四：Tars框架MySQL密碼錯誤

官方檔案的shell命令與筆者上述第五點在MySQL密碼上略有不同；

• 檔案上是：-e MYSQL_ROOT_PASSWORD='root@appinside' \
• 筆者是：-e MYSQL_ROOT_PASSWORD="root@appinside" \

筆者使用官方的陳述句，發生如下錯誤導致框架起不來：

猜測是win10與Linux命令語法不同導致，因此將單引號改成雙引號，與資料庫那里的配置統一，

4. 代碼處理：

Tars部署好后就可以上傳代碼了，可以自己寫也可以使用官方examples，這里筆者使用官方examples作為演示，

1. 首先進入TarsJava GitHub官方地址，點進examples：https://github.com/TarsCloud/TarsJava

2. 在這里我們僅關注以下三個SpringBoot檔案：

3. Idea打開server檔案（服務端）

對于服務端，需要修改的地方只有一處，即：OJB介面名，這里要與上述服務端配置的OJB名對應，然后打包即可，

打包完后修改打包后的檔案夾名為服務名：

回到Tars平臺，選擇之前配置好的服務，點擊發布管理，選中服務節點，點擊“發布選中節點”：

點擊上傳包，然后選中我們改好名字的服務包檔案，

檔案上傳后會生成一個時間戳選項，選擇后發布即可；

當螢屏中顯示三個Active時表明服務上傳成功，

4. Idea打開client檔案（客戶端）

客戶端包上傳與服務端類似，只不過需要修改以下兩個地方：

需要注意2.匹配服務名可以從以下地方查看：

選中服務端，點擊服務管理，點擊管理Servant；

復制紅框內的內容，Ctrl CV到代碼里即可；

后續步驟就跟服務端一樣了，這里就不啰嗦了，這里放上一張客戶端成功發布包圖，

坑點五：發布包與服務名不匹配

這個問題是沒有修改發布包名為服務名，這點在官方GitHub檔案上沒有提及，可能是新版本特性吧：

• 將打包名.jar，該為服務名即可：
  （將Server1改成Server，Server1為筆者故意寫錯做演示用）

坑點六：[alarm] down, server is inactive

筆者在進行部署是經常遇到的這個錯誤：

這個錯誤的原因很大概率是因為自己的代碼有問題，筆者在這里遇到的問題有：

• 打包時檔案檢驗出現錯誤；
• 沒有配置Obj介面；
• SpringBoot依賴檔案找不到等；

這個問題需要認真檢查代碼，

（這里筆者故意將MyServer.Server.ServerObj改成MyServer.Server.ServerObj1，以演示錯誤，）

5. 介面除錯：

服務包上傳進Tars是否成功，可以通過介面除錯是否成功判斷，

下面以服務端為例，客戶端相同：

首先進入介面除錯，點擊添加；

接著上傳.tars檔案，該檔案在..\src\main\resources目錄下，客戶端上傳hello.tars檔案，服務端上傳client.tars檔案，

上傳完后點擊除錯：

按照下圖進行操作即可查看除錯結果，

最后

新人制作，如有錯誤，歡迎指出，感激不盡！ 歡迎關注公眾號，會分享一些更日常的東西！ 如需轉載，請標注出處！

標籤：其他

上一篇：視頻云峰會｜“科技 X 藝術” 的顆粒度體驗是什么？

下一篇：給potplayer配置iptv源，看所有你想看的電視