更新 Amazon ECS 服務參數

指出服務是否使用可用區域重新平衡。

您可以針對滾動部署變更此參數。

容量提供者策略的詳細資料。您可以在建立叢集、執行任務或更新服務時設定容量提供者。

使用 Fargate 時，容量提供者為 FARGATE 或 FARGATE_SPOT。

使用 Amazon EC2 時，容量提供者為 Auto Scaling 群組。

可以針對滾動部署與藍/綠部署變更容量提供者。

下列清單可提供有效的轉換：

無法變更叢集名稱。

部署組態包括用於偵測失敗的 CloudWatch 警示與斷路器，以及所需的組態。

如果服務無法達到穩定狀態，部署斷路器會確定服務部署是否會失敗。如果使用部署斷路器，服務部署會轉換為失敗狀態並停止啟動新任務。如果使用復原選項，當服務部署失敗後，服務會復原至上一次成功完成的部署。

更新使用 Amazon ECS 斷路器的服務時，Amazon ECS 會建立服務部署與服務修訂版。這些資源可用於檢視服務歷史記錄的詳細資訊。如需更多詳細資訊，請參閱 使用 Amazon ECS 服務部署檢視服務歷史記錄。

服務排程器 (在服務的部署組態中) 使用運作狀態百分比下限和百分比上限參數，決定部署策略。

如果服務使用滾動更新 (ECS) 部署類型，則運作狀態百分比下限代表部署期間，服務中必須保持在 RUNNING 狀態的任務數量下限，以所需任務數量百分比表示 (無條件進位到最接近的整數)。如果服務包含使用 EC2 的任務，即使有任何容器執行個體處於 DRAINING 狀態，此參數也適用。使用此參數進行部署，無須使用額外的叢集容量。例如，如果您的服務所需任務數量為四項，且運作狀態百分比下限為 50%，則排程器可先停止兩項現有的任務以釋出叢集容量，再啟動兩項新的任務。對於未使用負載平衡器的服務，如果任務處於 RUNNING 狀態，則服務會將任務視為運作狀態良好。對於使用負載平衡器的服務，如果任務處於 RUNNING 狀態且負載平衡器也回報為運作狀態良好，則服務會將任務視為運作狀態良好。運作狀態百分比下限的預設值為 100%。

如果服務使用滾動更新 (ECS) 部署類型，則百分比上限參數代表在部署期間，服務中允許處於 PENDING、RUNNING 或 STOPPING 狀態的任務數量上限，以所需任務數量百分比表示 (無條件捨去到最接近的整數)。如果服務包含使用 EC2 的任務，即使有任何容器執行個體處於 DRAINING 狀態，此參數也適用。使用此參數來定義部署批次大小。例如，如果您的服務有所需的四個任務數目及百分比上限值 200%，則排程器可先啟動四項新任務，再停止四項舊任務。前提是有執行此操作所需的叢集資源。百分比上限的預設值為 200%。

當服務排程器於更新期間取代任務時，服務會先從負載平衡器 (如果使用) 移除任務，並等待連線耗盡。然後，對任務中執行的容器發出相當於 docker stop 的命令。這會造成 SIGTERM 信號和 30 秒逾時，並在之後傳送 SIGKILL，強制停止容器。如果容器在接收到 SIGTERM 信號後於 30 秒內從容處理完畢並結束，就不會傳送任何 SIGKILL 信號。服務排程器依據您定義的運作狀態百分比下限和百分比上限設定，啟動和停止任務。

在容器運作狀態檢查或負載平衡器目標群組運作狀態檢查失敗後，服務排程器也會取代判定為狀況不佳的任務。此取代取決於 maximumPercent 和 desiredCount 服務定義參數。如果任務標記為運作狀態不佳，服務排程器會先啟動替代任務。然後會發生下列情況。

如果 maximumPercent 參數限制排程器先啟動替代任務，排程器會隨機停止運作狀態不佳的任務，以釋放容量，然後啟動替代任務。開始和停止程序會繼續進行，直到所有運作狀態不佳的任務都會取代為運作狀態良好的 一旦已取代了所有運作狀態不佳的任務，而且只執行運作狀態良好的任務，如果任務總數超過 desiredCount，則運作良好的任務會隨機停止，直到任務總計數等於 desiredCount 為止。如需有關 maximumPercent 和 desiredCount 的詳細資訊，請參閱服務定義參數。

用於服務的部署控制器。部署控制器有三種類型：

更新服務時，可以更新其使用的部署控制器。下列清單可提供有效的轉換：

更新服務的部署控制器時，請考量下列事項：

使用 CloudFormation 更新服務的部署控制器時，請根據正在執行的遷移類型，考量下列事項。

要在服務中置放並保持執行的任務執行個體數量。

若要暫時停止服務，請將此值設定為 0。然後，當您準備好啟動服務時，請使用原始值更新服務。

可以針對滾動部署與藍/綠部署變更此參數。

決定是否為服務中的任務啟用 Amazon ECS 受管標籤。

只有更新後啟動的任務才會反映更新。若要更新所有任務上的標籤，請使用強制部署選項。

可以針對滾動部署與藍/綠部署變更此參數。

決定是否使用 Amazon ECS Exec。

如果不想覆寫建立服務時設定的值，可以在執行此動作時將此值設定為 null。

您可以針對滾動部署變更此參數。

所謂寬限期是指 Amazon ECS 服務排程器在任務首次啟動後，會在這段期間內 (以秒為單位) 忽略運作狀態不良的 Elastic Load Balancing、VPC Lattice 與容器運作狀態檢查。如果您未指定運作狀態檢查寬限期間值，則會使用預設值 0。如果未使用任何運作狀態檢查，healthCheckGracePeriodSeconds 會處於未使用狀態。

若服務的任務需要一些時間來啟動及回應運作狀態檢查，您可以指定運作狀態檢查的寬限期，最長為 2,147,483,647 秒 (約 69 年)。在此期間，Amazon ECS 服務排程器會忽略運作狀態檢查情形。此寬限期可防止服務排程器將任務標示為狀況不良並在其來得及標示前加以停止。

可以針對滾動部署與藍/綠部署變更此參數。

更新負載平衡器時，必須使用服務連結角色。

Elastic Load Balancing 負載平衡器物件的清單。該清單包含負載平衡器名稱、容器名稱，以及要從負載平衡器存取的容器連接埠。容器名稱是在容器定義中顯示的名稱。

Amazon ECS 不會自動更新與 Elastic Load Balancing 負載平衡器或 Amazon ECS 容器執行個體相關聯的安全群組。

當您新增、更新或移除負載平衡器組態時，Amazon ECS 會使用更新後的 Elastic Load Balancing 組態啟動新任務，然後在新任務執行時停止舊任務。

對於使用滾動更新的服務，可以新增、更新或移除 Elastic Load Balancing 目標群組。您可以從單一目標群組更新為多個目標群組，也可以從多個目標群組更新為單一目標群組。

對於使用藍/綠部署的服務，可以透過 CodeDeploy 使用 CreateDeployment 來更新 Elastic Load Balancing 目標群組。請注意，藍/綠部署不支援多個目標群組。如需詳細資訊，請參閱向服務註冊多個目標群組。

對於使用外部部署控制器的服務，可以使用 CreateTaskSet 來新增、更新或移除負載平衡器。請注意，外部部署不支援多個目標群組。如需詳細資訊，請參閱向服務註冊多個目標群組。

傳遞空白清單以移除負載平衡器。

您可以針對滾動部署變更此參數。

服務網路組態。

您可以針對滾動部署變更此參數。

要更新服務以使用的任務置放限制條件物件陣列。如果未指定任何值，則服務的現有置放限制條件將保持不變。如果指定此值，則會覆寫為服務定義的任何現有置放限制條件。若要移除所有現有的置放限制條件，請指定空陣列。

您最多可以為每項任務指定 10 項限制條件。此限制包含任務定義中的限制條件以及執行時間指定的限制條件。

可以針對滾動部署與藍/綠部署變更此參數。

要更新服務以使用的任務置放策略物件。如果未指定任何值，則服務的現有置放策略將保持不變。如果指定此值，則會覆寫為服務定義的現有置放策略。若要移除現有的置放策略，請指定空白物件。

可以針對滾動部署與藍/綠部署變更此參數。

服務執行所在的 Fargate 平台版本。

使用 Linux 平台版本的服務無法更新為使用 Windows 平台版本，反之亦然。

您可以針對滾動部署變更此參數。

決定是否將標籤從任務定義或服務傳播到任務。如果沒有指定值，則不會傳播標籤。

只有更新後啟動的任務才會反映更新。若要更新所有任務上的標籤，請將 forceNewDeployment 設定為 true，以便 Amazon ECS 使用更新後的標籤啟動新任務。

可以針對滾動部署與藍/綠部署變更此參數。

Amazon ECS Service Connect 的組態。此參數可決定服務如何連線至應用程式中的其他服務。

您可以針對滾動部署變更此參數。

更新服務登錄檔時，必須使用服務連結角色。

要指派給此服務的服務探索登錄檔的詳細資訊。如需詳細資訊，請參閱服務探索。

當您新增、更新或移除服務登錄檔組態時，Amazon ECS 會使用更新後的服務登錄檔組態啟動新任務，然後在新任務執行時停止舊任務。

傳遞空白清單以移除服務登錄檔。

您可以針對滾動部署變更此參數。

用於服務的任務定義與修訂版。

如果變更任務定義中容器使用的連接埠，則可能需要更新容器執行個體的安全群組，才能使用更新後的連接埠。

如果您為服務更新任務定義，則在負載平衡器組態中指定的容器名稱和容器連接埠必須保留在任務定義中。

容器映像提取行為會因運算選項而有所不同。如需詳細資訊，請參閱下列其中一個項目：

您可以針對滾動部署變更此參數。

磁碟區的詳細資訊，即 configuredAtLaunch。將任務定義中的 configuredAtLaunch 設定為 true 時，此服務參數會為服務中的每項任務設定一個 Amazon EBS 磁碟區，以便在部署期間建立與連接。您可以在 ServiceManagedEBSVolumeConfiguration 中設定大小、volumeType、IOPS、輸送量、快照與加密。磁碟區的 name 必須與任務定義中的 name 相符。如果設定為 null，則不會觸發新的部署。否則，如果此組態與現有組態不同，則會觸發新的部署。

您可以針對滾動部署變更此參數。

服務的 VPC Lattice 組態。這會定義服務如何與 VPC Lattice 整合以進行服務間通訊。

您可以針對滾動部署變更此參數。