Automation Pipelines 可以與 VMware Aria Automation Orchestrator (Orchestrator) 進行整合，以透過執行 Orchestrator 工作流程來延伸其功能。VMware Aria Automation Orchestrator 包含許多可與第三方工具整合的預先定義的工作流程。這些工作流程可協助您自動執行和管理 DevOps 程序，自動執行大量作業等。

例如，您可以在管線的Orchestrator 工作中使用工作流程，以啟用使用者、移除使用者、移動虛擬機器，以及與測試架構整合以在管線執行時測試程式碼等。您可以在code.vmware.com 中瀏覽 VMware Aria Automation Orchestrator 工作流程的程式碼範例。

透過 VMware Aria Automation Orchestrator 工作流程，您的管線可以在建置、測試和部署應用程式時執行動作。您可以將預先定義的工作流程包含在管線中，也可以建立並使用自訂工作流程。每個工作流程皆包含輸入、工作和輸出。

若要在管線中執行 Orchestrator 工作流程，該工作流程必須顯示在管線中包含的 Orchestrator 工作的可用工作流程清單中。

管理員必須先在 VMware Aria Automation Orchestrator 中執行下列步驟，工作流程才會顯示在管線的 Orchestrator 工作中：

  1. 將 PIPELINES 標籤套用至 Orchestrator 工作流程。
  2. 將 Orchestrator 工作流程標記為全域工作流程。

做為內部部署端點，VMware Aria Automation Orchestrator 必須透過雲端 Proxy 與 Automation Pipelines 通訊。

必要條件

  • 確認您能夠以管理員身分存取 VMware Aria Automation Orchestrator 的內部部署執行個體。若要取得協助，請向您自己的管理員詢問並參閱vRealize Orchestrator 說明文件。
  • 確認您是 Automation Pipelines 中的專案的成員。如果您不是管理員，請要求 Automation Pipelines 管理員將您新增為專案成員。請參閱如何在 Automation Pipelines 中新增專案。
  • 在 VMware Aria Automation Assembler 中，建立雲端 Proxy，以便能夠在 Automation Pipelines 和 VMware Aria Automation Orchestrator 的內部部署執行個體之間進行通訊。如需如何建立雲端 Proxy 的範例，請參閱設定 Automation Pipelines 以建立發佈程序模型。
  • 瞭解針對內部部署端點使用雲端 Proxy 的重要性。請參閱什麼是 Automation Pipelines 中的端點。
  • 在 Automation Pipelines 中，建立管線並新增一個階段。

程序

  1. 做為管理員，請準備 VMware Aria Automation Orchestrator 工作流程以讓管線執行。
    1. 在 VMware Aria Automation Orchestrator 中，找到您需要在管線中使用的工作流程，例如，啟用使用者的工作流程。
      如果需要的工作流程不存在，您可以建立該工作流程。
    2. 在搜尋列中，輸入 Tag workflow，以找到名為 Tag workflow 的工作流程。
    3. 在名為 Tag workflow 的卡上，按一下執行，這將會顯示組態區域。
    4. 在標記的工作流程文字區域中，輸入要在 Automation Pipelines 管線中使用的工作流程名稱，然後從清單中加以選取。
    5. 在標籤和值文字區域中，以大寫字母輸入 PIPELINES。
    6. 按一下名為全域標籤的核取方塊。
    7. 按一下執行，將名為 PIPELINES 的標籤連結至需要在 Automation Pipelines 管線中選取的工作流程。
    8. 在導覽窗格中，按一下工作流程，並確認名為 PIPELINES 的標籤會顯示在管線將執行的工作流程卡上。
      登入 Automation Pipelines 並將 Orchestrator 工作新增至管線後，標記的工作流程會出現在工作流程清單中。
  2. 在 Automation Pipelines 中，為 VMware Aria Automation Orchestrator 執行個體建立端點。
    1. 按一下端點 > 新增端點。
    2. 選取專案。
    3. 輸入相關的名稱。
    4. 輸入 VMware Aria Automation Orchestrator 端點的 URL。
      請使用以下格式： https://orchestrator-appliance.yourdomain.local:8281
      請勿使用以下格式：https://orchestrator-appliance.yourdomain.local:8281/vco/api
      VMware Aria Automation 應用裝置中內嵌的 VMware Aria Automation Orchestrator 執行個體的 URL 是應用裝置的 FQDN，不具有連接埠。例如： https://automation-appliance.yourdomain.local/vco
      從 VMware Aria Automation 8.x 開始，對於外部 VMware Aria Automation Orchestrator Appliance，應用裝置的 FQDN 為 https://orchestrator-appliance.yourdomain.local
      對於 VMware Aria Automation 7.x 中包含的外部 VMware Aria Automation Orchestrator Appliance，應用裝置的 FQDN 為 https://orchestrator-appliance.yourdomain.local:8281/vco
      如果在新增端點時發生問題，您可能需要匯入具有 SHA-256 憑證指紋且已移除冒號的 YAML 組態。例如， B0:01:A2:72... 變為 B001A272...。範例 YAML 程式碼類似於： 
      ```
---
project: Demo
kind: ENDPOINT
name: external-orchestrator
description: ''
type: orchestrator
properties:
  url: https://yourVROhost.yourdomain.local
  username: yourusername
  password: yourpassword
  fingerprint: <your_fingerprint>
```
    5. 選取一個雲端 Proxy。
    6. 如果您輸入的 URL 需要憑證，請按一下接受憑證。
    7. 如果 VMware Aria Automation Orchestrator 端點的版本為 8.0 到 8.7，可以選取基本驗證或 Token 作為驗證類型。如果 VMware Aria Automation Orchestrator 端點的版本為 8.8 或更高版本，則必須選取 Token 作為驗證類型。
      備註： 如果 VMware Aria Automation Orchestrator 端點的版本為 8.8 或更高版本，請不要選取 基本驗證。不支援基本驗證，並且端點建立將失敗。
      • 如果選取基本驗證，請輸入 VMware Aria Automation Orchestrator 伺服器的使用者名稱和密碼。

        如果您使用非本機使用者進行驗證，則必須省略使用者名稱的網域部分。例如，若要使用 [email protected] 進行驗證，則必須在使用者名稱文字區域中輸入 svc_vro。

      • 如果選取 Token 作為驗證類型，請產生並貼上私人 Token。
        VMware Cloud Services API Token 會向您驗證與 Automation Pipelines 的外部 API 連線。取得 API Token：
        1. 登入 VMware Aria Automation。
        2. 登入
        3. 按一下您名稱旁邊的下拉式箭頭。
        4. 按一下我的帳戶。
        5. 按一下 API Token。
        6. 按一下產生新的 API Token。
          1. 輸入 Token 名稱。
          2. 在 [組織角色] 下，按一下以展開所有組織角色，然後選取組織擁有者。
          3. 在 [服務角色] 下，按一下以展開 VMware Aria Automation > Pipelines，然後選取 Pipelines 管理員。
          4. 按一下產生。

            已產生 Token 視窗會顯示具有您所指定名稱的 Token，以及您組織的名稱。

        7. 按一下複製圖示。

          按一下複製可確保您擷取精確字串，並且比使用指標複製字串更為可靠。

  3. 準備管線以執行 Orchestrator 工作。
    1. 向管線階段新增 Orchestrator 工作。
    2. 輸入相關的名稱。
    3. 在 [工作流程內容] 區域，選取 VMware Aria Automation Orchestrator 端點。
    4. 選取您在 VMware Aria Automation Orchestrator 中標記為 PIPELINES 的工作流程。
      如果您選取您建立的自訂工作流程，您可能需要輸入輸入參數值。
    5. 對於執行工作，按一下依條件。
      如果必須為 VMware Aria Automation Orchestrator 工作套用條件，請在條件區域中輸入。
    6. 輸入要在管線執行時套用的條件。
      何時執行管線... 選取條件...
      依條件

      只有在已定義的條件評估為 true 時才執行管線工作。如果條件為 false，則略過工作。

      Orchestrator 工作允許包含布林運算式，該運算式使用下列運算元和運算子。

      • 管線變數，例如 ${pipeline.variableName}。輸入變數時，僅可使用大括號。
      • 工作輸出變數，例如 ${Stage1.task1.machines[0].value.hostIp[0]}。
      • 預設管線繫結變數，例如 ${releasePipelineName}。
      • 不區分大小寫的布林值，例如 true、false、'true' 和 'false'。
      • 不含引號的整數值或小數值。
      • 具有單引號或雙引號的字串值，例如 "test" 和 'test'。
      • 字串和數字類型的值，例如 == Equals 和 != Not Equals。
      • 關聯性運算子，例如 >、>=、< 和 <=。
      • 布林邏輯，例如 && 和 ||。
      • 算術運算子，例如 +、-、* 和 /。
      • 使用圓括弧的巢狀運算式。
      • 包含文字值 ABCD 的字串評估為 false，因此會略過工作。
      • 不支援一元運算子。

      範例條件可以是 ${Stage1.task1.output} == “Passed” || ${pipeline.variableName} == 39

      一律 如果您選取一律，管線執行工作，而不需條件。
    7. 輸入問候訊息。
    8. 按一下驗證工作，並更正發生的任何錯誤。
  4. 儲存、啟用並執行管線。
  5. 管線執行後，檢查結果。
    1. 按一下執行。
    2. 按一下管線。
    3. 按一下工作。
    4. 檢查結果、輸入值和內容。
      您可以識別工作流程執行識別碼、回應工作的人員及時間，以及他們加入的任何註解。

結果

恭喜您！您已標記要在 Automation Pipelines 中使用的 VMware Aria Automation Orchestrator 工作流程，並在 Automation Pipelines 管線中新增了 Orchestrator 工作，以使其執行在 DevOps 環境中自動執行動作的工作流程。

範例： Orchestrator 工作輸出格式

Orchestrator 工作的輸出格式類似於以下範例。 

[{
                "name": "result",
                "type": "STRING",
                "description": "Result of workflow run.",
                "value": ""
},
{
                "name": "message",
                "type": "STRING",
                "description": "Message",
                "value": ""
}]

下一步

繼續將 Orchestrator 工作流程工作包含在管線中，以便在開發、測試和生產環境中自動執行工作。