使用工作流程建置、測試及部署 - Amazon CodeCatalyst

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

使用工作流程建置、測試及部署

CodeCatalyst開發環境中撰寫應用程式程式碼並將其推送到CodeCatalyst 原始碼儲存庫之後,您就可以進行部署。自動執行此操作的方法是通過工作流程。

工作流程是一種自動化程序,描述如何在持續整合和持續交付 (CI/CD) 系統中建置、測試及部署程式碼。工作流程會定義工作流程執行期間要採取的一系列步驟或動作。工作流程也會定義導致工作流程啟動的事件或觸發器。若要設定工作流程,您可以使用 CodeCatalyst 主控台的視覺效果或YAML編輯器建立工作流程定義檔案

提示

若要快速瞭解如何在專案中使用工作流程,請使用藍圖建立專案。每個藍圖都會部署運作正常的工作流程,您可以檢閱、執行和試驗。

關於工作流程定義檔

工作流程定義檔案是描述您工作流程的YAML檔案。依預設,檔案儲存在來源儲存庫根目錄的~/.codecatalyst/workflows/資料夾中。檔案的副檔名可以是 .yml 或 .yaml,副檔名必須為小寫。

以下是簡單工作流程定義檔案的範例。我們在下面的表中解釋這個例子的每一行。

Name: MyWorkflow SchemaVersion: 1.0 RunMode: QUEUED Triggers: - Type: PUSH Branches: - main Actions: Build: Identifier: aws/build@v1 Inputs: Sources: - WorkflowSource Configuration: Steps: - Run: docker build -t MyApp:latest .
折線圖 描述
Name: MyWorkflow

指定工作流程的名稱。若要取得有關Name性質的更多資訊,請參閱頂層屬性

SchemaVersion: 1.0

指定工作流程結構描述版本。若要取得有關SchemaVersion性質的更多資訊,請參閱頂層屬性

RunMode: QUEUED

指示 CodeCatalyst 處理多個梯段的方式。如需執行模式的詳細資訊,請參閱設定執行的佇列行為

Triggers:

指定將導致工作流程執行開始的邏輯。關於觸發條件的詳細資訊,請參閱 使用觸發器啟動工作流程自動執行

- Type: PUSH Branches: - main

指出每當您將程式碼推送至預設來源儲存庫的main分支時,工作流程都必須啟動。如需有關工作流程來源的詳細資訊,請參閱將來源儲存庫連線至工作

Actions:

定義工作流程執行期間要執行的工作。在此範例中,Actions區段定義了名為的單一動作Build。如需動作的詳細資訊,請參閱配置工作流動作

Build:

定義動Build作的屬性。如需建置動作的詳細資訊,請參閱以工作流程建置

Identifier: aws/build@v1

指定建置動作的唯一硬式編碼識別元。

Inputs: Sources: - WorkflowSource

指出建置動作應該在來WorkflowSource源儲存庫中尋找完成處理所需的檔案。如需詳細資訊,請參閱 將來源儲存庫連線至工作

Configuration:

包含建置動作特定的組態屬性。

Steps: - Run: docker build -t MyApp:latest .

告訴構建操作構建一個名為 Docker 映像MyApp並標記它。latest

如需工作流程定義檔案中所有可用性質的完整清單,請參閱工作流YAML定義

使用 CodeCatalyst 控制台的視覺效果和YAML編輯器

若要建立和編輯工作流程定義檔案,您可以使用偏好的編輯器,但我們建議您使用 CodeCatalyst 主控台的視覺化編輯器或編YAML輯器。這些編輯器提供有用的檔案驗證,以協助確保YAML性質名稱、值、巢狀、間距、大寫等正確無誤。

下圖顯示了可視化編輯器中的工作流程。視覺化編輯器為您提供完整的使用者介面,透過該介面建立和設定工作流程定義檔案。可視化編輯器包括工作流程圖 (1) 顯示工作流程的主要元件,以及配置區域 (2)。

工作流程視覺化

或者,您可以使用編YAML輯器,顯示在下一個圖像。使用YAML編輯器貼上大型程式碼區塊 (例如,自學課程),或加入視覺化編輯器未提供的進階性質。

流程YAML編輯器

您可以從可視化編輯器切換到YAML編輯器,以查看您的配置對基礎YAML代碼的效果。

探查工作流

您可以在 [工作流摘要] 頁面上檢視工作流程,以及您在同一專案中設定的其他工作流程。

下圖顯示 [工作流程摘要] 頁面。它會填入兩個工作流程:BuildToProdUnitTests。您可以看到兩者都已經運行了幾次。您可以選擇 [最近執行] 以快速查看執行歷程記錄,或選擇工作流程名稱以查看工作流程的程YAML式碼和其他詳細資訊。

工作流日誌

檢視工作流程執行詳

您可以在 [工作流程摘要] 頁面中選擇執行,以檢視工作流程執行的詳細資訊。

下圖顯示了名為 Run-CC11d 的工作流程執行的詳細資料,該工作流程執行是在提交至來源時自動啟動的。工作流程圖表示動作失敗 (1)。您可以瀏覽至記錄 (2) 以檢視詳細的記錄訊息並疑難排解問題。如需工作流程執行的更多資訊,請參閱執行工作流程

工作流日誌

後續步驟

若要進一步瞭解工作流程概念,請參閱工作流概念

若要建立第一個工作流程,請參閱開始使用工作流程