Terragrunt 中标准输出重定向问题的分析与解决方案

问题背景

在使用 Terragrunt 工具进行基础设施管理时，用户发现一个看似简单却影响工作效率的问题：当尝试将 terragrunt plan 或 terragrunt apply 命令的输出重定向到文件时（如 > tfplan.txt），目标文件竟然是空的，而命令的输出却仍然显示在终端上。

技术原理分析

这个问题源于 Terragrunt 对 Terraform 标准输出（stdout）和标准错误（stderr）流的特殊处理方式。Terragrunt 作为 Terraform 的包装器，默认会对 Terraform 的日志输出进行增强处理，包括添加时间戳和日志级别等信息。

在实现上，Terragrunt 将所有日志信息（包括原本属于 Terraform stdout 的内容）都统一输出到了 stderr 流。而在 Unix/Linux 系统中，> 重定向操作符默认只捕获 stdout 流，不捕获 stderr 流，这就导致了看似"丢失"输出的现象。

临时解决方案

在当前版本（0.69.13）中，可以通过使用 --terragrunt-forward-tf-stdout 标志来解决这个问题：

terragrunt plan --terragrunt-forward-tf-stdout > tfplan.txt

这个标志会指示 Terragrunt 将 Terraform 的标准输出直接转发到 Terragrunt 的标准输出流，从而可以被常规的重定向操作捕获。

长期改进

Terragrunt 开发团队已经意识到这个问题对用户体验的影响，并在 0.71.0 版本中进行了改进。新版本重新设计了日志处理机制，将日志流合理分配到 stdout 和 stderr 两个通道中，所有 STDOUT 级别的日志都会默认输出到标准输出流。

这意味着在未来版本中，用户可以直接使用：

terragrunt plan > tfplan.txt

而无需任何额外参数就能获得预期的结果。

技术建议

对于需要自动化处理 Terraform 计划输出的场景，建议：

1. 升级到 Terragrunt 0.71.0 或更高版本以获得最佳体验
2. 如果必须使用旧版本，确保在脚本中添加 --terragrunt-forward-tf-stdout 标志
3. 对于需要同时捕获 stdout 和 stderr 的场景，可以使用 &> 操作符（在支持它的 shell 中）

这个改进体现了 Terragrunt 团队对用户体验的重视，也展示了开源项目如何通过社区反馈不断优化自身的行为模式。