循环ACS::Loop

循环数组

Items接受一个List，如一个直接的List：[item1, item2, item3]。

Items也可以是一个List类型的参数名，如上一个Task的List类型Outputs。

• Items为一个List。 

  YAML

  Loop:
    Items: [item1,item2,item3,item4] # 一个包含Item的List，如[i-id1,i-id2,i-id3,i-id4]，Items迭代作为Loop所在Task执行的参数。					

  JSON

  {
    "Items": [
      "item1",
      "item2",
      "item3",
      "item4"
    ]
  }		

• Items为一个List类型的参数名。 

  YAML

  Items: '{{ParameterName1}}' # 一个可被解析为List类型的参数名，如describeInstance.InstanceIds；Items迭代作为Loop所在Task执行的参数。	

  JSON

  {
    "Items": "{{ParameterName1}}"
  }		

任务执行速率

分两种模式：

1. 并发数控制，保持这个并发数的执行速率，直到所有item执行结束。

2. 批次控制，把item明确地分成多个批次，然后一个批次运行完再运行下一个批次，若上一个批次未全部完成的情况下，下一个批次不会开始。

并发数的控制（Concurrency）

• 如Items是10个item，并发是3，且会保持一直有3个item在并发，直到没有更多未执行的item。 

  YAML

  Concurrency: 3 # 允许数值或百分比表并发控制，如3。
  Mode: Concurrency

  JSON

  {
    "Concurrency": 3,
    "Mode": "Concurrency"
  }

• 如Items是10个item，并发是20%，表示20%*10=2的并发，且会保持一直有2个item在并发，直到没有更多未执行的item。

  YAML

  Concurrency: 20% # 可选，允许数值或百分比的定义方式，如20%。
  Mode: Concurrency

  JSON

  {
    "Concurrency": "20%",
    "Mode": "Concurrency"
  }

批次的控制（Batch）

• 如Items是10个item，批次是[3]，会将item分为大小为3的多个批次，结果为3，3，3，1，一共4个批次（假设item的执行结果都是成功）。 

  YAML

  Batch: [1, 2, 3] # 可选，允许List内含数值或百分比的方式定义表批次控制，如[3]。
  Mode: Batch

  JSON

  {
    "Batch": [
      1,
      2,
      3
    ],
    "Mode": "Batch"
  }

• 如Items是10个item，批次是[30%]，表示第一个批次是3，会将item分为大小为10*30%=3的多个批次，结果为3，3，3，1，一共4个批次（假设item的执行结果都是成功）：

  YAML

  Batch: [30%] # 可选，允许List内含数值或百分比的方式定义表批次控制，如[30%]。
  Mode: Batch
  					

  JSON

  {
    "Batch": [
      "30%"
    ],
    "Mode": "Batch"
  }

• 如Items是10个item，批次是[3,10%,30%]，表示第一个批次是3，第二个批次是总量的10%，第三个及以后批次为[30%]，结果为3，1，3，3一共4个批次（假设item的执行结果都是成功）

  YAML

  Mode: Batch
  Batch: [3, 10%,30%] # 可选，允许List内含多个数值或百分比的方式定义表批次控制，如[3, 10%,30%]。
  					

  JSON

  {
    "Mode": "Batch",
    "Batch": [
      3,
      "10%",
      "30%"
    ]
  }

错误控制MaxErrors

在Loop中，您也可以定义MaxErrors，其意义如下：

1. 允许数值或百分比（表现为Items乘以百分比）的定义方式，如10，或10%。默认为0，即任何错误都会暴露到loop-task级别。

2. Loop里面的第一个Item，总会被执行。

3. 是否能够执行到第二个Item或后续的Item取决于实际MaxErrors和ErrorCount的关系。 

   • 当实际ErrorCount>MaxErrors时，后续的Item停止执行，且当前Loop所在任务标记为失败。

   • 当实际的ErrorCount<=MaxErrors时，则持续向下执行。

4. 根据ErrorCount>MaxErrorsLoop判定Loop所在任务的执行状态，如果大于则是Failed，否则是Success。

• 数值方式定义。

  YAML

  MaxErrors: 2 # 可选，允许数值或百分比的定义方式，如2，表示允许最大ErrorCount为2。

  JSON

  {
   "MaxErrors": 2 
  }

• 百分比方式定义。 

  YAML

  MaxErrors:  25% # 可选，允许数值或百分比的定义方式，如25%，共4个Item则表示允许最大ErrorCount为25%*4=1。

  JSON

  {
   "MaxErrors": "25%"
  }

任务输出Outputs

您可以自定义ACS::Loop任务的输出。在ValueSelector中，您可以选取LoopTasks内的任务的输出。最终的输出，会以数组的方式，聚合每次循环的任务输出。

比如上面语法部分的例子中，假设deployRevisions任务会返回"deployRevisions example output"。

那最终deployCommandOutput会输出：

["deployRevisions example output",
"deployRevisions example output"]