调试 Docker 容器内部的 Nebula Graph 进程

01 需求 

在开发或者测试过程中，我们经常会用到 vesoft-inc/nebula-docker-compose[1] 这个 repo 下的部署方式，因为当初为了尽可能的压缩每个 Nebula Graph 服务的 docker 镜像的体积，所以开发过程中常用的一切工具都没有安装，甚至连编辑器 VIM 都没有。

这给我们在容器内部定位问题带来一定的难度，因为每次只能去 install 一些工具包，才能开展接下来的工作，甚是费事。其实调试容器内部的进程还有另外一种方式，不需要破坏原有容器的内容，也不用在其中安装任何的工具包就能像在本地一样来调试。

这种技术在 k8s 环境下其实已经挺常用，就是 sidecar 模式。原理也比较朴素就是再起一个容器然后让这个容器跟你要调试的容器共享相同的 pid/network 的 namespace。这样原容器中的进程和网络空间在调试容器中就能“一览无余”，而在调试容器中安装了你想要的一切顺手工具，接下来的舞台就是留于你发挥了。

02 演示 

接下来我就演示一下如何操作：

我们先用上述的 docker-compose 方式在本地部署一套 Nebula Graph 集群，教程见 repo 中的 README。部署好后的结果如下：

这时我们分两个场景来演示，一个是进程空间，一个是网络空间。首先我们要先有一个顺手的调试镜像，我们就不自己构建了，从 docker hub 中找个已经打包好的用作演示，后期觉得不够用，我们可以维护一份 nebula-debug 的镜像，安装我们想要的所有调试工具，此处先借用社区内的方案 nicolaka/netshoot[2]。我们先把镜像拉取到本地：

我们先看看直接执行这个镜像会是什么样：

上面显示这个容器看不到任何 Nebula Graph 服务进程的内容，那么我们给其加点参数再看看：

这次有点不一样了，我们看到 metad0 的进程了，并且其 pid 还是 1。看到这个进程再想对其做点啥就好办了，比如能不能直接在 gdb 中 attach 它，由于手边没有带 nebula binary 的对应 image，就留给大家私下探索吧。

我们已经看到 pid 空间通过指定  --pid container:<container_name|id>  可以共享了，那么我们接下来看看网络的情况，毕竟有时候需要抓个包，执行如下的命令：

啥也没有，跟预想的有点不一样，我们有 metad0 这个进程不可能一个连接都没有。要想看到这个容器内的网络空间还要再加点参数，像如下方式再启动调试容器：

这回就跟上面的输出不一样了，加了  --network container:nebula-docker-compose_metad0_1  运行参数后，metad0 容器内的连接情况也能看到了，那么想抓包调试就都可以了。

03 总结 

通过运行另外一个容器，并让其跟想要调试的容器共享 pid/network namespace 是我们能像本地调试的关键。社区里甚至还有人基于上述想法开发了一些小工具进一步方便使用：

●  Docker-debug[3]

References

[1]  vesoft-inc/nebula-docker-compose：https://github.com/vesoft-inc/nebula-docker-compose

[2]  nicolaka/netshoot：https://hub.docker.com/r/nicolaka/netshoot

[3]  ocker-debug：https://github.com/zeromake/docker-debug

文章转载自公众号：Nebula Graph Community