showdoc是國内的一款api文檔管理系統,可以安裝在linux和windows伺服器上,有自動安裝腳本,也可以手動安裝。
showdoc有線上系統,但是為了安全性,一般都是在内部獨立部署,公司需要在window伺服器上部署,遇到了好幾個坑,這裡寫下。
1.win-R 打開指令行程式,輸入mstsc 遠端連接配接window 2008 server (個人非常不喜歡用window伺服器,一直都是用SSH連LINUX系統的,這會不會是鄙視鍊?)
2.因為showdoc需要在apache、php環境下運作,是以先要部署容器環境,檢視官網說明https://www.showdoc.cc/help?page_id=13732
得知,有內建好了的服務容器,wamp-server,在網上搜尋後,下載下傳傳到伺服器的檔案夾裡,解壓安裝。
3. 安裝到最後發生異常錯誤,大概的意思是apache的httpd檔案報錯,說找不到MSVCR110.DLL檔案,無法啟動程式。
經過網上搜尋咨詢,知道伺服器的window系統裡缺少這個檔案,伺服器是64位作業系統,
在C:/syswow64裡沒有這個檔案,如果是32位系統,在C:/system32裡找
我在微軟下載下傳了更新檔 http://www.microsoft.com/zh-CN/download/details.aspx?id=30679
下載下傳Visual C++ Redistributable for Visual Studio 2012 Update 4更新安裝
4. 本以為打了更新檔就好了,再次安裝wampServer,還是啟動報錯,我發現syswow64裡仍然沒有MSVCR110.DLL, 我幹脆把system32裡的拷貝過來,啟動服務又報錯了,如下圖:
5.這一次的錯誤代碼不一樣,說明win伺服器環境還是缺乏必要的底層支撐環境,就像開發JAVA項目,運作JAVA程式必須得有JDK環境一樣。
百度了一下,發現沒有安裝Visual Studio,在官網選擇了2013版本,把32位和64位的都下載下傳了,因為有位同學說最好都安,不然啟動還是報錯。
6.安裝完畢後,重新啟動wampserver,發現沒有彈出錯誤提示了,舒了一口氣。
将語言設定為中文簡體,如下圖
接下來應該部署showdoc了,但以系統的尿性,我部署程式重來都是坑不斷,哪有那麼順利。。。
我先下載下傳showdoc的壓縮包,解壓後放到wampServer預設的www檔案夾下,
然後通路http://localhost/showdoc-master 發現提示404,項目檔案不存在
7.這是怎麼回事!我點選wampServer,通路診斷頁面,也是如此
原來,我的服務壓根就沒有啟動好,圖示是黃色的。
點選圖示,選擇面闆上的apache-->service-->測試80端口,發現如下圖:
說明IIS服務占用了80端口,沒辦法隻能修改apache的httpd.conf了,通路檔案路徑:
D:\wamp\bin\apache\apache2.4.9\conf
搜尋80字元串,可以找到原本配置80端口的地方,将80改為811(這個自己定義)
一共有2處,分别是Listen和ServerName
還有一個地方需要修改,為了能讓外部通路伺服器的apache服務位址,必須修改部署showdoc的檔案位址的通路權限,找到<Directory "d:/wamp/www/"> 将AllowOverride none和 Deny from all 修改為
AllowOverride all , Allow from all ,如果沒有這2個請自行添加。
完畢後重新開機apache服務,可以發現wampServer的圖示綠了。服務都正常啟動了!
通路localhost:811
通路localhost:811/showdoc-master/
第一次,會進入初始化showdoc的安裝頁面,instanll.php,界面略。請選擇中文,點下一步
用IE浏覽器會發現js報錯無法進行下去,請用chrome或者360極速(鄙視IE核心,鄙視鍊第二輪)
換了chrome就OK了,提示安裝成功:
安裝成功!預設管理者賬戶密碼是showdoc/123456。登入後,在右上角可以看到管理背景入口。
此外,強烈建議修改管理者初始密碼。若再遇到問題,可參考ShowDoc幫助文檔:https://www.showdoc.cc/help
輸入賬戶密碼,就可以進去部署自己的應用了。
我們試試用外網通路伺服器的位址也是OK的。
又學到了一個新的API文檔管理系統的部署和使用,成長就是要不斷的學習,但是我還是喜歡在linux上部署項目和環境,覺得RAP和swagger都比這個順手, 現在做spring boot的開發,更喜歡用swagger了(鄙視鍊第三波)