GaussDB 脚本化部署

脚本化部署优势

提高部署效率

自动化执行部署步骤，减少人工操作
快速部署多个实例，适合大规模部署场景
降低部署时间，提高工作效率

确保部署一致性

统一的部署流程和配置，避免人为错误
确保所有实例的配置一致，便于管理和维护
减少因配置不一致导致的问题

便于版本管理

部署脚本可以纳入版本控制，跟踪变更历史
便于回滚到之前的部署版本
支持不同环境的部署（开发、测试、生产）

降低部署门槛

新员工可以快速上手，按照脚本执行即可完成部署
减少对资深管理员的依赖
提高部署的可靠性和成功率

部署脚本设计原则

模块化设计

将部署脚本拆分为多个模块，如环境检查、软件安装、配置初始化、服务启动等
每个模块负责特定的功能，便于维护和扩展
支持单独执行某个模块，便于调试和问题定位

可配置性

使用配置文件或环境变量管理部署参数
支持不同环境的配置，如开发、测试、生产
便于调整部署参数，适应不同的部署需求

错误处理

完善的错误处理机制，及时捕获和处理错误
详细的错误日志，便于问题定位
支持回滚操作，在部署失败时恢复到之前的状态

日志记录

详细记录部署过程，包括执行的命令、结果、时间等
便于跟踪部署进度和问题定位
支持日志级别配置，适应不同的调试需求

可扩展性

支持添加新的部署类型和功能
便于集成到 CI/CD 流程中
支持与其他工具和系统集成

单节点部署脚本

环境准备脚本

bash

#!/bin/bash
# 环境准备脚本

echo "=== 环境准备开始 ==="

# 检查操作系统版本
if [ -f /etc/centos-release ]; then
    OS_VERSION=$(cat /etc/centos-release)
    echo "当前操作系统: $OS_VERSION"
else
    echo "不支持的操作系统"
    exit 1
fi

# 安装依赖包
echo "安装依赖包..."
yum install -y python3 libaio libnuma libxml2 libxslt openssl bzip2 readline

# 关闭防火墙
echo "关闭防火墙..."
systemctl stop firewalld
systemctl disable firewalld

# 关闭 SELinux
echo "关闭 SELinux..."
sed -i 's/SELINUX=enforcing/SELINUX=disabled/' /etc/selinux/config
setenforce 0

# 设置主机名
echo "设置主机名..."
hostnamectl set-hostname gaussdb-single

# 配置 /etc/hosts
echo "配置 /etc/hosts..."
echo "127.0.0.1   gaussdb-single localhost localhost.localdomain" >> /etc/hosts

# 创建 gaussdb 用户
echo "创建 gaussdb 用户..."
useradd gaussdb
echo "GaussDB@123" | passwd --stdin gaussdb

# 创建数据目录
echo "创建数据目录..."
mkdir -p /data/gaussdb/data /data/gaussdb/log /data/gaussdb/tmp
chown -R gaussdb:gaussdb /data/gaussdb
chmod -R 700 /data/gaussdb

echo "=== 环境准备完成 ==="

安装部署脚本

bash

#!/bin/bash
# GaussDB 单节点安装部署脚本

# 配置参数
GAUSSDB_VERSION="2.0.0"
GAUSSDB_PACKAGE="GaussDB-${GAUSSDB_VERSION}-CentOS-7.6-x86_64.tar.gz"
INSTALL_DIR="/opt/gaussdb"
DATA_DIR="/data/gaussdb/data"
LOG_DIR="/data/gaussdb/log"
TMP_DIR="/data/gaussdb/tmp"
GAUSSDB_USER="gaussdb"
GAUSSDB_PASSWORD="GaussDB@123"
PORT="5432"

# 检查安装包
echo "检查安装包..."
if [ ! -f "$GAUSSDB_PACKAGE" ]; then
    echo "安装包不存在: $GAUSSDB_PACKAGE"
    exit 1
fi

# 解压安装包
echo "解压安装包..."
tar -zxvf $GAUSSDB_PACKAGE -C /tmp

# 创建安装目录
echo "创建安装目录..."
mkdir -p $INSTALL_DIR
chown -R $GAUSSDB_USER:$GAUSSDB_USER $INSTALL_DIR

# 执行安装
echo "执行安装..."
cd /tmp/GaussDB-${GAUSSDB_VERSION}-CentOS-7.6-x86_64
su - $GAUSSDB_USER -c "./install.sh -D $INSTALL_DIR"

# 初始化数据库
echo "初始化数据库..."
su - $GAUSSDB_USER -c "$INSTALL_DIR/bin/gs_initdb -D $DATA_DIR -U $GAUSSDB_USER --pwfile=<(echo '$GAUSSDB_PASSWORD') -E UTF8 --locale=C"

# 配置数据库
echo "配置数据库..."
cat > $DATA_DIR/postgresql.conf << EOF
listen_addresses = '*'
port = $PORT
data_directory = '$DATA_DIR'
log_directory = '$LOG_DIR'
temp_tablespaces = '$TMP_DIR'
max_connections = 500
shared_buffers = 8GB
work_mem = 16MB
maintenance_work_mem = 2GB
effective_cache_size = 24GB
EOF

# 配置 pg_hba.conf
cat >> $DATA_DIR/pg_hba.conf << EOF
local   all             all                                     trust
host    all             all             127.0.0.1/32            trust
host    all             all             ::1/128                 trust
host    all             all             0.0.0.0/0               md5
host    replication     $GAUSSDB_USER    0.0.0.0/0               md5
EOF

# 启动数据库
echo "启动数据库..."
su - $GAUSSDB_USER -c "$INSTALL_DIR/bin/gs_ctl start -D $DATA_DIR"

# 创建 systemd 服务文件
echo "创建 systemd 服务文件..."
cat > /usr/lib/systemd/system/gaussdb.service << EOF
[Unit]
Description=GaussDB Database Server
After=network.target

[Service]
Type=forking
User=$GAUSSDB_USER
Group=$GAUSSDB_USER
Environment=PGDATA=$DATA_DIR
ExecStart=$INSTALL_DIR/bin/gs_ctl start -D $DATA_DIR -w
ExecStop=$INSTALL_DIR/bin/gs_ctl stop -D $DATA_DIR -w
ExecReload=$INSTALL_DIR/bin/gs_ctl reload -D $DATA_DIR
Restart=on-failure

[Install]
WantedBy=multi-user.target
EOF

# 重新加载 systemd 配置
systemctl daemon-reload

# 设置开机自启
systemctl enable gaussdb
systemctl start gaussdb

echo "=== GaussDB 单节点部署完成 ==="
echo "数据库地址: localhost:$PORT"
echo "用户名: $GAUSSDB_USER"
echo "密码: $GAUSSDB_PASSWORD"

主从部署脚本

主节点配置脚本

bash

#!/bin/bash
# GaussDB 主节点配置脚本

# 配置参数
GAUSSDB_USER="gaussdb"
MASTER_IP="192.168.1.100"
SLAVE_IP="192.168.1.101"
DATA_DIR="/data/gaussdb/data"
INSTALL_DIR="/opt/gaussdb"

# 配置主节点参数
echo "配置主节点参数..."
cat >> $DATA_DIR/postgresql.conf << EOF
# 主从复制配置
wal_level = 'replica'
max_wal_senders = 10
wal_keep_size = '1GB'
max_replication_slots = 10
hot_standby = on
EOF

# 配置 pg_hba.conf，允许从节点连接
echo "配置 pg_hba.conf..."
cat >> $DATA_DIR/pg_hba.conf << EOF
# 允许从节点连接
host    replication     $GAUSSDB_USER    $SLAVE_IP/32            md5
EOF

# 重启主节点
echo "重启主节点..."
su - $GAUSSDB_USER -c "$INSTALL_DIR/bin/gs_ctl restart -D $DATA_DIR"

# 创建复制用户
echo "创建复制用户..."
su - $GAUSSDB_USER -c "$INSTALL_DIR/bin/gsql -d postgres -c \"CREATE USER replicator REPLICATION LOGIN PASSWORD 'Replication@123';\""

echo "=== 主节点配置完成 ==="

从节点配置脚本

bash

#!/bin/bash
# GaussDB 从节点配置脚本

# 配置参数
GAUSSDB_USER="gaussdb"
MASTER_IP="192.168.1.100"
SLAVE_IP="192.168.1.101"
DATA_DIR="/data/gaussdb/data"
INSTALL_DIR="/opt/gaussdb"

# 停止从节点数据库
echo "停止从节点数据库..."
su - $GAUSSDB_USER -c "$INSTALL_DIR/bin/gs_ctl stop -D $DATA_DIR || true"

# 清空数据目录
echo "清空数据目录..."
rm -rf $DATA_DIR/*

# 使用主节点基础备份初始化从节点
echo "使用主节点基础备份初始化从节点..."
su - $GAUSSDB_USER -c "$INSTALL_DIR/bin/gs_basebackup -h $MASTER_IP -p 5432 -U replicator -D $DATA_DIR -F p -X stream -P"

# 创建 recovery.conf 文件
echo "创建 recovery.conf 文件..."
cat > $DATA_DIR/recovery.conf << EOF
standby_mode = 'on'
primary_conninfo = 'host=$MASTER_IP port=5432 user=replicator password=Replication@123 application_name=slave1'
trigger_file = '$DATA_DIR/trigger.asc'
EOF

chown $GAUSSDB_USER:$GAUSSDB_USER $DATA_DIR/recovery.conf
chmod 600 $DATA_DIR/recovery.conf

# 启动从节点
echo "启动从节点..."
su - $GAUSSDB_USER -c "$INSTALL_DIR/bin/gs_ctl start -D $DATA_DIR"

# 验证主从状态
echo "验证主从状态..."
echo "在主节点执行: SELECT * FROM pg_stat_replication;"
echo "在从节点执行: SELECT * FROM pg_stat_wal_receiver;"

echo "=== 从节点配置完成 ==="

分布式部署脚本

集群配置脚本

bash

#!/bin/bash
# GaussDB 分布式集群配置脚本

# 配置参数
CLUSTER_NAME="gaussdb-cluster"
MASTER_NODE="192.168.1.100"
NODE_LIST="192.168.1.100,192.168.1.101,192.168.1.102"
GAUSSDB_USER="gaussdb"
GAUSSDB_PASSWORD="GaussDB@123"
INSTALL_DIR="/opt/gaussdb"
DATA_DIR="/data/gaussdb/data"

# 创建集群配置文件
echo "创建集群配置文件..."
cat > cluster_config.xml << EOF
<cluster>
  <PARAM name="clusterName" value="$CLUSTER_NAME"/>
  <PARAM name="nodeNames" value="$(echo $NODE_LIST | sed 's/,/ /g')"/>
  <PARAM name="gaussdbAppPath" value="$INSTALL_DIR"/>
  <PARAM name="gaussdbUser" value="$GAUSSDB_USER"/>
  <PARAM name="gaussdbPwd" value="$GAUSSDB_PASSWORD"/>
  <PARAM name="dataPath" value="$DATA_DIR"/>
  <PARAM name="dbPort" value="5432"/>
  <PARAM name="masterNode" value="$MASTER_NODE"/>
  <PARAM name="encoding" value="UTF8"/>
  <PARAM name="locale" value="C"/>
  <PARAM name="timezone" value="Asia/Shanghai"/>
</cluster>
EOF

# 分发集群配置文件
echo "分发集群配置文件..."
for node in $(echo $NODE_LIST | sed 's/,/ /g'); do
    scp cluster_config.xml $GAUSSDB_USER@$node:/tmp/
done

# 初始化集群
echo "初始化集群..."
$INSTALL_DIR/bin/gs_admin --config cluster_config.xml init

# 启动集群
echo "启动集群..."
$INSTALL_DIR/bin/gs_admin --config cluster_config.xml start

# 验证集群状态
echo "验证集群状态..."
$INSTALL_DIR/bin/gs_admin --config cluster_config.xml status

echo "=== 分布式集群配置完成 ==="

部署脚本最佳实践

版本控制

将部署脚本纳入版本控制系统，如 Git
记录脚本的变更历史，便于追溯和回滚
为不同版本的 GaussDB 维护不同的部署脚本

测试验证

在测试环境中充分测试部署脚本
验证部署后的数据库功能正常
测试不同场景下的部署，如全新部署、升级部署、回滚部署

文档化

为部署脚本编写详细的文档
说明脚本的使用方法、参数配置、注意事项等
记录脚本的变更记录和版本信息

安全性考虑

避免在脚本中硬编码密码，使用环境变量或配置文件
限制脚本的访问权限，只有授权用户可以执行
加密存储敏感信息，如数据库密码、SSH 密钥等

日志和监控

在脚本中添加详细的日志记录，便于问题定位
部署完成后，配置监控系统，监控数据库的运行状态
设置告警规则，及时发现和处理问题

常见问题（FAQ）

Q1: 如何处理部署脚本执行失败的情况？

A1: 处理部署脚本执行失败的方法：

查看脚本输出的错误信息，定位失败原因
根据错误信息，修复脚本或环境问题
如果脚本支持回滚操作，执行回滚命令
清理环境，重新执行部署脚本
记录失败原因和解决方案，便于后续优化

Q2: 如何在不同环境中使用相同的部署脚本？

A2: 在不同环境中使用相同部署脚本的方法：

使用配置文件或环境变量管理不同环境的参数
为每个环境创建单独的配置文件，如 dev.conf、test.conf、prod.conf
脚本根据环境参数加载对应的配置
使用条件判断，根据不同环境执行不同的操作

Q3: 如何自动化部署多个 GaussDB 实例？

A3: 自动化部署多个 GaussDB 实例的方法：

使用循环结构，遍历所有实例的配置
为每个实例生成单独的配置文件
并行执行部署脚本，提高部署效率
使用工具如 Ansible、SaltStack 等，实现批量部署
配置部署后的验证步骤，确保所有实例部署成功

Q4: 如何实现 GaussDB 的自动升级？

A4: 实现 GaussDB 自动升级的方法：

创建升级脚本，包含备份、升级、验证等步骤
在测试环境中充分测试升级脚本
制定升级计划，选择合适的升级时间
升级前备份数据库，确保可以回滚
升级过程中监控数据库状态，及时处理问题
升级后验证数据库功能和性能

Q5: 如何确保部署脚本的安全性？

A5: 确保部署脚本安全性的方法：

限制脚本的访问权限，只有授权用户可以执行
避免在脚本中硬编码敏感信息
使用加密存储敏感信息
定期审计和更新部署脚本
验证脚本的完整性，防止被篡改
记录脚本的执行日志，便于审计

Q6: 如何集成部署脚本到 CI/CD 流程中？

A6: 集成部署脚本到 CI/CD 流程中的方法：

将部署脚本纳入版本控制
在 CI/CD 工具中配置部署任务
设置部署触发条件，如代码提交、标签创建等
配置部署环境，如开发、测试、生产
实现部署后的自动测试和验证
配置部署通知，及时通知相关人员

Q7: 如何处理部署过程中的网络问题？

A7: 处理部署过程中网络问题的方法：

在脚本中添加网络连接检查
实现重试机制，在网络连接失败时自动重试
记录网络相关的错误信息，便于问题定位
确保所有节点之间的网络通信正常
配置合理的超时时间，避免脚本长时间等待

Q8: 如何优化部署脚本的执行速度？

A8: 优化部署脚本执行速度的方法：

并行执行独立的部署步骤
减少不必要的命令和检查
优化脚本的逻辑结构，减少循环和条件判断
使用高效的命令和工具
避免在脚本中执行耗时的操作
对大型文件的处理进行优化

Q9: 如何验证部署后的数据库状态？

A9: 验证部署后数据库状态的方法：

检查数据库进程是否正常运行
尝试连接数据库，执行简单查询
检查数据库日志，确认没有错误信息
验证数据库的配置参数是否正确
测试数据库的核心功能，如插入、查询、更新、删除等
运行性能测试，确保数据库性能符合要求

Q10: 如何维护和更新部署脚本？

A10: 维护和更新部署脚本的方法：

定期审查和更新部署脚本，适应新的环境和需求
收集部署过程中的问题和反馈，优化脚本
为脚本添加注释，便于理解和维护
遵循良好的编程规范，保持脚本的可读性和可维护性
测试脚本的变更，确保不会引入新的问题
文档化脚本的变更记录和版本信息

GaussDB 脚本化部署 ​

脚本化部署优势 ​

提高部署效率 ​

确保部署一致性 ​

便于版本管理 ​

降低部署门槛 ​

部署脚本设计原则 ​

模块化设计 ​

可配置性 ​

错误处理 ​

日志记录 ​

可扩展性 ​

单节点部署脚本 ​

环境准备脚本 ​

安装部署脚本 ​

主从部署脚本 ​

主节点配置脚本 ​

从节点配置脚本 ​

分布式部署脚本 ​

集群配置脚本 ​

部署脚本最佳实践 ​

版本控制 ​

测试验证 ​

文档化 ​

安全性考虑 ​

日志和监控 ​

常见问题（FAQ） ​

Q1: 如何处理部署脚本执行失败的情况？ ​

Q2: 如何在不同环境中使用相同的部署脚本？ ​

Q3: 如何自动化部署多个 GaussDB 实例？ ​

Q4: 如何实现 GaussDB 的自动升级？ ​

Q5: 如何确保部署脚本的安全性？ ​

Q6: 如何集成部署脚本到 CI/CD 流程中？ ​

Q7: 如何处理部署过程中的网络问题？ ​

Q8: 如何优化部署脚本的执行速度？ ​

Q9: 如何验证部署后的数据库状态？ ​

Q10: 如何维护和更新部署脚本？ ​

GaussDB 脚本化部署

脚本化部署优势

提高部署效率

确保部署一致性

便于版本管理

降低部署门槛

部署脚本设计原则

模块化设计

可配置性

错误处理

日志记录

可扩展性

单节点部署脚本

环境准备脚本

安装部署脚本

主从部署脚本

主节点配置脚本

从节点配置脚本

分布式部署脚本

集群配置脚本

部署脚本最佳实践

版本控制

测试验证

文档化

安全性考虑

日志和监控

常见问题（FAQ）

Q1: 如何处理部署脚本执行失败的情况？

Q2: 如何在不同环境中使用相同的部署脚本？

Q3: 如何自动化部署多个 GaussDB 实例？

Q4: 如何实现 GaussDB 的自动升级？

Q5: 如何确保部署脚本的安全性？

Q6: 如何集成部署脚本到 CI/CD 流程中？

Q7: 如何处理部署过程中的网络问题？

Q8: 如何优化部署脚本的执行速度？

Q9: 如何验证部署后的数据库状态？

Q10: 如何维护和更新部署脚本？