dbops for openGauss 目录结构和配置文件原理

本文面向首次使用者，帮助快速理解 openGauss / PanWeiDB 生态下的目录结构、配置入口和执行逻辑。

1. 顶层目录

典型安装路径：

/usr/local/dbops

关键目录：

  • opengauss_ansible：openGauss / PanWeiDB 相关剧本。
  • portable-ansible-v0.5.0-py3：绿色版 Ansible。

2. opengauss_ansible 结构

opengauss_ansible/
├── downloads/
├── inventory/
│   └── hosts.ini
├── playbooks/
│   ├── common_config.yml
│   ├── simple_single_node.yml
│   └── enterprise_deployment.yml
└── roles/

说明：

  • downloads/：数据库安装包目录。
  • inventory/hosts.ini：目标主机清单。
  • playbooks/common_config.yml：主参数入口。
  • playbooks/simple_single_node.yml：openGauss 单机部署入口。
  • playbooks/enterprise_deployment.yml：一主两备企业部署入口。
  • playbooks/unsafe_uninstall.yml：当前已补齐的企业级卸载入口，优先用于 PanWeiDB / openGauss 企业部署清理。

3. 配置文件职责

3.1 inventory/hosts.ini

[dbops_opengauss]
192.168.199.131 ansible_user=root ansible_ssh_pass="'你的密码'"
192.168.199.132 ansible_user=root ansible_ssh_pass="'你的密码'"
192.168.199.133 ansible_user=root ansible_ssh_pass="'你的密码'"

3.2 playbooks/common_config.yml

常见参数：

  • opengauss_version
  • db_type
  • opengauss_user_password
  • opengauss_admin_password
  • opengauss_packages_dir
  • fcs_allow_dbops_default_passwd

补充说明：

  • 仓库内置的 Dbops@9999 / Dbops@8888 属于公开默认密码，只方便首次拿到代码后快速改值。
  • 部署剧本默认会拦截这两个默认值，要求先修改密码后再执行。
  • 如仅用于隔离实验环境，并且确实要保留默认值，才显式设置 fcs_allow_dbops_default_passwd: true。

4. 执行前连通性检查

cd /usr/local/dbops/opengauss_ansible/playbooks
ansible dbops_opengauss -m ping

5. 实践建议

  • 先在测试环境验证安装包与操作系统的匹配关系。
  • openGauss 与 PanWeiDB 通过 db_type 区分，不要混用安装包。
  • BigCloud21 当前只用于 PanWeiDB，不用于 openGauss。
  • CentOS 7.5 当前已实测通过 openGauss 6.0.1 单机部署和 PanWeiDB 2.0.3 一主两备部署。
  • 执行高危剧本前，先确认 inventory 中的目标主机范围。