• 2026 年 4 月 30 日之後將不再提供 AWS Systems Manager CloudWatch Dashboard。客戶可以繼續使用 Amazon CloudWatch 主控台來檢視、建立和管理其 Amazon CloudWatch 儀表板，就像現在一樣。如需詳細資訊，請參閱 [Amazon CloudWatch Dashboard 文件](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 教學課程：使用視覺化設計體驗建立執行手冊
在本教學課程中，您將了解使用 Systems Manager Automation 提供的視覺化設計體驗的基礎概念。在視覺化設計體驗中，您可以建立使用多個動作的執行手冊。您可使用拖放功能來排列畫布上的動作。您也可搜尋、選取和設定這些動作。然後，您可檢視執行手冊工作流程自動產生的 YAML 程式碼，退出結束視覺化設計體驗，執行該執行手冊，以及檢閱執行詳細資料。
本教學課程還將向您展示如何更新執行手冊並查看新版本。在教學課程結束時，您可執行清理步驟並刪除執行手冊。
完成本教學課程之後，您就會知道如何使用視覺化設計體驗來建立執行手冊。您還將知道如何更新、執行和刪除您的執行手冊。
**注意**
在您開始教學課程之前，請務必先完成 [設定自動化](automation-setup.md)。
**Topics**
+ [步驟 1：導覽至視覺化設計體驗](#navigate-console)
+ [步驟 2：建立工作流程](#create-workflow)
+ [步驟 3：檢閱自動產生的程式碼](#view-generated-code)
+ [步驟 4：執行新的執行手冊](#use-tutorial-runbook)
+ [步驟 5：清除](#cleanup-tutorial-runbook)
## 步驟 1：導覽至視覺化設計體驗
1. 登入 [Systems Manager Automation 主控台](https://console.aws.amazon.com/systems-manager/automation/home?region=us-east-1#/)。
1. 選擇**建立自動化**以儲存執行手冊。
## 步驟 2：建立工作流程
在視覺化設計體驗中，工作流程是畫布上您的執行手冊的圖形表示。您可以使用視覺化設計體驗來定義、設定和檢查執行手冊的個別動作。
**若要建立工作流程**
1. 在**設計**和**程式碼**切換按鈕旁，選取鉛筆圖示，然後輸入執行手冊的名稱。針對本教學，輸入 **VisualDesignExperienceTutorial**。
![\[視覺化設計體驗為您的執行手冊命名\]](http://docs.aws.amazon.com/zh_tw/systems-manager/latest/userguide/images/visual_designer_tutorial_name.png)
1. 在**表單**面板的**文件屬性**區段中，展開**輸入參數**下拉式清單，然後選取**新增參數**。
1. 在**參數名稱**欄位中，輸入 **InstanceId**。
1. 在**類型**下拉式清單中，選擇 **AWS::EC2::Instance**。
1. 選取**必要**切換按鈕。
![\[為您的執行手冊建立一個參數\]](http://docs.aws.amazon.com/zh_tw/systems-manager/latest/userguide/images/visual_designer_actions_tutorial_parameter.png)
1. 在 **AWS API** 瀏覽器中，在搜尋列輸入 **DescribeInstances**。
1. 將 **Amazon EC2 - DescribeInstances** 動作拖曳至空白畫布。
1. 對於**步驟名稱**，輸入值。在本教學課程中，您可以使用名稱 **GetInstanceState**。
![\[選擇一個 Amazon EC2 描述執行個體 API 動作。\]](http://docs.aws.amazon.com/zh_tw/systems-manager/latest/userguide/images/visual_designer_tutorial_api_action.png)
1. 展開**其他輸入**下拉式清單，然後在**輸入名稱**欄位中輸入 **InstanceIds**。
1. 選擇**輸入**索引標籤。
1. 在**輸入值**欄位中，選擇 **InstanceId** 文件輸入。這會參考您在程序開始時建立的輸入參數值。由於 `DescribeInstances` 動作的 **InstanceIds** 輸入接受 `StringList` 值，因此您必須以方括號包裝 **InstanceId** 輸入。**輸入值**的 YAML 應符合下方項目：**['\$1\$1 InstanceId \$1\$1']**。
1. 在**輸出**索引標籤中，選取**新增輸出**，然後在**名稱**欄位中輸入 **InstanceState**。
1. 在**選取器**欄位中輸入 **\$1.Reservations[0].Instances[0].State.Name**。
1. 在**類型**下拉式清單中選擇**字串**。
1. 從**動作**瀏覽器拖曳**分支**動作，並將其放置在 **`GetInstanceState`** 步驟下方。
1. 對於**步驟名稱**，輸入值。在本教學課程中，使用名稱 `BranchOnInstanceState`。
若要定義分支邏輯，請執行下列操作：
1. 在畫布上選擇 **`Branch`** 狀態。然後，在**輸入**和**選擇**下，選取鉛筆圖示，以編輯**規則 \$11**。
1. 選擇**新增條件**。
1. 在**規則 \$11 的條件**對話方塊中，從**變數**下拉式清單中選擇 **GetInstanceState.InstanceState** 步驟輸出。
1. 對於**運算子**，選擇**等於**。
1. 對於**值**，從下拉式清單中選擇**字串**。輸入 **stopped**。
![\[定義分支動作的條件。\]](http://docs.aws.amazon.com/zh_tw/systems-manager/latest/userguide/images/visual_designer_tutorial_condition.png)
1. 選取**儲存條件**。
1. 選擇**新增新的規則**。
1. 選擇**規則 \$12** 的**新增條件**。
1. 在**規則 \$12 的條件**對話方塊中，從**變數**下拉式清單中選擇 **GetInstanceState.InstanceState** 步驟輸出。
1. 對於**運算子**，選擇**等於**。
1. 對於**值**，從下拉式清單中選擇**字串**。輸入 **stopping**。
1. 選取**儲存條件**。
1. 選擇**新增新的規則**。
1. 對於**規則 \$13**，選擇**新增條件**。
1. 在**規則 \$13 的條件**對話方塊中，從**變數**下拉式清單中選擇 **GetInstanceState.InstanceState** 步驟輸出。
1. 對於**運算子**，選擇**等於**。
1. 對於**值**，從下拉式清單中選擇**字串**。輸入 **running**。
1. 選取**儲存條件**。
1. 在**預設規則**中，針對**預設步驟**選擇**移至結尾**。
1. 將**變更執行個體狀態**動作拖曳至 **\$1\$1 GetInstanceState.InstanceState \$1\$1 == "stopped"** 條件下方空白的**拖曳至此處**方塊。
1. 對於**步驟名稱**，輸入 **StartInstance**。
1. 在**輸入**索引標籤的**執行個體 ID** 下，從下拉式清單中選擇 **InstanceId** 文件輸入值。
1. 對於**所需狀態**，請指定 **`running`**。
1. 將**等待 AWS 資源**動作拖曳至 **\$1\$1 GetInstanceState.InstanceState \$1\$1 == "stopping"** 條件下的空白**拖曳動作此處**方塊。
1. 對於**步驟名稱**，輸入值。在本教學課程中，使用名稱 `WaitForInstanceStop`。
1. 在**服務**欄位中，選擇 **Amazon EC2**。
1. 在 **API** 欄位中，選擇 **DescribeInstances**。
1. 在**屬性選取器**欄位中輸入 **\$1.Reservations[0].Instances[0].State.Name**。
1. 對於**所需值**參數，輸入 **`["stopped"]`**。
1. 在 **WaitForInstanceStop** 動作的**組態**索引標籤中，從**下一步**下拉式清單中選擇 **StartInstance**。
1. 將**在執行個體上執行命令**動作拖曳至 **\$1\$1 GetInstanceState.InstanceState \$1\$1 == "running"** 條件下方空白的**拖曳至此處**方塊。
1. 對於**步驟名稱**，輸入 **SayHello**。
1. 在**輸入**索引標籤中，為**文件名稱**參數輸入 **AWS-RunShellScript**。
1. 對於 **InstanceIds**，從下拉式清單中選擇**執行個體 ID** 文件輸入值。
1. 展開**其他輸入**下拉式清單，然後在**輸入名稱**下拉清單中選擇**參數**。
1. 在**輸入值**欄位中輸入 **`{"commands": "echo 'Hello World'"}`**。
1. 檢閱畫布中已完成的執行手冊，然後選取**建立手冊**以儲存教學執行手冊。
![\[檢閱並建立執行手冊。\]](http://docs.aws.amazon.com/zh_tw/systems-manager/latest/userguide/images/visual_designer_tutorial_complete.png)
## 步驟 3：檢閱自動產生的程式碼
當您將動作從**動作**瀏覽器拖放到畫布上時，視覺化設計體驗會即時自動撰寫執行手冊的 YAML 或 JSON 內容。您可檢閱和編輯此程式碼。若要檢視自動產生的程式碼，請為**設計**和**程式碼**切換按鈕選取**程式碼**。
## 步驟 4：執行新的執行手冊
建立您的執行手冊後，您可以執行自動化。
**若要執行新的自動化執行手冊**
1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。
1. 在導覽窗格中，選擇 **Automation (自動化)**，接著選擇 **Execute automation (執行自動化)**。
1. 在 **Automation document** (自動化文件) 清單中，選擇 Runbook。在 **Document categories** (文件類別) 窗格中選擇一個或多個選項，根據 SSM 文件的用途來進行篩選。若要檢視您擁有的 Runbook，請選擇 **Owned by me** (我所擁有的) 索引標籤。若要檢視與您帳戶共用的 Runbook，請選擇 **Shared with me** (與我共用的) 索引標籤。若要檢視所有 Runbook，請選擇 **All documents** (所有文件) 索引標籤。
**注意**
您可以選擇 Runbook 名稱檢視 Runbook 資訊。
1. 在 **Document details** (文件詳細資訊) 部分，確認 **Document version** (文件版本) 設定為您想要執行的版本。系統包括以下版本選項：
+ **執行期的預設版本**：如果 Automation 執行手冊會定期更新且已指派新的預設版本，則請選擇此選項。
+ **執行期的最新版本**：如果 Automation 執行手冊會定期更新，而您想要執行最近更新的版本，請選擇此選項。
+ **1 (預設)**：選擇此選項以執行文件的第一個版本，也是預設版本。
1. 選擇**下一步**。
1. 在**執行自動化執行手冊**章節中，選擇**簡易執行**。
1. 在 **Input parameters (輸入參數)** 部分，指定所需的輸入。或者，您也可以從 **AutomationAssumeRole** 清單中選擇 IAM 服務角色。
1. (選用) 選擇要套用至您的自動化以便加以監控的 Amazon CloudWatch 警示。若要將 CloudWatch 警示連接至您的自動化，啟動自動化的 IAM 主體必須具備 `iam:createServiceLinkedRole` 動作的許可。如需有關 CloudWatch 警示的詳細資訊，請參閱[使用 Amazon CloudWatch 警示](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/AlarmThatSendsEmail.html)。如果您的警示啟用，則會停止自動化。如果使用 AWS CloudTrail，則您會在追蹤中看到 API 呼叫。
1. 選擇 **Execute (執行)**。
## 步驟 5：清除
**若要刪除您的執行手冊**
1. 在 https：//[https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/) 開啟 AWS Systems Manager 主控台。
1. 在導覽窗格中，選擇 **Documents (文件)**。
1. 選擇**我所擁有**索引標籤。
1. 找到 **VisualDesignExperienceTutorial** 執行手冊。
1. 選取文件卡頁面上的按鈕，然後從**動作**下拉式清單中選擇**刪除文件**。