Kargo项目中kustomize-set-image步骤的文档更新解析

在Kargo项目v1.3.0版本发布后，kustomize-set-image步骤的一个关键行为变更需要引起用户注意。该步骤原先具备的"自动继承Freight中镜像标签"的便捷功能已被移除，这一变化直接影响了用户在使用该功能时的配置方式。

kustomize-set-image步骤是Kargo项目中用于在Kustomize配置中更新镜像引用的重要组件。在早期版本中，当用户未明确指定tag或digest字段时，系统会自动使用关联Freight中定义的镜像标签。这种设计虽然简化了配置，但也带来了隐式行为的复杂性。

随着Kargo项目向更明确、更可控的方向发展，开发团队决定移除这种"魔法"行为。从v1.3.0版本开始，用户必须显式地指定tag或digest字段，否则kustomize-set-image步骤将无法正常工作。这一变更虽然增加了配置的明确性要求，但显著提高了系统的可预测性和可维护性。

对于从旧版本升级的用户，需要特别注意检查所有使用kustomize-set-image步骤的配置，确保每个步骤都明确指定了tag或digest参数。这一变更也反映了现代基础设施管理工具向显式声明式配置发展的趋势，有助于减少潜在的错误和混淆。

在实际使用中，建议用户结合Kargo的表达式系统来动态设置这些值，这样既能保持配置的明确性，又能获得足够的灵活性。这种显式配置的方式虽然初期需要更多的工作量，但从长期来看，它能提供更好的可维护性和更清晰的意图表达。