Amazon CodeCatalyst 不再向新客戶開放。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[如何從 CodeCatalyst 遷移](migration.md)。
本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 設定執行的佇列行為
根據預設，在 Amazon CodeCatalyst 中，當多個工作流程執行同時發生時，CodeCatalyst 會將它們排入佇列，並依啟動順序逐一處理。您可以指定*執行模式*來變更此預設行為。有幾種執行模式：
+ （預設） 佇列執行模式 – CodeCatalyst 程序會逐一執行
+ 取代的執行模式 – CodeCatalyst 程序會逐一執行，而較新的執行會覆寫較舊的執行
+ 平行執行模式 – CodeCatalyst 程序平行執行
如需工作流程執行的詳細資訊，請參閱 [執行工作流程](workflows-working-runs.md)。
**Topics**
+ [關於排入佇列的執行模式](#workflows-configure-runs-queued)
+ [關於取代的執行模式](#workflows-configure-runs-superseded)
+ [關於平行執行模式](#workflows-configure-runs-parallel)
+ [設定執行模式](#workflows-configure-runs-configure)
## 關於排入佇列的執行模式
在*佇列執行模式中*，執行會依序發生，等待執行會形成佇列。
佇列會在動作和動作群組的進入點形成，因此您可以在*相同的工作流程中擁有多個佇列* （請參閱 [Figure 1](#figure-1-workflow-queued-run-mode))。當排入佇列的執行進入動作時，動作會遭到鎖定，而且無法進入其他執行。當執行完成並結束動作時，動作會變成解除鎖定並準備好供下次執行使用。
[Figure 1](#figure-1-workflow-queued-run-mode) 說明在佇列執行模式中設定的工作流程。它顯示：
+ 七個執行透過工作流程運作。
+ 兩個佇列：一個在輸入來源的項目之外 (**Repo：main**)，另一個在 **BuildTestActionGroup** 動作的項目之外。
+ 兩個鎖定的區塊：輸入來源 (**Repo：main**) 和 **BuildTestActionGroup**。
以下是當工作流程執行完成處理時，實物會轉傳的方式：
+ 當 **Run-4d444** 完成來源儲存庫的複製時，它會結束輸入來源，並加入 **Run-3c333** 後面的佇列。然後，**Run-5e555** 將輸入輸入來源。
+ 當 **Run-1a111** 完成建置和測試時，它會結束 **BuildTestActionGroup** 動作並輸入 **DeployAction** 動作。然後，**Run-2b222** 將輸入 **BuildTestActionGroup** 動作。
**圖 1**：在「佇列執行模式」中設定的工作流程
在以下情況下使用佇列執行模式：
+ **您想要在功能和執行之間保持one-to-one的關係 – 使用取代模式時，這些功能可能會分組**。例如，當您在遞交 1 中合併功能 1 時，執行 1 會啟動，而當您在遞交 2 中合併功能 2 時，執行 2 會啟動，以此類推。如果您要使用取代模式而非佇列模式，您的功能 （和遞交） 將在取代其他功能的執行中分組在一起。
+ **您想要避免使用平行模式時可能發生的競爭條件和非預期問題**。例如，如果兩個軟體開發人員 Wang 和 Saanvi 開始工作流程大約同時執行以部署到 Amazon ECS 叢集，Wang 的執行可能會開始叢集上的整合測試，而 Saanvi 的執行則會將新的應用程式程式碼部署到叢集，導致 Wang 的測試失敗或測試錯誤的程式碼。另一個範例是，您可能有一個沒有鎖定機制的目標，在這種情況下，兩個執行可能會以非預期的方式覆寫彼此的變更。
+ **您想要限制 CodeCatalyst 用來處理執行之運算資源的負載**。 CodeCatalyst 例如，如果您的工作流程中有三個動作，您最多可以同時發生三個執行。對一次可發生的執行次數施加限制，可讓執行輸送量更可預測。
+ **您想要限制工作流程對第三方服務提出的請求數量**。例如，您的工作流程可能有建置動作，其中包含從 Docker Hub 提取映像的指示。[Docker Hub 會將您可以提出的提取請求數量限制](https://www.docker.com/increase-rate-limits)為每個帳戶每小時特定數量，如果您超過限制，將會鎖定您。使用排入佇列的執行模式來減慢您的執行輸送量，將產生每小時對 Docker Hub 的較少請求，從而限制鎖定和導致建置和執行失敗的可能性。
**佇列大小上限**：50
**佇列大小上限**的注意事項：
+ 最大佇列大小是指工作流程中*所有佇列*允許的執行次數上限。
+ 如果佇列的執行時間超過 50 次，則 CodeCatalyst 會捨棄第 51 次和後續的執行。
**失敗行為**：
如果執行在動作處理時變得沒有回應，則其後面的執行會保留在佇列中，直到動作逾時為止。動作在一小時後逾時。
如果 動作內的執行失敗，則允許其後方的第一個佇列執行繼續。
## 關於取代的執行模式
*取代的執行模式*與排入*佇列的執行模式*相同，但：
+ 如果佇列的執行追上佇列中的另一個執行，則稍後的執行會取代 （接管） 較早的執行，而較早的執行會取消並標示為 'upersed'。
+ 做為第一個項目符號中所述行為的結果，佇列只能在使用取代的執行模式時包含一次執行。
使用 中的工作流程[Figure 1](#figure-1-workflow-queued-run-mode)做為指南，將取代的執行模式套用至此工作流程將導致下列情況：
+ **Run-7g777** 會取代佇列中的其他兩個執行，並且會是**佇列 \#1** 中剩餘的唯一執行。**Run-6f666** 和 **Run-5e555** 將會取消。
+ **Run-3c333** 會取代 **Run-2b222**，並且是**佇列 \#2** 中剩餘的唯一執行。**Run-2b222** 將被取消。
如果您想要的話，請使用取代的執行模式：
+ 比使用佇列模式的輸送量更好
+ 與排入佇列模式相比，對第三方服務的請求更少；如果第三方服務具有速率限制，例如 Docker Hub，這就很有幫助
## 關於平行執行模式
在*平行執行模式中*，執行彼此獨立，且不會等待其他執行完成再開始。沒有佇列，且執行輸送量只會受到工作流程內動作完成的速度限制。
在開發環境中使用平行執行模式，其中每個使用者都有自己的功能分支，並部署到其他使用者未共用的目標。
**重要**
如果您有多個使用者可以部署的共用目標，例如生產環境中的 Lambda 函數，請勿使用平行模式，因為可能會導致競爭條件。當平行工作流程執行嘗試同時變更共用資源，導致無法預測的結果時，就會發生*競爭條件*。
**平行執行的最大數量**：每個 CodeCatalyst 空間 1000 個
## 設定執行模式
您可以將執行模式設定為已排入佇列、已取代或平行。預設值已排入佇列。
當您將執行模式從佇列或取代變更為平行時，CodeCatalyst 會取消已佇列的執行，並允許動作目前正在處理的執行完成，然後再取消它們。
當您將執行模式從平行變更為佇列或取代時，CodeCatalyst 會讓目前執行的所有平行執行完成。您在將執行模式變更為已排入佇列或已取代後啟動的任何執行都會使用新的模式。
------
#### [ Visual ]
**使用視覺化編輯器變更執行模式**
1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 選擇您的專案。
1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。
1. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。
1. 選擇**編輯**。
1. 在右上角，選擇**工作流程屬性**。
1. 展開**進階**，然後在**執行模式下**，選擇下列其中一項：
1. **已排入佇列** – 請參閱 [關於排入佇列的執行模式](#workflows-configure-runs-queued)
1. **取代** – 請參閱 [關於取代的執行模式](#workflows-configure-runs-superseded)
1. **平行** – 請參閱 [關於平行執行模式](#workflows-configure-runs-parallel)
1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。
1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。
------
#### [ YAML ]
**使用 YAML 編輯器變更執行模式**
1. 開啟 CodeCatalyst 主控台，網址為 https：//[https://codecatalyst.aws/](https://codecatalyst.aws/)。
1. 選擇您的專案。
1. 在導覽窗格中，選擇 **CI/CD**，然後選擇**工作流程**。
1. 選擇工作流程的名稱。您可以依定義工作流程的來源儲存庫或分支名稱進行篩選，或依工作流程名稱或狀態進行篩選。
1. 選擇**編輯**。
1. 選擇 **YAML**。
1. 新增 `RunMode` 屬性，如下所示：
```
Name: Workflow_6d39
SchemaVersion: "1.0"
RunMode: {{QUEUED|SUPERSEDED|PARALLEL}}
```
如需詳細資訊，請參閱《》中 [最上層屬性](workflow-reference.md#workflow.top.level) 區段的 `RunMode` 屬性描述[工作流程 YAML 定義](workflow-reference.md)。
1. （選用） 選擇**驗證**以在遞交之前驗證工作流程的 YAML 程式碼。
1. 選擇**遞交**，輸入遞交訊息，然後再次選擇**遞交**。
------