Kargo项目中ClusterPromotionTasks输出变量的正确使用方法

在Kargo项目中，ClusterPromotionTasks和PromotionTasks是两种重要的任务类型，它们都支持通过步骤(step)来定义工作流。然而，在使用输出变量(outputs)时，开发者可能会遇到一些困惑和问题。

输出变量的基本概念

Kargo的工作流步骤可以产生输出变量，这些变量可以被后续步骤引用。输出变量的定义通常在一个步骤的配置中，通过outputs字段指定。例如，一个HTTP请求步骤可以提取响应头中的日期作为输出变量。

ClusterPromotionTasks中的输出变量引用

在ClusterPromotionTasks中，引用其他步骤的输出变量需要使用task.outputs前缀。这是与PromotionTemplates的一个重要区别，后者直接使用outputs前缀。

正确的引用格式如下：

timestamp: ${{ task.outputs['gettime'].timestamp }}

常见问题分析

开发者在使用ClusterPromotionTasks时可能会遇到以下问题：

1. 直接使用outputs前缀会导致变量解析失败
2. 错误的缩进格式可能导致YAML解析错误
3. 步骤名称引用错误会导致"task不存在"的错误提示

最佳实践建议

1. 始终在ClusterPromotionTasks和PromotionTasks中使用task.outputs前缀引用输出变量
2. 确保YAML格式正确，特别是缩进对齐
3. 验证步骤名称是否与as字段定义的一致
4. 在PromotionTemplates中使用outputs前缀

示例配置

以下是一个完整的ClusterPromotionTask示例，展示了如何正确定义和使用输出变量：

apiVersion: kargo.akuity.io/v1alpha1
kind: ClusterPromotionTask
metadata:
  name: get-time
spec:
  steps:
  - uses: http
    as: gettime
    config:
      method: GET
      url: https://example.com
      outputs:
      - name: timestamp
        fromExpression: response.headers['Date'][0]
  - uses: compose-output
    config:
      timestamp: ${{ task.outputs['gettime'].timestamp }}

通过遵循这些规则和实践，开发者可以避免在使用ClusterPromotionTasks时遇到输出变量相关的问题，确保工作流能够正确执行。