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

# 建立映像工作流程
<a name="image-workflow-create-resource"></a>

建立映像工作流程時，您可以更好地控制映像建立程序。您可以指定 Image Builder 建置映像時執行的工作流程，以及測試映像時執行的工作流程。您也可以指定客戶受管金鑰來加密工作流程資源。若要進一步了解工作流程資源的加密，請參閱 [Image Builder 中的加密和金鑰管理](data-protection.md#ib-encryption)。

對於影像建立，您可以指定一個建置階段工作流程，以及一或多個測試階段工作流程。根據您的需求，您甚至可以完全略過建置或測試階段。您可以在工作流程使用的 YAML 定義文件中設定工作流程採取的動作。如需 YAML 文件語法的詳細資訊，請參閱 [建立 YAML 工作流程文件](image-workflow-create-document.md)。

如需建立新建置或測試工作流程的步驟，請選取符合您將使用之環境的標籤。

------
#### [ AWS 管理主控台 ]

您可以使用下列程序，在映像建置器主控台中建立新的工作流程。

1. 開啟 EC2 Image Builder 主控台，位於 [https://console.aws.amazon.com/imagebuilder/](https://console.aws.amazon.com/imagebuilder/)。

1. 從導覽窗格中選擇**映像工作流程**。這會顯示您的帳戶擁有或可存取的影像工作流程清單。
**注意**  
您一律會在清單中看到 Image Builder 用於其預設工作流程的 Amazon 受管工作流程資源。若要檢視這些工作流程的詳細資訊，您可以選取**工作流程**連結。

1. 若要建立新的工作流程，請選擇**建立映像工作流程**。這會顯示**建立映像工作流程**頁面。

1. 設定新工作流程的詳細資訊。若要建立建置工作流程，請選取表單頂端附近的**建置**選項。若要建立測試工作流程，請選取表單頂端附近的**測試**選項。Image Builder 會根據此選項填入**範本**清單。建置和測試工作流程的所有其他步驟都相同。

**一般**  
一般區段包含適用於工作流程資源的設定，例如名稱和描述。一般設定包括下列項目：
   + **映像工作流程名稱** （必要） – 映像工作流程的名稱。名稱在您的帳戶中必須是唯一的。名稱長度最多可達 128 個字元。有效字元包括字母、數字、空格`-`、 和 `_`。
   + **版本** （必要） – 要建立之工作流程資源的語意版本 (*major.minor.patch*)。
   + **描述** （選用） – 選擇性地為您的工作流程新增描述。
   + **KMS 金鑰** （選用） – 您可以使用客戶受管金鑰來加密工作流程資源。如需詳細資訊，請參閱[使用客戶受管金鑰加密映像工作流程](data-protection.md#ib-workflow-encrypt-cmk)。

**定義文件**  
YAML 工作流程文件包含工作流程的所有組態。

**開始使用**
   + 若要從映像建置器預設範本開始做為工作流程的基準，請選取**從範本開始**選項。預設會選取此選項。在您從範本清單中選擇要使用的**範本**後，這會將您選取的範本的預設組態複製到新工作流程文件**的內容**中，您可以在其中進行變更。
   + 若要從頭開始定義工作流程文件，請選取**從頭開始**選項。這會將文件格式中一些重要部分的簡短大綱填入**內容**，以協助您開始使用。

   **內容**面板包含底部的狀態列，顯示 YAML 文件的警告或錯誤。如需如何建立 YAML 工作流程文件的詳細資訊，請參閱 [建立 YAML 工作流程文件](image-workflow-create-document.md)。

1. 當您完成工作流程時，或者如果您想要儲存進度並稍後返回，請選擇**建立工作流程**。

------
#### [ AWS CLI ]

在 中執行 **[create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html)**命令之前 AWS CLI，您必須建立包含工作流程所有組態的 YAML 文件。如需詳細資訊，請參閱[建立 YAML 工作流程文件](image-workflow-create-document.md)。

下列範例示範如何使用 [create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) AWS CLI 命令建立建置工作流程。`--data` 參數是指 YAML 文件，其中包含您建立之工作流程的建置組態。

**範例：建立工作流程**

```
aws imagebuilder create-workflow --name example-build-workflow --semantic-version 1.0.0 --type BUILD --data file://example-build-workflow.yml
```

**輸出：**

```
{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/build/example-build-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```

下列範例示範如何使用 [create-workflow](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/imagebuilder/create-workflow.html) AWS CLI 命令建立測試工作流程。`--data` 參數是指 YAML 文件，其中包含您建立之工作流程的建置組態。

**範例：建立測試工作流程**

```
aws imagebuilder create-workflow --name example-test-workflow --semantic-version 1.0.0 --type TEST --data file://example-test-workflow.yml
```

**輸出：**

```
{
	"workflowBuildVersionArn": "arn:aws:imagebuilder:us-west-2:111122223333:workflow/test/example-test-workflow/1.0.0/1",
	"clientToken": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222"
}
```

------