dbops 助力 GreatSQL 单机架构安装部署

dbops 助力 GreatSQL 单机架构安装部署

本文将深入介绍如何运用 dbops 完成 GreatSQL 单机架构的安装部署，无论是数据库新手寻求入门，还是经验丰富的技术人员追求高效操作，都能从中获取有价值的信息，助力构建坚实的数据库基础。

dbops 简介

dbops 是一套基于 Ansible Playbook 的自动化工具集，专为高效部署生产级数据库及其周边生态而设计。它遵循 “高效、优雅、规范（Code as Standard ）” 的核心理念：

• 高效：具备并发部署、全自动化的显著特点，且安装包小巧，能够极大地提升部署效率，节省时间和资源。
• 优雅：使用 ansible-lint 对代码进行优化，以 Python 编写并尽量运用内置模块，使得代码简洁易读，易于维护和扩展。
• 规范：能让 MySQL/GreatSQL 满足生产级规范，为数据库的稳定运行提供有力保障。

该工具主要致力于解决各类生产环境的规范化建设问题，目前正处于持续迭代的阶段，后续还将支持实例生命周期管理及资源回收等更多实用功能。

• 官网详见：http://dbops.cn/

环境介绍

本次部署所使用的操作系统为麒麟 V10 系统，以下是系统的详细信息：

$ cat /etc/*release
Kylin Linux Advanced Server release V10 (Sword)
NAME="Kylin Linux Advanced Server"
VERSION="V10 (Sword)"
ID="kylin"
VERSION_ID="V10"
PRETTY_NAME="Kylin Linux Advanced Server V10 (Sword)"
ANSI_COLOR="0;31"
Kylin Linux Advanced Server release V10 (Sword)

$ uname -a
Linux gip 4.19.90-24.4.v2101.ky10.x86_64 #1 SMP Mon May 24 12:14:55 CST 2021 x86_64 x86_64 x86_64 GNU/Linux

环境 Glibc 版本信息如下：

$ ldd --version
ldd (GNU libc) 2.28

使用的 dbops 版本为：

dbops.1.9.20250129 release

使用的 GreatSQL 版本为：

GreatSQL-8.0.32-27

下载 dbops

可以从以下链接下载

• dbops：https://gitee.com/fanderchan/dbops/releases

$ cd /usr/local
$ wget https://gitee.com/fanderchan/dbops/releases/download/dbops.1.9.20250129/dbops.1.9.20250129-Linux-x86_64.tar.gz

下载完成后，对 dbops 进行解压：

$ tar -xvzf dbops.1.9.20250129-Linux-x86_64.tar.gz 

在使用 dbops 之前，建议先阅读 dbops 目录结构和配置文件原理，这样能帮助更好地上手该工具：

• https://k49r1gqq90.feishu.cn/wiki/GKJ5wdQkYiBrI6kpRE4cOUR3nse?fromScene=spaceOverview

安装 Ansible

dbops 自带绿色版 Ansible，dbops 的核心依赖于 Ansible，执行此命令用于注册：

$ cd portable-ansible-v0.5.0-py3
$ sh setup_portable_ansible.sh
$ source ~/.bashrc

最后检查下 Ansible 是否安装成功：

$ ansible --version
ansible 2.10.5

安装 GreatSQL

上传 GreatSQL 安装包

在当前环境下，建议选择 GreatSQL-8.0.32-27-Linux-glibc2.28-x86_64 这个 Linux Generic 通用包。

注意，由于 dbops 限制，只能选择 glibc2.17 和 x86_64 以及 minimal 版本

所以只能选择GreatSQL-8.0.32-27-Linux-glibc2.17-x86_64-minimal.tar.xz版本，不过 glibc 可以向下兼容，所以不会出现无法安装情况

# 需要放到 downloads 文件夹下
$ cd /usr/local/dbops/mysql_ansible/downloads
$ wget https://product.greatdb.com/GreatSQL-8.0.32-27/GreatSQL-8.0.32-27-Linux-glibc2.17-x86_64-minimal.tar.xz

编辑配置清单

$ vi /usr/local/dbops/mysql_ansible/inventory/hosts.ini 

修改内容如下：

[dbops_mysql]
192.168.139.37 ansible_user=root ansible_ssh_pass="'****'"
# IP地址 ansible_user=root ansible_ssh_pass="'你的密码'"
[all:vars]
#ansible_python_interpreter=/usr/bin/python3

注意！密码需要单引号包围，修改时不要漏掉。

验证服务器的连通性：

$ cd /usr/local/dbops/mysql_ansible/playbooks
$ ansible all -m ping
192.168.139.37 | SUCCESS => {
    "ansible_facts": {
        "discovered_interpreter_python": "/usr/bin/python"
    },
    "changed": false,
    "ping": "pong"
}

配置公共参数文件

$ vi /usr/local/dbops/mysql_ansible/playbooks/common_config.yml 

修改数据库版本以及端口：

## In most cases, just adjust these two parameters.
mysql_version: "8.0.32-27"
mysql_port: 3306

修改数据库类型为 “greatsql”：

## DB TYPE,suport mysql,percona,greatsql
db_type: greatsql

因为是手动下载安装包，所以可以关闭此参数，修改为 false 即可：

fcs_auto_download_mysql: false     # only support mysql. percona, greatsql pls download yourself first.

若想进行进阶修改，下方还有很多公共参数可供修改。

要修改目录地址请看下方附录。

执行 Playbook

$ ansible-playbook single_node.yml

等待一会儿后，会打印出如下消息：

    "msg": [
        "Hosts to be affected by Deploy single-node MySQL server using binary installation: 192.168.139.37",
        "DB type: mysql",
        "MySQL port: 3306",
        "MySQL version: 8.0.32-27",
        "Server specs: auto",
        "Roles to be executed: ../roles/pre_check_and_set, ../roles/mysql_server",
        "mycnf_dir: /database/mysql/etc/3306",
        "datadir: /database/mysql/data/3306",
        "tmpdir: /database/mysql/tmp/3306",
        "binlog_dir: /database/mysql/log/binlog/3306",
        "relaylog_dir: /database/mysql/log/relaylog/3306",
        "redolog_dir: /database/mysql/log/redolog/3306",
        "socket_dir: /database/mysql/data/3306",
        "mysqlx_socket_dir: /database/mysql/data/3306"
    ]

可以看到上面的信息，安装时请确认无误后，输入 “confirm” 确认安装。如果想修改，可按 Ctrl+C 退出安装，再修改文件 “common_config.yml”。稍等片刻，GreatSQL 就部署完成。

有需要修改，请下滑看 “附：自定义目录” 章节

登入 GreatSQL

登入 GreatSQL 进行检查：

$ mysql -uadmin -h127.0.0.1 -P3306 -pDbops@8888 -e "select @@version"
+-----------+
| @@version |
+-----------+
| 8.0.32-27 |
+-----------+

至此，麒麟系统下 GreatSQL 的安装已顺利完成:D

附：自定义目录

自定义目录的作用

自定义目录可以让用户根据实际需求灵活调整 GreatSQL 安装过程中涉及的各种目录，如配置文件目录、数据存储目录、日志目录等，以满足不同的生产环境和业务场景的要求。

如何自定义目录

在读取 common_config.yml 文件后，新增读取advanced_config.yml配置文件，路径：dbops/mysql_ansible/playbooks/advanced_config.yml，可以找到与目录相关的参数，如 mycnf_dir、datadir、tmpdir 等。用户可以根据自己的需要修改这些参数的值。

注意！这种操作属于高阶用法，属于代码维护的一部分，其正确性需由用户自行保证。如果出现配置错误，可能会引发不可预料的后果。

更多配置信息详见：

• https://k49r1gqq90.feishu.cn/wiki/AmThwXRQOiTueekNCu3cv9o9n2f?fromScene=spaceOverview

注意事项

• 在修改目录参数时，需要确保目标目录存在且有相应的读写权限，否则可能会导致安装失败。
• 自定义目录可能会影响到一些默认的配置和脚本，需要仔细检查和测试，确保 GreatSQL 能够正常运行。