Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。

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

# 工作流程入門
<a name="workflows-getting-started"></a>

在本教學課程中，您將了解如何建立和設定您的第一個工作流程。

**提示**  
偏好從預先設定的工作流程開始？ 請參閱 [使用藍圖建立專案](projects-create.md#projects-create-console-template)，其中包含使用正常運作的工作流程、範例應用程式和其他資源設定專案的指示。

**Topics**
+ [先決條件](#get-started-create-workflow-prerequisites)
+ [步驟 1：建立和設定您的工作流程](#get-started-create-workflow-create)
+ [步驟 2：使用遞交儲存工作流程](#get-started-create-workflow-commit)
+ [步驟 3：檢視執行結果](#get-started-create-workflow-results)
+ [(選用) 步驟 4：清理](#get-started-create-workflow-cleanup)

## 先決條件
<a name="get-started-create-workflow-prerequisites"></a>

開始之前：
+ 您需要 CodeCatalyst **空間**。如需詳細資訊，請參閱[建立空間](spaces-create.md)。
+ 在 CodeCatalyst 空間中，您需要一個名為 的空專案：

  ```
  codecatalyst-project
  ```

   如需詳細資訊，請參閱[在 Amazon CodeCatalyst 中建立空專案](projects-create.md#projects-create-empty)。
+ 在專案中，您需要名為 的 CodeCatalyst **儲存庫**：

  ```
  codecatalyst-source-repository
  ```

  如需詳細資訊，請參閱[建立來源儲存庫](source-repositories-create.md)。

**注意**  
如果您有現有的專案和來源儲存庫，您可以使用它們；不過，在本教學課程結束時，建立新的專案和來源儲存庫可讓您更輕鬆地進行清除。

## 步驟 1：建立和設定您的工作流程
<a name="get-started-create-workflow-create"></a>

在此步驟中，您會建立和設定工作流程，在進行變更時自動建置和測試您的原始程式碼。

**建立工作流程**

1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。

1. 選擇**建立工作流程**。

   工作流程定義檔案會出現在 CodeCatalyst 主控台的 YAML 編輯器中。

**設定您的工作流程**

您可以在**視覺化**編輯器或 **YAML** 編輯器中設定工作流程。讓我們從 YAML 編輯器開始，然後切換到視覺化編輯器。

1. 選擇 **\$1 動作**以查看您可以新增至工作流程的工作流程動作清單。

1. 在**建置**動作中，選擇 **\$1** 將動作的 YAML 新增至工作流程定義檔案。您的工作流程現在如下所示。

   ```
   Name: Workflow_fe47
   SchemaVersion: "1.0"
   
   # Optional - Set automatic triggers.
   Triggers:
     - Type: Push
       Branches:
         - main
   
   # Required - Define action configurations.
   Actions:
     Build_f0:
       Identifier: aws/build@v1
   
       Inputs:
         Sources:
           - WorkflowSource # This specifies that the action requires this workflow as a source
   
       Outputs:
         AutoDiscoverReports:
           Enabled: true
           # Use as prefix for the report files
           ReportNamePrefix: rpt
   
       Configuration:
         Steps:
           - Run: echo "Hello, World!"
           - Run: echo "<?xml version=\"1.0\" encoding=\"UTF-8\" ?>" >> report.xml
           - Run: echo "<testsuite tests=\"1\" name=\"TestAgentJunit\" >" >> report.xml
           - Run: echo "<testcase classname=\"TestAgentJunit\" name=\"Dummy
               Test\"/></testsuite>" >> report.xml
   ```

   工作流程會將`WorkflowSource`來源儲存庫中的檔案複製到執行 `Build_f0`動作的運算機器、列印`Hello, World!`至日誌、探索運算機器上的測試報告，並將它們輸出至 CodeCatalyst 主控台**的報告**頁面。

1. 選擇**視覺化**，在視覺化編輯器中檢視工作流程定義檔案。視覺化編輯器中的欄位可讓您設定 YAML 編輯器中顯示的 YAML 屬性。

## 步驟 2：使用遞交儲存工作流程
<a name="get-started-create-workflow-commit"></a>

在此步驟中，您會儲存變更。由於工作流程會儲存為儲存庫中的`.yaml`檔案，因此您可以使用遞交儲存變更。

**遞交工作流程變更**

1. （選用） 選擇**驗證**，以確保工作流程的 YAML 程式碼有效。

1. 選擇 **Commit** (遞交)。

1. 在**工作流程檔案名稱**中，輸入工作流程組態檔案的名稱，例如 **my-first-workflow**。

1. 在**遞交訊息**中，輸入訊息以識別您的遞交，例如 **create my-first-workflow.yaml**。

1. 在**儲存庫**中，選擇您要在 () 中儲存工作流程的儲存庫`codecatalyst-repository`。

1. 在**分支名稱**中，選擇您要在 () 中儲存工作流程的分支`main`。

1. 選擇 **Commit** (遞交)。

您的新工作流程會出現在工作流程清單中。可能需要幾分鐘的時間才會顯示。

由於工作流程會與遞交一起儲存，而且工作流程已設定程式碼推送觸發，因此儲存工作流程會自動啟動工作流程執行。

## 步驟 3：檢視執行結果
<a name="get-started-create-workflow-results"></a>

在此步驟中，您會導覽至從遞交開始的執行，並檢視結果。

**檢視執行結果**

1. 選擇工作流程的名稱，例如 `Workflow_fe47`。

   顯示來源儲存庫 (**WorkflowSource**) 標籤和建置動作 （例如 **Build\$1f0**) 的工作流程圖表。

1. 在工作流程執行圖表中，選擇建置動作 （例如 **Build\$1f0**)。

1. 檢閱**日誌**、**報告**、**組態**和**變數**索引標籤的內容。這些索引標籤會顯示建置動作的結果。

   如需詳細資訊，請參閱[檢視建置動作的結果](build-view-results.md)。

## (選用) 步驟 4：清理
<a name="get-started-create-workflow-cleanup"></a>

在此步驟中，您會清除在本教學課程中建立的資源。

**刪除資源**
+ 如果您已為此教學課程建立新的專案，請將其刪除。如需說明，請參閱[刪除專案](projects-delete.md)。刪除專案也會刪除來源儲存庫和工作流程。