开发者工具·文本比较
在部署之前比较配置文件：小更改，大后果
· 为什么它很重要
文本差异 配置 部署
主张在任何配置更改上线之前对其进行快速逐行比较，并捕获常见的单字符错误。
单字符中断 — 以缺少分号或交换端口开头，快速比较会发现
单字符配置编辑可以产生很大的操作效果，但 diff 只能证明字符发生了变化。端口、主机、布尔值或分隔符在部署之前值得仔细检查，因为复制已知良好的文件可能会携带不相关的编辑以及预期的编辑。
通过批准的流程捕获实际部署的版本和候选版本。比较经过编辑的文本，而不是重新键入任一侧。重新输入会创建第三个版本，并削弱显示的行描述部署系统将消耗的内容的证据。
为什么即使您只更改了一件事，配置也应该有差异 - 解释编辑器、格式化程序和复制粘贴如何引入您不希望的更改
即使是所谓的单一设置更改也可能包括格式化程序输出、行结束转换、复制注释或重复条目。 ToolAcre 在拆分时对 CR、LF 和 CRLF 进行标准化，因此其报告重点关注行内容而不是物理结束字节。这很有用，但应该记录下来。
从忽略大小写和忽略空格开始。普通结果是最接近的行文本帐户。只有在检查之后，您才应该启用标准化来诊断噪声，因为每个选项都会故意使一些不同的原始行比较为相等。
在结果中查找什么 — 列出典型的结果：重复的键、更改的默认值、值中的杂散空格、错误粘贴的凭据
检查删除和添加的值、重复的键、描述操作假设的更改注释以及意外引入候选人的凭据。更改的行不会自动出错，并且未更改的行并不能证明整个文件有效。
注意没有附近替换的删除。替换编辑显示为删除和添加，而缺失的行可能表示省略的所需设置。该工具的摘要对行进行计数；它不会对特定配置语言的键、默认值或强制字段进行分类。
工作示例：.env 文件和 nginx 块的两个版本 - 显示比较，其中忽略大小写隐藏无害的键大小写更改并揭示真实的主机更改
比较 `.env` 摘录，其中 `API_HOST=internal-a` 变为 `API_HOST=internal-b`，然后比较端口从 443 更改为 80 的服务器块。每个都应该产生一个删除的旧行和一个添加的新行。根据部署请求验证这些更改，而不是凭直觉。
该大纲称为关键案例更改无害，但 diff 源无法证明任何配置解析器都以这种方式处理案例。保持启用区分大小写，除非格式自己的文档建立了等效性。忽略大小写是一个查看选项，而不是关于名称的语义保证。
大小写更改并未被证明对配置键无害；审查它们时区分大小写
环境文件可能包含令牌、密码或内部端点。审查的 Text diff 调用路径在本地计算，没有比较请求，但最小化仍然是第一位的。在两侧一致地替换秘密或仅比较审查所需的非秘密区域。
不要仅仅因为实现是在浏览器端而粘贴实时凭据。扩展、剪贴板实用程序和设备策略位于算法之外。当材料受到监管或对生产敏感时，请使用经批准的本地差异，并将此路线视为适当编辑文本的便利。
浏览器端比较避免了处理端点，但仍应首先编辑机密
此比较不会解析配置语法、解析包含、识别隐藏键或预测运行时行为。文件可以没有文本更改，但仍会以不同的方式进行部署，因为环境变量、默认值或依赖文件在其他地方发生了更改。
它也不会应用候选者或将其回滚。在文本审查后使用格式的解析器、应用程序试运行和部署控制。行比较是捕获意外编辑的一扇门；它不能替代配置验证或操作测试。
要点：每次部署前三十秒 — 总结习惯以及 ToolAcre 的文本比较如何适应它而无需登录或上传
使比较成为一个简短、可重复的预部署步骤：获取权威状态、编辑、与严格选项进行比较、调查每个意外行，然后运行语法和应用程序检查。如果您的发布流程支持已审查的工件哈希值，则记录它们，并将结果链接到确切的候选版本而不是稍后的工作副本。
ToolAcre 非常有用。它的狭窄性使证据易于理解：添加、删除和未更改的行，并显示原始文本。部署决策仍然属于系统所有者和经过验证的部署过程，包括经过测试的回滚准备情况。