Kargo项目中Git Clone文档的commitFrom函数使用修正

在Kargo项目的Git Clone功能文档中，发现了一个关于commitFrom函数使用方式的技术细节问题。该问题涉及Promotion Steps中Git仓库提交引用的正确获取方式。

问题背景

Kargo是一个用于Kubernetes应用交付的工具，其中的Git Clone功能允许用户在Promotion Steps中克隆Git仓库。文档中原本的示例代码使用了commitFrom(vars.gitRepo)来获取提交信息，但这种方式实际上是不完整的。

技术细节分析

commitFrom函数返回的是一个包含多个字段的对象，其中.ID字段才是我们真正需要的提交哈希值。原始文档中遗漏了.ID后缀，这会导致在实际使用中无法正确获取提交ID。

正确的用法应该是：

- commit: ${{ commitFrom(vars.gitRepo).ID }}

影响范围

这个问题不仅存在于文档的主示例中，在项目维护者检查后发现还有其他几处类似的问题。这些文档错误可能会给用户带来困惑，特别是在自动化流程配置时。

解决方案

项目维护团队已经及时修复了这个问题，更新了所有相关的文档示例。用户在配置Git Clone步骤时，现在可以清楚地看到正确的commitFrom函数使用方法。

最佳实践建议

在使用Kargo的Git Clone功能时，建议开发者：

1. 始终使用.ID后缀来获取提交哈希
2. 检查返回对象的其他可用字段（如提交消息、作者等）
3. 在复杂场景下，可以先输出完整对象查看可用字段

这个问题虽然看似简单，但体现了配置工具时精确性的重要性。正确的函数调用方式能确保自动化流程的可靠性，避免因配置错误导致的部署问题。