pybackup使用文档

pybackup使用文档

https://github.com/Fanduzi/pybackup
pybackup源自于对线上备份脚本的改进和对备份情况的监控需求.
原本生产库的备份是通过shell脚本调用mydumper,之后再将备份通过rsync传输到备份机.
想要获取备份状态,时间,rsync传输时间等信息只能通过解析日志.
pybackup由python编写,调用mydumper和rsync,将备份信息存入数据库中,后期可以通过grafana图形化展示和监控备份
目前不支持2.6,仅在2.7.14做过测试

参数说明

帮助信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
[root@iZ23t8cwo3iZ backup_db]# python pybackup.py -h
Usage:
pybackup.py mydumper ARG_WITH_NO_--... (([--no-rsync] [--no-history]) | [--only-backup])
pybackup.py only-rsync [--backup-dir=<DIR>] [--bk-id=<id>] [--log-file=<log>]
pybackup.py -h | --help
pybackup.py --version

Options:
-h --help Show help information.
--version Show version.
--no-rsync Do not use rsync.
--no-history Do not record backup history information.
--only-backup Equal to use both --no-rsync and --no-history.
--only-rsync When you backup complete, but rsync failed, use this option to rsync your backup.
--backup-dir=<DIR> The directory where the backup files need to be rsync are located. [default: ./]
--bk-id=<id> bk-id in table user_backup.
--log-file=<log> log file [default: ./rsync.log]

more help information in:
https://github.com/Fanduzi

1
pybackup.py mydumper ARG_WITH_NO_--... (([--no-rsync] [--no-history]) | [--only-backup])

除了最后三个参数,使用的所有参数和mydumper -h中列出的参数相同. 只不过目前只支持长选项,并且不带’–’

例:

1
./pybackup.py mydumper password=fanboshi database=fandb outputdir=/data4/recover/pybackup/2017-11-12 logfile=/data4/recover/pybackup/bak.log verbose=3

可以使用./pybackup.py mydumper help查看mydumper帮助信息

–no-rsync

不使用rsync传输

–no-history

不记录备份信息到数据库

–only-backup

等价于同时使用–no-rsync和–no-history . 不能与–no-rsync或–no-history同时使用

1
pybackup.py only-rsync [--backup-dir=<DIR>] [--bk-id=<id>] [--log-file=<log>]

当备份成功rsync失败时可以使用only-rsync来同步备份成功的文件

–backup-dir

需要使用rsync同步的备份文件路径,如果不指定,则默认为./

–bk-id

user_backup表中记录的备份bk_id,如果指定,则会在rsync同步完成后更新指定bk_id行的,传输起始时间,耗时,是否成功等信息.如果不指定则不更新user_backup表

–log-file

本次rsync指定的日志,如果不指定,则默认为当前目录rsync.log文件

配置文件说明

配置文件为pbackup.conf

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
[root@localhost pybackup]# less pybackup.conf 
[CATALOG] --存储备份信息的数据库配置
db_host=localhost
db_port=3306
db_user=root
db_passwd=fanboshi
db_use=catalogdb

[TDB] --需要备份的数据库配置
db_host=localhost
db_port=3306
db_user=root
db_passwd=fanboshi
db_use=information_schema
db_consistency=True --0.7.0新增option,可以不写,不写则为False,后面会对这个option进行说明
db_list=test,fandb,union_log_ad_% --指定需要备份的数据库,可以使用mysql支持的通配符. 如果想要备份所有数据库则填写%

[rsync]
password_file=/data4/recover/pybackup/rsync.sec --等同于--password-file
dest=platform@xx.xx.xx.xx/db_backup/xx.xx.xx.xx --传输到哪个目录
address= --使用的网卡.可以为空不指定

注意
1
2
3
4
5
[TDB]
db_list=fan,bo,shi 代表备份fan,bo,shi三个数据库
db_list=!fan,!bo,!shi 代表不备份fan,bo,shi三个数据库
db_list=% 代表备份所有数据库
db_list=!fan,bo 不支持

还有一点需要注意,即便在配置文件中定义了db_list参数,也可以在命令行强制指定database=xx / regex / tables-list,例如
1
pybackup.py mydumper password="xx" user=root socket=/data/mysql/mysql.sock outputdir=/data/backup_db/ verbose=3 compress threads=8 triggers events routines use-savepoints logfile=/data/backup_db/pybackup.log database=yourdb

此时会只备份yourdb而忽略配置文件中的定义

备份信息示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
*************************** 4. row ***************************
id: 4
bk_id: bcd36dc6-c9e7-11e7-9e30-005056b15d9c
bk_server: xx.xx.xx.xx
start_time: 2017-11-15 17:31:20
end_time: 2017-11-15 17:32:07
elapsed_time: 47
backuped_db: fandb,test,union_log_ad_201710_db,union_log_ad_201711_db
is_complete: Y,Y,Y,Y
bk_size: 480M
bk_dir: /data4/recover/pybackup/2017-11-15
transfer_start: 2017-11-15 17:32:07
transfer_end: 2017-11-15 17:33:36
transfer_elapsed: 89
transfer_complete: Y
remote_dest: platform@xx.xx.xx.xx/db_backup/xx.xx.xx.xx/
master_status: mysql-bin.000036,61286,
slave_status: Not a slave
tool_version: mydumper 0.9.2, built against MySQL 5.5.53
server_version: 5.7.18-log
bk_command: mydumper --password=supersecrect --outputdir=/data4/recover/pybackup/2017-11-15 --verbose=3 --compress --triggers --events --routines --use-savepoints database=fandb,test,union_log_ad_201710_db,union_log_ad_201711_db

建库建表语句

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
create database catalogdb;
CREATE TABLE user_backup (
id INT AUTO_INCREMENT NOT NULL PRIMARY KEY,
bk_id CHAR(36) NOT NULL UNIQUE KEY,
bk_server VARCHAR(15) NOT NULL,
start_time DATETIME NOT NULL,
end_time DATETIME NOT NULL,
elapsed_time INT NOT NULL,
backuped_db VARCHAR(200) NOT NULL,
is_complete VARCHAR(30) NOT NULL,
bk_size VARCHAR(10) NOT NULL,
bk_dir VARCHAR(200) NOT NULL,
transfer_start DATETIME,
transfer_end DATETIME,
transfer_elapsed INT,
transfer_complete VARCHAR(20) NOT NULL,
remote_dest VARCHAR(200) NOT NULL,
master_status VARCHAR(200) NOT NULL,
slave_status VARCHAR(200) NOT NULL,
tool_version VARCHAR(200) NOT NULL,
server_version VARCHAR(200) NOT NULL,
bk_command VARCHAR(400) NOT NULL,
tag varchar(200) NOT NULL DEFAULT 'N/A',
is_deleted char(1) NOT NULL DEFAULT 'N'
) ENGINE=INNODB CHARACTER SET UTF8 COLLATE UTF8_GENERAL_CI;

关于db_consistency

1
./pybackup.py mydumper password=fanboshi database=fandb outputdir=/data4/recover/pybackup/2017-11-12 logfile=/data4/recover/pybackup/bak.log verbose=3

以上面命令为例,默认脚本逻辑对于db_list指定的库通过for循环逐一使用mydumper –database=xx 备份
如果知道db_consistency=True则会替换为使用 –regex备份db_list中指定的所有数据库, 保证了数据库之间的一致性

备份脚本示例

1
2
3
4
5
6
7
8
9
10
#!/bin/sh
DSERVENDAY=`date +%Y-%m-%d --date='2 day ago'`
DTODAY=`date +%Y-%m-%d`

cd /data/backup_db/
rm -rf $DTODAY
rm -rf $DSERVENDAY
mkdir $DTODAY
source ~/.bash_profile
python /data/backup_db/pybackup.py mydumper password="papapa" user=root socket=/data/mysql/mysql.sock outputdir=/data/backup_db/$DTODAY verbose=3 compress threads=8 triggers events routines use-savepoints logfile=/data/backup_db/pybackup.log

crontab

1
0 4 * * * /data/backup_db/pybackup.sh>> /data/backup_db/pybackup_sh.log 2>&1 

logroatate脚本

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
/data/backup_db/pybackup.log {
daily
rotate 7
missingok
compress
delaycompress
copytruncate
}

/data/backup_db/pybackup_sh.log {
daily
rotate 7
missingok
compress
delaycompress
copytruncate
}

Powered by Hexo and Hexo-theme-hiker

Copyright © 2013 - 2022 Fan() All Rights Reserved.

访客数 : | 访问量 :