Terragrunt v0.67.0 日志格式变更解析与应对方案

Terragrunt 作为 Terraform 的包装工具，在最新发布的 v0.67.0 版本中对日志输出格式进行了重大变更。这一改动引起了社区广泛讨论，本文将深入分析变更内容、技术背景以及用户应对方案。

日志格式变更概述

在 v0.67.0 版本之前，Terragrunt 会直接将 Terraform 的输出原样传递到标准输出(STDOUT)。更新后，所有输出都采用了结构化日志格式，每条输出前都添加了时间戳、日志级别和来源标识。例如：

13:13:16.454 STDOUT terraform: data.terraform_remote_state.infrastructure_network: Reading...

这一变更旨在解决多模块并行执行时的日志混淆问题，但同时也带来了以下影响：

1. 原有工具链中依赖纯 Terraform 输出的脚本可能失效
2. 日志行长度显著增加，降低了可读性
3. 错误输出与标准输出都采用了相同格式

技术背景与设计考量

Terragrunt 开发团队做出这一变更主要基于以下技术考量：

1. 多模块执行清晰度：在 run-all 命令执行多个模块时，结构化日志能明确标识每条日志的来源模块
2. 执行环境上下文：时间戳和日志级别为问题诊断提供了更多上下文信息
3. 统一日志处理：为后续的日志过滤、分析和自定义格式奠定基础

用户应对方案

针对不同使用场景，用户可采用以下解决方案：

恢复旧版输出格式

1. 全局环境变量方案：

export TERRAGRUNT_FORWARD_TF_STDOUT=true
export TERRAGRUNT_LOG_DISABLE=true

2. 单次执行方案：

terragrunt --terragrunt-forward-tf-stdout --terragrunt-log-level error plan

高级日志控制

在即将发布的 v0.68.x 版本中，Terragrunt 将引入自定义日志格式功能，用户可以通过配置精确控制日志输出内容：

export TERRAGRUNT_LOG_FORMAT='{{.Time}} {{.Level}} [{{.Prefix}}] {{.Message}}'

最佳实践建议

1. CI/CD 环境：建议启用结构化日志以便问题追踪
2. 本地开发：可根据个人偏好选择简化输出
3. 脚本处理：确保正确处理 STDOUT 和 STDERR 流

未来发展方向

Terragrunt 团队表示将持续改进日志系统，重点方向包括：

1. 更灵活的自定义格式支持
2. 针对不同命令的差异化日志策略
3. 改进错误输出处理机制

这一变更虽然短期内可能带来适配成本，但从长远看将为大规模基础设施管理提供更好的可观测性支持。用户可根据实际需求选择合适的过渡方案，并关注后续版本的功能增强。