本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

在 中使用循環建構 AWS TOE

本節提供的資訊可協助您在 中建立迴圈建構 AWS TOE。循環建構定義重複的指令序列。您可以在 中使用下列類型的循環建構 AWS TOE：

參考反覆運算變數

若要參考目前迭代變數的索引和值，參考表達式{{ loop.* }}必須在包含迴圈建構的步驟輸入內使用。此表達式無法用來參考另一個步驟的循環建構的迭代變數。

參考表達式包含下列成員：

迴圈名稱

所有循環建構都有用於識別的選用名稱欄位。如果提供迴圈名稱，則可用來參考步驟輸入內文中的迭代變數。若要參考具名迴圈的迭代索引和值，請在步驟的輸入內文{{ <loop_name>.* }}{{ loop.* }}中使用 。此表達式無法用來參考另一個步驟的命名循環建構。

參考表達式包含下列成員：

解析參考表達式

會 AWS TOE 解析參考表達式，如下所示：

如果在不包含迴圈的步驟中使用參考表達式，則 AWS TOE 不會解析表達式，而且它們會顯示在步驟中，不會替換。

循環建構的類型

本節提供可在 中使用的循環建構類型的相關資訊和範例 AWS TOE。

for 迴圈

for 迴圈會在變數開始和結束所概述的邊界內指定的整數範圍上反覆運算。迭代值位於集合中[start, end]，並包含邊界值。

AWS TOE 驗證 start、 end和 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
        - AWS 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 具有分隔清單的迴圈

迴圈會反覆運算字串，其中包含以分隔符號分隔的值。若要反覆運算字串的元件， AWS TOE 請使用分隔符號將字串分割為適合反覆運算的陣列。

forEach 具有分隔清單結構描述的迴圈

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

forEach 使用分隔清單的迴圈範例 1

此範例使用下列鏈結表達式模式來參考另一個步驟的輸出：<phase_name>.<step_name>.[inputs | outputs].<var_name>。

  - 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 }}"

步驟欄位

迴圈是步驟的一部分。任何與執行步驟相關的欄位都不會套用至個別迭代。步驟欄位僅適用於步驟層級，如下所示：

步驟和迭代輸出

每次迭代都包含輸出。在迴圈執行結束時， AWS TOE 會合併 中的所有成功迭代輸出detailedOutput.json。合併輸出是屬於動作模組輸出結構描述中定義的對應輸出金鑰的值的定序。下列範例顯示輸出合併的方式：

適用於迭代 1 ExecuteBash的 輸出

{
	"stdout":"Hello"
}

適用於迭代 2 ExecuteBash的 輸出

{
	"stdout":"World"
}

ExecuteBash適用於步驟的 輸出

{
	"stdout":"Hello\nWorld"
}

例如，ExecuteBash、 ExecutePowerShell和 ExecuteBinary是STDOUT作為動作模組輸出傳回的動作模組。STDOUT訊息會加入新的行字元，以產生 中步驟的整體輸出detailedOutput.json。

AWS TOE 不會合併失敗反覆運算的輸出。