使用 AWS Step Functions - AWS Toolkit for VS Code
必要條件在 VS 代碼中使用狀態機国家机模板狀態機圖形可視化程式碼片段程式碼完成與驗證

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

使用 AWS Step Functions

您可以使用 AWS Toolkit for Visual Studio Code （VS 代碼）與狀態機執行各種操作。

必要條件

在 VS 代碼中使用狀態機

您可以使用 VS Code 與遠端狀態機器互動，並以 JSON 或 YAML 格式在本機開發狀態機器。您可以建立或更新狀態機器、列出現有的狀態機器、執行並下載它們。VS Code 還可讓您從範本建立新狀態機器、檢視狀態機器的視覺效果，並提供程式碼片段、程式碼完成和程式碼驗證。

列出現有狀態機

如果您已建立狀態機器，則可以檢視狀態機器列表：

  1. 開啟 AWS Explorer。

  2. 選擇 Step Functions

  3. 驗證列在您帳戶中的所有狀態機器。

下載狀態機

如何下載狀態機器：

  1. 在AWS 檔案總管中，以滑鼠右鍵按一下您要下載的狀態機器。

  2. 選取 Download (下載)，然後選取您要下載狀態機器的位置。

  3. 請確認狀態機器已正確下載。

建立狀態機器

您可以自行建立新的狀態機器，也可以使用範本。如需從範本建立狀態機器的詳細資訊，請參閱狀態機器範本一節。如何建立新的狀態機器：

  1. 使用狀態機器定義，建立新的 Amazon 狀態語言 (ASL) 檔案。使用右下角的功能表，將其設置為 Amazon 狀態語言。

  2. 選取發佈至 Step Functions。

  3. 選取快速建立、選擇角色，然後命名您的狀態機器。

更新狀態機器

如何更新狀態機器：

  1. 使用狀態機器定義編輯 ASL 檔案。

  2. 選取發佈至 Step Functions。

  3. 選取快速更新，然後選取您要更新的狀態機器。

運行狀態機

要運行狀態機：

  1. 在資AWS 源管理器中，右鍵單擊要運行的狀態機器。

  2. 為狀態機提供輸入。您可以嘗試從文件輸入，以及在文字方塊中輸入。

  3. 啟動狀態機並驗證它是否成功運行。

国家机模板

建立狀態機器時，可以從範本選擇建立狀態機器。範本包含具有數種常用狀態的範例狀態機器定義，並提供您一個起點。如何使用狀態機器範本：

  1. 在 VS 代碼中打開命令調色板。

  2. 選取AWS 工具組建立新的 Step Functions 狀態機器。

  3. 選擇您要使用的範本。

  4. 選擇您要使用 JSON 或 YAML 範本格式。

狀態機圖形可視化

圖形視覺化可讓您以圖形格式檢視狀態機器的外觀。當您創建圖形可視化時，另一個選項卡將打開並顯示狀態機 JSON 或 YAML 的可視化。然後，您可以將您同時正在寫入的狀態機器定義及其視覺效果進行比較。變更狀態機器定義時，將更新視覺化。

注意

若要建立狀態機器定義的視覺化，必須在作用中的編輯器中開啟定義。若您關閉或重新命名定義檔，則將關閉視覺化。

如何建立狀態機器圖形視覺化：

  1. 定義您的狀態機器。

  2. 在 VS 代碼中打開命令調色板。

  3. 若要建立視覺效果，請使用右上角的視覺效果按鈕，或選擇「AWS 彩現圖表」。

程式碼片段

程式碼片段可讓您插入程式碼的一小段。如何使用程式碼片段：

  1. 開啟檔案並以 JSON 格式或 .asl.yaml YAML 格式.asl.json的副檔名儲存檔案。

  2. 使用狀態屬性，建立新的狀態機器。

  3. 將游標放置在狀態內。

  4. 使用按鍵組合 Control + Space，然後選取您偏好的程式碼片段。

  5. 用 Tab 於遍歷程式碼片段中的變數和參數。

  6. 將游標放置在相關狀態內，以測試 Retry 和 Catch 片段。

程式碼完成與驗證

如何檢視程式碼完成的運作方式：

  1. 建立數個狀態。

  2. 將游標置於「下一個」StartAt、或「預設」性質之後。

  3. 使用按鍵組合 Control + Space，列出可用的完成項目。額外屬性均可以用 Control + Space 再次存取，並將以 State 的 Type 為基礎。

  4. 工作時，程式碼驗證將檢視：

    • 缺少屬性

    • 不正確的值

    • 無終端狀態

    • 指向不存在的狀態