如何通過Docker安裝Sourcegraph?
譯文【51CTO.com快譯】當你的項目達到數(shù)百萬行代碼時,可通過Docker容器部署一個大有幫助的工具,比如Sourcegraph。
Sourcegraph是一款開源代碼搜索導航工具,使開發(fā)人員能夠進行快速的全局搜索、使用智能代碼識別、改進GitHub代碼托管、充當擴展API以便更容易與第三方集成等。一旦它啟動并運行起來,就能夠以你從未體驗過的方式來搜索代碼。
但是你如何部署Sourcegraph?幾種方法可以實現(xiàn)部署:
- 試試任何開源代碼庫上的公共實例。
- 安裝Chrome瀏覽器擴展件。
- 部署為Docker容器。
下面詳細介紹通過Docker容器部署Sourcegraph的過程,然后介紹如何添加用于搜索代碼的代碼庫。
你需要什么?
我將在Ubuntu Server 18.04上進行演示。托管平臺不重要,只要它可以運行Docker。你還需要連接到代碼庫。我將使用GitHub代碼庫進行演示,為此需要該代碼庫的訪問令牌和范圍(兩者都可以在你的GitHub帳戶中找到)。***,你需要不必使用sudo就能運行docker命令的用戶(出于安全考慮)。
部署容器
首先不妨部署容器。這可以通過一個命令來完成。我們將在內(nèi)外端口7080上部署容器,并將數(shù)據(jù)掛載到目錄/.sourcegraph/config:/etc/sourcegraph。為此,打開終端窗口,執(zhí)行命令:
- docker run --publish 7080:7080 -d --rm --volume ~/.sourcegraph/config:/etc/sourcegraph --volume ~/.sourcegraph/data:/var/opt/sourcegraph --volume /var/run/docker.sock:/var/run/docker.sock sourcegraph/server:2.13.5
一旦該命令完成,會出現(xiàn)一個歡迎屏幕,通知你如何進入到Sourcegraph Web GUI(圖A)。
圖A.
Sourcegraph容器已部署。
除非托管服務器有GUI,否則你無法通過127.0.0.1 localhost地址訪問Sourcegraph。改而將你的Web瀏覽器指向http://SERVER_IP:7080(其中SERVER_IP是托管服務器的IP地址)。這將打開管理員用戶創(chuàng)建頁面(圖B)。
圖B.
創(chuàng)建Sourcegraph管理員用戶。
創(chuàng)建用戶后,你將登錄進去,可以開始配置Sourcegraph了。
添加代碼庫
現(xiàn)在是時候添加代碼庫了。點擊Sourcegraph主頁面(圖C)上的Configuration(配置)按鈕。
圖C.
Sourcegraph主窗口。
在Configuration窗口(圖D)中,點擊Add GitHub repositories(添加GitHub代碼庫)按鈕,這將為該代碼庫生成必要的配置。
圖D.
添加GitHub代碼庫。
在“令牌”這一行,刪除引號之間的內(nèi)容(高亮顯示的部分),并添加從你的GitHub帳戶獲取的訪問令牌。一旦你粘貼該令牌,點擊“保存更改”。
GitHub信息添加后,點擊Repositories(代碼庫)按鈕,你應該會看到與訪問令牌關聯(lián)的所有代碼庫(圖E)。
圖E.
我們的可用代碼庫。
點擊以啟用你想添加到Sourcegraph的任何/所有代碼庫。一旦啟用了它們,Sourcegraph會克隆它們,以便它們準備好搜索。然后,你可以點擊其中一個代碼庫,開始搜索代碼。如果你在處理成千上萬行代碼,Sourcegraph很快會成為你的得力助手。
原文標題:How to install Sourcegraph with Docker,作者:Jack Wallen
【51CTO譯稿,合作站點轉(zhuǎn)載請注明原文譯者和出處為51CTO.com】