Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

在 EC2 TOE中使用循环结构

本部分提供了有助于您在 EC2 TOE中创建循环结构的信息。循环结构定义了重复的指令序列。您可以在 EC2 TOE中使用以下类型的循环结构：

引用迭代变量

要引用当前迭代变量的索引和值，必须在包含循环结构的步骤的输入主体中使用引用表达式 {{ loop.* }}。此表达式不能用于引用另一个步骤的循环结构的迭代变量。

引用表达式由以下成员组成：

循环名称

所有循环结构都有一个用于标识的可选名称字段。如果提供了循环名称，则可以使用它来引用步骤输入主体中的迭代变量。要引用命名循环的迭代索引和值，请在步骤的输入主体中使用带 {{ loop.* }} 的 {{ <loop_name>.* }}。此表达式不能用于引用另一个步骤的命名循环结构。

引用表达式由以下成员组成：

解析引用表达式

解 EC2 TOE 析引用表达式如下：

如果在不包含循环的步骤中使用引用表达式，则 EC2 TOE 不会解析这些表达式，并且它们出现在步骤中而不进行替换。

循环结构的类型

本节提供有关可在 EC2 TOE中使用的循环结构类型的信息和示例。

for 循环

该 for 循环迭代处于由变量开头和结尾勾勒的边界内指定的整数范围。迭代值在集合 [start, end] 中，包括边界值。

EC2 TOE 验证startend、和updateBy值，以确保组合不会导致无限循环。

for 循环架构

name: "StepName"
action: "ActionModule"
loop:
  name: "string"
  for:
    start: int
    end: int
    updateBy: int
inputs:
  ...

for 循环输入示例

name: "CalculateFileUploadLatencies"
action: "ExecutePowerShell"
loop:
  for:
    start: 100000
    end: 1000000
    updateBy: 100000
inputs:
  commands:
    - |
      $f = new-object System.IO.FileStream c:\temp\test{{ loop.index }}.txt, Create, ReadWrite
      $f.SetLength({{ loop.value }}MB)
      $f.Close()
    - c:\users\administrator\downloads\latencyTest.exe --file c:\temp\test{{ loop.index }}.txt
    - Amazon s3 cp c:\users\administrator\downloads\latencyMetrics.json s3://bucket/latencyMetrics.json
    - |
      Remove-Item -Path c:\temp\test{{ loop.index }}.txt
      Remove-Item -Path c:\users\administrator\downloads\latencyMetrics.json

forEach 使用输入列表循环

该 forEach 循环迭代一个显式的值列表，该列表可以是字符串和链式表达式。

forEach 使用输入列表架构进行循环

name: "StepName"
action: "ActionModule"
loop:
  name: "string"
  forEach:
    - "string"
inputs:
  ...

forEach 使用输入列表循环示例 1

name: "ExecuteCustomScripts"
action: "ExecuteBash"
loop:
  name: BatchExecLoop
  forEach:
    - /tmp/script1.sh
    - /tmp/script2.sh
    - /tmp/script3.sh
inputs:
  commands:
    - echo "Count {{ BatchExecLoop.index }}"
    - sh "{{ loop.value }}"
    - |
      retVal=$?
      if [ $retVal -ne 0 ]; then
        echo "Failed"
      else
        echo "Passed"
      fi

forEach 使用输入列表循环示例 2

name: "RunMSIWithDifferentArgs"
action: "ExecuteBinary"
loop:
  name: MultiArgLoop
  forEach:
    - "ARG1=C:\Users ARG2=1"
    - "ARG1=C:\Users"
    - "ARG1=C:\Users ARG3=C:\Users\Administrator\Documents\f1.txt"
inputs:
  commands:
    path: "c:\users\administrator\downloads\runner.exe"
    args:
      - "{{ MultiArgLoop.value }}"

forEach 使用输入列表循环示例 3

name: "DownloadAllBinaries"
action: "S3Download"
loop:
  name: MultiArgLoop
  forEach:
    - "bin1.exe"
    - "bin10.exe"
    - "bin5.exe"
inputs:
  -
    source: "s3://bucket/{{ loop.value }}"
    destination: "c:\temp\{{ loop.value }}"

forEach 使用带分隔列表的循环

该循环遍历包含由分隔符分隔的值的字符串。要遍历字符串的组成部分，请 EC2 TOE 使用分隔符将字符串拆分为适合迭代的数组。

forEach 使用分隔列表架构的循环

name: "StepName"
action: "ActionModule"
loop:
  name: "string"
  forEach:
    list: "string"
    delimiter: ".,;:\n\t -_"
inputs:
  ...

forEach 使用分隔列表循环示例 1

// Uses chaning expression ({{ <phase_name>.<step_name>.inputs/outputs.<var_name> }})
// to refer to another step's input/output variables for code re-use.
name: "RunMSIs"
action: "ExecuteBinary"
loop:
  forEach:
    list: "{{ build.GetAllMSIPathsForInstallation.outputs.stdout }}"
    delimiter: "\n"
inputs:
  commands:
    path: "{{ loop.value }}"

forEach 使用分隔列表循环示例 2

name: "UploadMetricFiles"
action: "S3Upload"
loop:
  forEach:
    list: "/tmp/m1.txt,/tmp/m2.txt,/tmp/m3.txt,..."
inputs:
  commands:
    -
      source: "{{ loop.value }}"
      destination: "s3://bucket/key/{{ loop.value }}"

步骤字段

循环是步骤的一部分。任何与步骤运行相关的字段都不会应用于单个迭代。步骤字段仅应用于步骤级别，如下所示：

步骤和迭代输出

每次迭代都包含一个输出。在循环运行结束时， EC2 TOE 将所有成功的迭代输出合并到中。detailedOutput.json合并输出是属于相应输出键的值的排序规则，这些值在操作模块的输出架构中定义。下面的示例说明如何合并输出：

迭代 1 的 ExecuteBash 的输出

[{"stdout":"Hello"}]

迭代 2 的 ExecuteBash 的输出

[{"stdout":"World"}]

步骤的 ExecuteBash 的输出

[{"stdout":"Hello\nWorld"}]

例如，ExecuteBash、ExecutePowerShell 和 ExecuteBinary 是操作模块，其返回 STDOUT 作为操作模块输出。STDOUT 消息与换行符连接以在 detailedOutput.json 中生成步骤的总体输出。

EC2 TOE 不会合并失败迭代的输出。