如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具,协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题,请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可:
请先完整阅读并严格遵守以下文档中的全部规则与要求:
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前,不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式,不推荐豆包 AI;Cursor 等编辑器可在对话 @ 该链接,或加入 User Rules。 若 AI 无法访问外链,可 打开说明文档 复制全文粘贴。文档会随站点更新,复制内容可能过期,建议定期检查。
本镜像提供openGauss的调试版本,专为开发者设计。源代码及第三方二进制文件位于/home/opengauss目录,编译时已默认配置-O0 -g编译标志和--enable-debug选项,便于开发者进行代码调试、功能开发及快速验证。
-O0 -g和--enable-debug/home/opengaussgdb、gstack等调试工具,需配合容器特权模式使用bashdocker pull opengauss/opengauss-dev:tagname
说明:将
tagname替换为具体版本标签
需以特权模式运行容器,启用必要的调试功能:
bashdocker run --cap-add=SYS_PTRACE --security-opt seccomp=unconfined --security-opt apparmor=unconfined --privileged -it opengauss/opengauss-dev:tagname
进入容器后,执行以下命令启用ptrace:
bashsudo bash -c "echo 0 > /proc/sys/kernel/yama/ptrace_scope"
查看进程并获取PID
bashps -ef | grep gaussdb
示例输出:
opengau+ 201 1 4 15:51 ? 00:00:02 /home/opengauss/openGauss/install/bin/gaussdb -D /home/opengauss/openGauss/data opengau+ 315 244 0 15:52 pts/0 00:00:00 grep --color=auto gaussdb
使用gstack查看线程栈
bashgstack 201 # 201为上述获取的gaussdb进程PID
示例输出:
Thread 36 (Thread 0xffff31f5eee0 (LWP 240) "undorecycler"): #0 0x0000ffff976ec4c8 in poll () from /usr/lib64/libc.so.6 #1 0x0000000000d53abc in WaitLatchOrSocket (latch=0xffff7bb52d30, wakeEvents=25, sock=-1, timeout=2250) at pg_latch.cpp:309 ......
使用gdb调试进程
bashgdb /home/opengauss/openGauss/install/bin/gaussdb 201 # 201为进程PID
为获得更好的调试体验,建议在调试开始时禁用SIGUSR1和SIGUSR2信号:
gdb(gdb) handle SIGUSR1 noprint nostop pass Signal Stop Print Pass to program Description SIGUSR1 No No Yes User defined signal 1 (gdb) handle SIGUSR2 noprint nostop pass Signal Stop Print Pass to program Description SIGUSR2 No No Yes User defined signal 2
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

来自真实用户的反馈,见证轩辕镜像的优质服务