perconalab/percona-toolkit

Percona Toolkit Docker镜像文档

镜像概述

本Docker镜像封装了Percona Toolkit工具集，提供一组开源高级命令行工具，专为MySQL、MongoDB等数据库的管理与维护设计。通过容器化部署，可在各类环境中便捷使用这些工具，无需手动配置依赖，简化数据库运维流程。

核心功能与特性

• 性能分析工具：包含pt-query-digest（慢查询日志分析）、pt-stalk（性能问题捕获）等，帮助定位数据库性能瓶颈
• 数据备份与恢复：提供pt-backup（全量/增量备份）、pt-archiver（数据归档）工具，支持安全高效的数据备份策略
• 数据同步与一致性：通过pt-table-sync（表数据同步）、pt-table-checksum（数据一致性校验）保障分布式数据库数据一致性
• 索引与表优化：pt-index-usage（索引使用分析）、pt-online-schema-change（无锁表结构变更）优化数据库结构
• 系统诊断工具：pt-summary（系统状态摘要）、pt-mysql-summary（MySQL状态摘要）快速收集系统与数据库信息

使用场景与适用范围

• 数据库性能监控：定期运行pt-query-digest分析慢查询日志，优化SQL语句
• 数据迁移与同步：跨数据库实例同步表数据，或校验主从复制数据一致性
• 日常维护任务：执行无锁表结构变更、索引优化、数据归档等运维操作
• 容器化环境集成：在Kubernetes、Docker Compose等容器编排平台中集成，作为数据库运维侧carrier

使用方法与配置说明

基本使用方式

通过docker run命令直接执行工具，基础格式：

bash
docker run --rm docker.xuanyuan.run/percona/percona-toolkit [工具名称] [工具参数]

示例：使用pt-query-digest分析本地慢查询日志

bash
# 将本地慢查询日志目录挂载到容器内，执行分析
docker run --rm -v /path/to/mysql/logs:/logs docker.xuanyuan.run/percona/percona-toolkit pt-query-digest /logs/slow.log

数据卷挂载

为访问主机数据库配置、日志或备份目录，需挂载数据卷：

• 挂载数据库配置文件（如my.cnf）：-v /local/path/to/my.cnf:/etc/my.cnf
• 挂载备份目标目录：-v /local/backup/dir:/backup
• 挂载日志文件目录：-v /local/log/dir:/logs

示例：执行数据备份并保存到本地目录

bash
docker run --rm -v /local/backup:/backup -v /etc/my.cnf:/etc/my.cnf docker.xuanyuan.run/percona/percona-toolkit pt-backup --user=root --password=xxx --host=mysql-host --backup-dir=/backup

数据库连接配置

工具通过命令行参数指定数据库连接信息，常用参数：

• --user：数据库用户名
• --password：数据库密码
• --host：数据库主机地址（容器网络中需使用服务名或IP）
• --port：数据库端口号

示例：校验主从数据库表一致性

bash
docker run --rm docker.xuanyuan.run/percona/percona-toolkit pt-table-checksum --user=repl --password=replpass --host=master-db --port=3306

Docker Compose集成示例

在docker-compose.yml中定义工具服务，便于与数据库服务联动：

yaml
version: '3'
services:
  percona-toolkit:
    image: docker.xuanyuan.run/percona/percona-toolkit
    volumes:
      - ./mysql/logs:/logs
      - ./backup:/backup
    command: pt-query-digest /logs/slow.log  # 默认执行慢查询分析
  mysql:
    image: docker.xuanyuan.run/percona/percona-server:8.0
    environment:
      - MYSQL_ROOT_PASSWORD=rootpass
    volumes:
      - mysql-data:/var/lib/mysql
      - ./mysql/logs:/var/log/mysql

volumes:
  mysql-data:

注意事项

• 工具执行需确保容器网络可访问目标数据库实例（通过--network参数指定网络）
• 敏感信息（如密码）建议通过环境变量或配置文件挂载传递，避免直接暴露在命令行
• 部分工具（如pt-online-schema-change）需对数据库有写权限，使用前需确认权限配置