数据库运维【免费下载链接】MySQLTuner-perlMySQLTuner is a script written in Perl that will assist you with your MySQL configuration and make recommendations for increased performance and stability.项目地址https://gitcode.com/gh_mirrors/my/MySQLTuner-perl点击查看免费下载导读MySQLTuner-perl 的实验室测试套件build/test_envs.sh会在每次运行时向examples/目录写入海量的报告产物若不加以控制磁盘占用与检索成本会持续膨胀。本文以仓库内.agent/workflows/examples-cleanup.md工作流文档为主线逐层拆解该清理机制的完整闭环从触发入口、底层清理函数、独立清理脚本到 Makefile 集成与验证方法。读完本文你将掌握如何按需保留最近 N 次测试结果、清理逻辑的实现原理以及该机制在 CI 与手动维护中的正确用法。一、工作流文档与清理机制的定位仓库.agent/workflows/目录存放面向 Agent 与自动化流程的显式调用型工具说明。examples-cleanup.md 是其中的一份精简工作流定义其全文骨架如下--- trigger: explicit_call description: Maintain only the 10 most recent results in the examples directory category: tool --- 1. Execute the cleanup logic from the build script: bash build/test_envs.sh --cleanup 2. Verify that the examples/ directory count is reduced to 10.从 YAML frontmatter 可以读出该工作流的三个关键属性属性取值含义triggerexplicit_call不会在 CI 或启动时自动触发必须由人工或 Agent 显式调用descriptionMaintain only the 10 most recent results目标明确examples/只保留最近 10 次结果categorytool属于工具类流程依赖build/下的脚本实现也就是说这是一个两步入仓式的维护流程先执行清理命令再校验结果数量防止误删或清理失效。该工作流在 releases/v2.8.30.md 中有明确出处ci: automate cleanup of examples/ directory to keep only the 10 most recent results与ci: add /examples-cleanup workflow for manual laboratory maintenance说明其既是 CI 自动化的一部分也为手动实验室维护提供了入口。二、examples/目录里到底装了什么产物的来源与结构要理解清理逻辑必须先清楚examples/的产物从何而来。实验室编排脚本 build/test_envs.sh 是所有产物的生产者脚本启动时执行mkdir -p $EXAMPLES_DIREXAMPLES_DIR$PROJECT_ROOT/examples每次针对一个数据库配置跑实验室测试时创建以时间戳命名的结果目录local current_date$(date %Y%m%d_%H%M%S) local root_target_dir$EXAMPLES_DIR/${current_date}_${config} mkdir -p $root_target_dir因此examples/下的每个一级子目录都遵循YYYYMMDD_HHMMSS_config命名规范例如20260925_003000_mysql84这一规范是后续按新旧排序清理的前提。在每个结果目录内部脚本依次执行四种审计场景for scenario in Standard Container Dumpdir Schemadir每个场景生成独立子目录并产出report.html汇总仪表盘由generate_report()生成含执行时间轴、运行时审计、产物文件清单mysqltuner_report.htmlMySQLTuner 独立 HTML 报告mysqltuner_output.txtMySQLTuner 原始文本输出execution.log完整执行轨迹stdout/stderrdocker_start.log、db_injection.log、container_logs.log、container_inspect.json基础设施与容器相关日志dumps/与schemas/Dumpdir/Schemadir 场景下的数据与结构快照ps_*.csv、ifs_*.csv、sys_*.csv等。可见一个单次实验室运行即可产生数十个文件若不清理长期累积会显著膨胀仓库体积这正是清理机制存在的直接动因。三、核心入口build/test_envs.sh --cleanup的实现3.1 参数解析在 build/test_envs.sh 的参数解析循环中--cleanup被单独识别并切换运行模式--cleanup) MODEcleanup shift ;;帮助信息中同样声明了该选项--cleanup Maintain only 10 latest results in examples/。3.2 清理函数cleanup_examples()脚本在run_cmd、check_exit_code等辅助函数之后定义了清理函数约第 176181 行# Maintain only 10 latest results in examples/ cleanup_examples() { log_step Cleaning up old examples (keeping 10 latest)... # List directories in EXAMPLES_DIR, sort by modification time descending, skip first 10, then remove the rest. ls -dt $EXAMPLES_DIR/*/ 2/dev/null | tail -n 11 | xargs -r rm -rf }逐段拆解这条一行清理的核心逻辑管道段作用ls -dt $EXAMPLES_DIR/*/列出examples/下所有一级目录*/通配只匹配目录-t按修改时间从新到旧排序-d只显示目录本身2/dev/null屏蔽目录不存在时的报错tail -n 11跳过最新 10 条即保留最近 10 个结果输出第 11 条及以后的所有旧目录xargs -r rm -rf对每条旧目录执行递归删除-r保证输入为空时不执行删除命令避免报错值得注意ls -t依赖文件系统记录的目录修改时间mtime。由于每次测试都会在新目录内写入文件新目录的 mtime 自然大于旧目录同时cleanup_examples在每次完整实验室运行结束主流程case $MODE之后都会被调用一次形成边跑边清的自维护闭环# Always cleanup at the end of a successful run cleanup_examples而在cleanup模式下--cleanup主流程直接调用该函数后即退出cleanup) cleanup_examples exit 0 ;;3.3 两种调用路径的对比场景触发方式保留数量行为显式清理bash build/test_envs.sh --cleanup10只执行清理并退出不启动任何容器运行后自动清理任意 lab/container/remote 测试结束10测试完毕后顺带清理保证目录始终精简两者复用同一个cleanup_examples()函数行为完全一致这也是.agent/workflows/examples-cleanup.md可以放心把--cleanup作为唯一命令的原因。四、独立清理脚本build/clean_examples.sh与 KEEP 参数除了集成在test_envs.sh中的清理逻辑仓库还提供了一个更通用、参数化的独立版本 build/clean_examples.sh。它同样以examples/为清理对象但把保留数量抽象为命令行参数set -euo pipefail EXAMPLES_DIRexamples KEEP${1:-5}核心差异在于排序与筛选方式DIRS_TO_DELETE$(ls -1d $EXAMPLES_DIR/*/ 2/dev/null | sort -r | tail -n $((KEEP 1)))这里不再依赖 mtime而是按目录名的字典序逆序sort -r筛选——因为目录名自带YYYYMMDD_HHMMSS_config时间前缀字典序与时间序完全一致sort -r等价于最新在前。随后逐目录打印并删除for dir in $DIRS_TO_DELETE; do echo Deleting $dir rm -rf $dir done两种实现各有侧重test_envs.sh --cleanup保留数量固定为 10贴合实验室最近 10 次的既定策略clean_examples.shKEEP可调默认保留 5 个灵活应对不同维护需求且set -euo pipefail使脚本在异常时立即失败更适合作独立工具使用。从 documentation/QUALITY_AND_TESTING.md 的脚本清单也可以印证其定位Cleanup Utility用途为Keeps theexamples/directory lean by pruning oldest test run folders参数[KEEP]默认 5。五、Makefile 集成把清理变成一等公民清理逻辑被完整接入了项目构建体系见 Makefileclean_examples: echo Cleaning up examples... bash build/clean_examples.sh $(KEEP)默认执行make clean_examples等效于bash build/clean_examples.shKEEP 默认 5指定保留数量make clean_examples KEEP10即保留最近 10 个结果目录与工作流文档的策略一致帮助文本中亦有声明clean_examples: Cleanup examples directory (KEEPn, default 5)。更重要的是test-parallel目标把并行测试与清理串联成一个完整流程test-parallel: vendor_setup echo Running MySQLTuner Parallel Lab Tests... bash build/parallel_test.sh $(MAKE) clean_examples KEEP10这表示并行实验室测试全部成功后自动执行清理并固定保留 10 份结果——正是.agent/workflows/examples-cleanup.md中10这个数字在 CI 侧的对应实现。清理由此不再依赖人工而是内建于质量流水线。六、验证步骤如何确认清理成功工作流文档的第二步是Verify that theexamples/directory count is reduced to 10。仓库中虽然没有专门的自动化断言脚本但该验证可以完全借助标准的 Shell 命令完成# 统计 examples/ 下的一级目录数量清理后应为 10 ls -1d examples/*/ | wc -l # 或使用 find 的 maxdepth 计数 find examples -maxdepth 1 -type d ! -name examples | wc -l # 查看保留的是否为最新 10 个按时间从新到旧 ls -dt examples/*/验证要点数量一级子目录数必须等于 10或等于KEEP指定值多则清理未生效少则可能存在误删时效性保留的必须是最近的结果——由于目录名带时间戳前缀ls -1d examples/*/ | sort -r | head -n 10输出的目录应与实际保留目录完全一致完整性抽查保留目录内仍包含report.html、execution.log等关键产物确认清理只删旧不伤新。若清理后发现数量不符可从以下角度排查确认目录确实遵循YYYYMMDD_HHMMSS_config命名规范clean_examples.sh的sort -r依赖此规范确认examples/下没有混入非结果目录如 README 等文件不会被*/通配命中但若存在其他无时间戳前缀的目录排序可能失真。七、机制要点与使用建议综合.agent/workflows/examples-cleanup.md与仓库实现可以总结出该清理机制的几条工程要点双入口单逻辑test_envs.sh --cleanup与clean_examples.sh KEEPn分别面向固定 10 份和可调数量两种场景选择时按需使用命名规范即排序依据YYYYMMDD_HHMMSS_config的目录命名让 mtime 排序ls -t与字典序排序sort -r等价这是清理正确性的根基自动化与手动并存test-parallel在 CI 侧自动清理--cleanup工作流在手动维护侧按需清理二者共用同一保留策略避免仓库因测试产物膨胀验证闭环清理动作本身不可信必须通过目录计数与时效性校验确认结果这正是工作流文档把Verify列为第二步的原因。对于使用该仓库测试基础设施的开发者建议将make clean_examples KEEP10纳入常规实验室维护流程若只想临时瘦身直接执行bash build/test_envs.sh --cleanup即可两者都能让examples/保持最近 10 次结果的整洁状态为后续审计如make audit-logs对examples/的日志扫描提供稳定的输入集合。参考路径速查工作流定义.agent/workflows/examples-cleanup.md实验室编排与清理主入口build/test_envs.sh独立清理脚本KEEP 可调build/clean_examples.shMakefile 集成Makefile测试基础设施文档documentation/QUALITY_AND_TESTING.md功能引入记录releases/v2.8.30.md赞分享数据库运维【免费下载链接】MySQLTuner-perlMySQLTuner is a script written in Perl that will assist you with your MySQL configuration and make recommendations for increased performance and stability.项目地址https://gitcode.com/gh_mirrors/my/MySQLTuner-perl点击查看免费下载相关推荐如何用 InsForge Sites 把前端项目部署上线并配置环境变量与自定义域名如何用 InsForge Sites 把前端项目部署上线并配置环境变量与自定义域名 InsForge Sites 用于把你在 InsForge 项目上构建的前端数据库运维MySQLTuner-perl Docker 磁盘清理工作流从 docker system df 到自动回收的完整实践MySQLTuner perl Docker 磁盘清理工作流从 docker system df 到自动回收的完整实践 导读 本指南围绕 MySQLTune数据库运维AKO4PTO 迭代记录规范PTO 算子调优实验产物的结构化留存与可复现管理AKO4PTO 迭代记录规范PTO 算子调优实验产物的结构化留存与可复现管理 AKO4PTO agents/skills/pto costmodel age算子库人工智能CANN创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考