### Nebula Graph 介紹

[Nebula Graph](https://0x7.me/itpub2github) 是開源的高效能分散式圖資料庫。專案使用 C++ 語言開發，`cmake` 工具構建。其中兩個重要的依賴是 Facebook 的 Thrift RPC 框架和 [folly 庫](https://github.com/facebook/folly).

由於專案採用了 C++ 14 標準開發，需要使用較新版本的編譯器和一些三方庫。雖然 Nebula Graph 官方給出了一份[開發者構建指南](https://github.com/vesoft-inc/nebula/blob/master/docs/manual-CN/how-to-build.md)，但是在本地構建完整的編譯環境依然不是一件輕鬆的事。

### 開發環境構建

Nebula Graph 依賴較多，且一些第三方庫需本地編譯安裝，為了方便開發者本地編譯專案原始碼， Nebula Graph 官方為大家提供了一個預安裝所有依賴的 [docker 映象]([docker hub](https://hub.docker.com/r/vesoft/nebula-dev))。開發者只需如下的三步即可快速的編譯 Nebula Graph 工程，參與 Nebula Graph 的開源貢獻：

- 本地安裝好 Docker

- 將 [`vesoft/nebula-dev`](https://hub.docker.com/r/vesoft/nebula-dev) 映象 `pull` 到本地

```shell
   $ docker pull vesoft/nebula-dev
```

- 執行 `Docker` 並掛載 Nebula 原始碼目錄到容器的 `/home/nebula` 目錄

```shell
   $ docker run --rm -ti -v {nebula-root-path}:/home/nebula vesoft/nebula-dev bash
```

>  感謝社群夥伴[@阿東](https://my.oschina.net/u/200184) 提的建議，把上面的 {nebula-root-path} 替換成你 Nebula Graph 實際 clone 的目錄

為了避免每次退出 docker 容器之後，重新鍵入上述的命令，我們在 [vesoft-inc/nebula-dev-docker](https://github.com/vesoft-inc/nebula-dev-docker.git) 中提供了一個簡單的 `build.sh` 指令碼，可透過 `./build.sh /path/to/nebula/root/` 進入容器。

- 使用 `cmake` 構建 Nebula 工程

```shell
   docker> mkdir _build && cd _build
   docker> cmake .. && make -j2
   docker> ctest # 執行單元測試
```

### 提醒

Nebula 專案目前主要採用靜態依賴的方式編譯，加上附加的一些除錯資訊，所以生產的一些可執行檔案會比較佔用磁碟空間，建議小夥伴預留 20G 以上的空閒空間給 Nebula 目錄 :)

### Docker 加速小 Tips

由於 Docker 映象檔案儲存在國外，在 pull 過程中會遇到速度過慢的問題，這裡 Nebula Graph 提供一種加速 pull 的方法：透過配置國內地址解決，例如:
- Azure 中國映象 https://dockerhub.azk8s.cn
- 七牛雲 https://reg-mirror.qiniu.com

Linux 圖友可在 `/etc/docker/daemon.json` 中加入如下內容（若檔案不存在，請新建該檔案)

```
{
  "registry-mirrors": [
    "https://dockerhub.azk8s.cn",
    "https://reg-mirror.qiniu.com"
  ]
}
```
macOS 使用者請點選 `Docker Desktop 圖示 -> Preferences -> Daemon -> Registry mirrors`。 在列表中新增 `https://dockerhub.azk8s.cn` 和 `https://reg-mirror.qiniu.com` 。修改後，點選 Apply & Restart 按鈕， 重啟 Docker。

![](https://pic3.zhimg.com/80/v2-6d2dd1b7e5999207ace1b590d31a15ea_hd.jpg)

### Nebula Graph 社群

Nebula Graph 社群是由一群愛好圖資料庫，共同推進圖資料庫發展的開發者構成的社群。

本文由 Nebula Graph 社群 Committer 伊興路貢獻，也歡迎閱讀本文的你參與到 Nebula Graph 的開發，或向 Nebula Graph 投稿。

### 相關文章

- [圖資料庫 Nebula Graph 的安裝部署](https://zhuanlan.zhihu.com/p/80335605)

### 附錄

> Nebula Graph：一個開源的分散式圖資料庫。

> GitHub：[https://github.com/vesoft-inc/nebula](https://0x7.me/itpub2github)

> 知乎：https://www.zhihu.com/org/nebulagraph/posts

> 微博：https://weibo.com/nebulagraph

使用 Docker 構建 Nebula Graph 原始碼

相關文章