本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
使用工作流程建置、測試和部署
在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 .
折線圖 | 描述 |
---|---|
|
指定工作流程的名稱。如需 |
|
指定工作流程結構描述版本。如需 |
|
指示 CodeCatalyst 如何處理多個執行。如需執行模式的詳細資訊,請參閱 設定執行的佇列行為。 |
|
指定會導致工作流程執行開始的邏輯。關於觸發條件的詳細資訊,請參閱 使用觸發器啟動工作流程自動執行。 |
|
表示每當您將程式碼推送到預設來源儲存庫的 |
|
定義工作流程執行期間要執行的任務。在此範例中, |
|
定義 |
|
指定建置動作的唯一、硬式編碼識別符。 |
|
表示建置動作應該在 |
|
包含建置動作特有的組態屬性。 |
|
告知建置動作,以建置名為 的 Docker 映像, |
如需工作流程定義檔案中所有可用屬性的完整清單,請參閱 工作流程YAML定義。
使用 CodeCatalyst 主控台的視覺效果和YAML編輯器
若要建立和編輯工作流程定義檔案,您可以使用偏好的編輯器,但建議使用 CodeCatalyst 主控台的視覺化編輯器或YAML編輯器。這些編輯器提供有用的檔案驗證,以協助確保YAML屬性名稱、值、巢狀、間距、大小寫等正確。
下圖顯示視覺化編輯器中的工作流程。視覺化編輯器提供您完整的使用者介面,可讓您透過此界面建立和設定工作流程定義檔案。視覺化編輯器包含工作流程圖 (1),其中顯示工作流程的主要元件,以及組態區域 (2)。
或者,您可以使用YAML編輯器,如下圖所示。使用YAML編輯器貼入大型程式碼區塊 (例如,從教學課程),或新增未透過視覺效果編輯器提供的進階屬性。
您可以從視覺效果編輯器切換到YAML編輯器,以查看組態對基礎YAML程式碼的影響。
探索工作流程
您可以在工作流程摘要頁面上檢視工作流程,以及您在相同專案中設定的其他工作流程。
下圖顯示工作流程摘要頁面。它會填入兩個工作流程: BuildToProd和 UnitTests。您可以看到兩者都已執行幾次。您可以選擇最近執行來快速查看執行歷史記錄,或選擇工作流程的名稱來查看工作流程的YAML程式碼和其他詳細資訊。
檢視工作流程執行詳細資訊
您可以在工作流程摘要頁面中選擇執行,以檢視工作流程執行的詳細資訊。
下圖顯示名為 Run-cc11d 的工作流程執行詳細資訊,該執行是在遞交來源時自動啟動。工作流程圖表指出動作失敗 (1)。您可以導覽至日誌 (2),以檢視詳細的日誌訊息並疑難排解問題。如需工作流程執行的詳細資訊,請參閱 執行工作流程。
後續步驟
若要進一步了解工作流程概念,請參閱 工作流程概念。
若要建立第一個工作流程,請參閱 工作流程入門。