本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# Amazon ECS 上 AWS Fargate 的任務淘汰和維護
AWS 負責維護 AWS Fargate 的基礎基礎設施。 AWS 決定何時需要將平台版本修訂取代為基礎設施的新修訂。這稱為任務淘汰。在平台版本修訂淘汰時 AWS 傳送任務淘汰通知。我們會定期更新我們支援的平台版本，推出新的修訂版，內含 Fargate 執行時期軟體更新，以及作業系統與容器執行時期等底層相依性更新。推出較新的修訂版後，我們會淘汰較舊的修訂版，確保所有客戶工作負載在 Fargate 平台版本的最新修訂版上執行。當修訂版本淘汰時，在該修訂版本上執行的所有任務都會停止。
Amazon ECS 任務可以分類為服務任務和獨立任務。服務任務部署為服務的組成部分，並由 Amazon ECS 排程控制。如需詳細資訊，請參閱[Amazon ECS 服務](ecs_services.md)。獨立任務是由 Amazon ECS `RunTask` API 啟動的任務，無論是直接或外部排程器啟動，例如排程任務 （由 Amazon EventBridge 啟動） AWS Batch，或 AWS Step Functions。您無需採取任何動作來因應服務任務的任務淘汰，因為 Amazon ECS 排程器會自動取代這些任務。
對於獨立任務，您可能需要執行額外的處理以因應任務淘汰。如需詳細資訊，請參閱[Amazon ECS 是否可以自動處理獨立任務？](#task-retirement-standalone-tasks)。
對於服務任務，您不需要採取任何動作來淘汰任務，除非您想要在 AWS 之前取代這些任務。Amazon ECS 排程器會在停止任務時使用 `maximumPercent` 並啟動新任務，嘗試維持服務的預期執行數量。遵循最佳實務，盡力降低任務淘汰傳送的影響。使用 REPLICA 服務排程器的服務，其預設 `maximumPercent` 值為 200%。因此，當 AWS Fargate 開始淘汰任務時，Amazon ECS 會先排程新任務，然後等待它執行，然後再淘汰舊任務。在將 `maximumPercent` 值設定為 100% 後，Amazon ECS 會先停止任務，再取代任務。
對於獨立任務淘汰， 會在任務淘汰日期或之後 AWS 停止任務。Amazon ECS 不會在任務停止時啟動替代任務。若需讓這些任務持續執行，您必須在通知指定的時間前，停止執行中任務並啟動替代任務。因此，我們建議客戶監控獨立任務的狀態，並視需要實作邏輯以取代已停止的任務。
當任務在任何場景下停止時，您都可以執行 `describe-tasks`。回應中的 `stoppedReason` 是 `ECS is performing maintenance on the underlying infrastructure hosting the task`。
如需將新的平台版本修訂版取代為新的修訂版，即會套用任務維護機制。如果底層 Fargate 主機發生問題，Amazon ECS 會在沒有任務淘汰通知的情況下取代主機。
## 任務淘汰通知概觀
當 將平台版本修訂 AWS 標記為需要淘汰時，我們會識別所有區域中在該平台版本修訂上執行的所有任務。
下圖呈現了 Fargate 平台版本修訂版的生命週期，涵蓋從新修訂版發布到平台修訂版淘汰的全過程。
![\[此圖表顯示 Fargate 任務淘汰生命週期。\]](http://docs.aws.amazon.com/zh_tw/AmazonECS/latest/developerguide/images/fargate-task-retirement.png)
下面提供相關詳細資訊。
+ 新平台版本修訂版發布後，所有新任務都將排程至此修訂版上執行。
+ 已排程和執行中的現有任務，皆會保留在最初於任務期間置放的修訂版上，而不會遷移至新的修訂版。
+ 新任務，例如作為服務或 Fargate 任務淘汰更新的組成部分，皆會置放在啟動時可用的最新平台版本修訂版上。
任務淘汰通知會透過 AWS Health Dashboard 和電子郵件傳送至已註冊的電子郵件地址，並包含下列資訊：
+ 任務淘汰日期 - 任務將在此日期或之後停止。
+ 若為獨立任務，則為任務的 ID。
+ 若為服務任務，則為執行服務所在之叢集的 ID 以及服務的 ID。
+ 您需要採取的後續步驟。
通常，我們會針對每個 AWS 區域中的每項服務與獨立任務傳送一則通知。然而在某些情況下，您可能會針對每種任務類型收到多則事件通知，例如當待淘汰任務數量過多，超出我們通知機制的承載上限時。
您可以透過以下方法確定已排程要淘汰的任務：
+ 的 Health 儀板表
AWS Health 通知可以透過 Amazon EventBridge 傳送至封存儲存，例如 Amazon Simple Storage Service、執行 AWS Lambda 函數等自動動作，或其他通知系統，例如 Amazon Simple Notification Service。如需詳細資訊，請參閱[使用 Amazon EventBridge 監控 AWS Health 事件](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html)。如需將通知傳送至 Amazon Chime、Slack 或 Microsoft Teams 的組態範例，請參閱 GitHub 上的 [AWS Health Aware](https://github.com/aws-samples/aws-health-aware) 儲存庫。
以下是 EventBridge 事件範例。
```
{
"version": "0",
"id": "3c268027-f43c-0171-7425-1d799EXAMPLE",
"detail-type": "AWS Health Event",
"source": "aws.health",
"account": "123456789012",
"time": "2023-08-16T23:18:51Z",
"region": "us-east-1",
"resources": [
"cluster|service",
"cluster|service"
],
"detail": {
"eventArn": "arn:aws:health:us-east-1::event/ECS/AWS_ECS_TASK_PATCHING_RETIREMENT/AWS_ECS_TASK_PATCHING_RETIREMENT_test1",
"service": "ECS",
"eventScopeCode": "ACCOUNT_SPECIFIC",
"communicationId": "7988399e2e6fb0b905ddc88e0e2de1fd17e4c9fa60349577446d95a18EXAMPLE",
"lastUpdatedTime": "Wed, 16 Aug 2023 23:18:52 GMT",
"eventRegion": "us-east-1",
"eventTypeCode": "AWS_ECS_TASK_PATCHING_RETIREMENT",
"eventTypeCategory": "scheduledChange",
"startTime": "Wed, 16 Aug 2023 23:18:51 GMT",
"endTime": "Fri, 18 Aug 2023 23:18:51 GMT",
"eventDescription": [
{
"language": "en_US",
"latestDescription": "\\nA software update has been deployed to Fargate which includes CVE patches or other critical patches. No action is required on your part. All new tasks launched automatically uses the latest software version. For existing tasks, your tasks need to be restarted in order for these updates to apply. Your tasks running as part of the following ECS Services will be automatically updated beginning Wed, 16 Aug 2023 23:18:51 GMT.\\n\\nAfter Wed, 16 Aug 2023 23:18:51 GMT, the ECS scheduler will gradually replace these tasks, respecting the deployment settings for your service. Typically, services should see little to no interruption during the update and no action is required. When AWS stops tasks, AWS uses the minimum healthy percent (1) and launches a new task in an attempt to maintain the desired count for the service. By default, the minimum healthy percent of a service is 100 percent, so a new task is started first before a task is stopped. Service tasks are routinely replaced in the same way when you scale the service or deploy configuration changes or deploy task definition revisions. If you would like to control the timing of this restart you can update the service before Wed, 16 Aug 2023 23:18:51 GMT, by running the update-service command from the ECS command-line interface specifying force-new-deployment for services using Rolling update deployment type. For example:\\n\\n$ aws ecs update-service -service service_name \\\n--cluster cluster_name -force-new-deployment\\n\\nFor services using Blue/Green deployment type with AWS CodeDeploy:\\nPlease refer to create-deployment document (2) and create new deployment using same task definition revision.\\n\\nFor further details on ECS deployment types, please refer to ECS Deployment Developer Guide (1).\\nFor further details on Fargate's update process, please refer to the AWS Fargate User Guide (3).\\nIf you have any questions or concerns, please contact AWS Support (4).\\n\\n(1) https://docs.aws.amazon.com/AmazonECS/latest/developerguide/deployment-types.html\\n(2) https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html\\n(3) https://docs.aws.amazon.com/AmazonECS/latest/userguide/task-maintenance.html\\n(4) https://aws.amazon.com/support\\n\\nA list of your affected resources(s) can be found in the 'Affected resources' tab in the 'Cluster/ Service' format in the AWS Health Dashboard. \\n\\n"
}
],
"affectedEntities": [
{
"entityValue": "arn:aws:ecs:eu-west-1:111222333444:task/examplecluster/00805ce1d81940b5a37398e5a2c23333"
},
{
"entityValue": "arn:aws:ecs:eu-west-1:111222333444:task/examplecluster/00805ce1d81940b5a37398e5a2c25555"
}
}
]
}
}
```
+ Email
系統會將電子郵件傳送至 AWS 帳戶 ID 的註冊電子郵件。
如需有關如何為任務淘汰做準備的資訊，請參閱[準備在 Amazon ECS 上淘汰 AWS Fargate 任務](prepare-task-retirement.md)。
## 我可以選擇退出任務淘汰機制嗎？
否。作為 AWS 共同責任模型的一部分， AWS 負責管理和維護其基礎基礎設施 AWS Fargate。這包括執行定期平台更新，確保安全性與穩定性。這些更新會由 自動套用 AWS ，而且客戶無法選擇退出。與在 EC2 執行個體上執行工作負載 AWS Fargate 相比，這是使用 的主要優點，維護基礎平台的責任由 處理 AWS。此模式可讓您專注於應用程式，而不是基礎結構維護。透過自動套用這些平台更新， AWS 能夠讓 Fargate 環境up-to-date狀態和安全，而無需您作為客戶採取任何動作。這有助於提供可靠且安全的容器化環境，以利在 Fargate 上執行工作負載。
## 我可以透過其他服務取得任務淘汰通知 AWS 嗎？
AWS 會將任務淘汰通知傳送至 ， Health 儀板表 並傳送給 上的主要電子郵件聯絡人 AWS 帳戶。 Health 儀板表 提供多種與其他 AWS 服務的整合，包括 EventBridge。您可以使用 EventBridge 自動化通知的可見性 (例如轉送訊息至 ChatOps 工具)。如需詳細資訊，請參閱 [Solution overview: Capturing task retirement notifications](https://aws.amazon.com/blogs/containers/improving-operational-visibility-with-aws-fargate-task-retirement-notifications/)。
## 我可以在任務排定後變更任務淘汰嗎？
否。排程是根據任務淘汰等待時間，預設值為 7 天。如果需要更多時間，可選擇將等待期間設定為 14 天。如需詳細資訊，請參閱[步驟 2：擷取任務淘汰通知，提醒團隊採取動作](prepare-task-retirement.md#prepare-task-retirement-capture-task-events)。
自 12/18/2025 起，Amazon ECS 可讓您為 Fargate 任務設定 [Amazon EC2 事件時段](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html)。如果您需要精確控制任務淘汰的確切時間，例如，將它們安排在週末以避免上班時間中斷，您可以為您的任務、服務或叢集設定 Amazon EC2 事件時段，請參閱 [步驟 1：設定任務等待時間或使用 Amazon EC2 事件時段](prepare-task-retirement.md#prepare-task-retirement-set-time)。請注意，此組態的變更適用於未來將排程的淘汰。目前已排定的淘汰不會受到影響。此外，當您為 Fargate 任務設定 Amazon EC2 事件時段時，其優先順序會高於您的任務淘汰等待時間組態。如果您有任何其他疑慮，請聯絡 支援。
## Amazon ECS 如何處理屬於服務組成部分的任務？
對於服務任務，您不需要採取任何動作來回應任務淘汰，除非您想要在 AWS 之前取代這些任務。Amazon ECS 排程器會在停止任務時依據運作狀態百分比下限啟動新任務，嘗試維持服務的預期執行數量。為盡力降低 Fargate 任務淘汰產生的影響，工作負載應按照 Amazon ECS 最佳實務進行部署。例如，將無狀態應用程式部署為 Amazon ECS 服務 (例如 Web 或 API 伺服器) 時，客戶應部署多個任務副本，並將 minimumHealthyPercent 設定為 100%。依預設，服務的運作狀態百分比下限為 100%。因此，當 Fargate 開始淘汰任務時，Amazon ECS 會先排程新任務，待其進入執行狀態後，再淘汰舊任務。當您擴展服務規模、部署組態變更或部署任務定義修訂版時，在任務淘汰過程中，系統會以相同的方式定期取代服務任務。若要為任務淘汰程序做準備，請參閱[準備在 Amazon ECS 上淘汰 AWS Fargate 任務](prepare-task-retirement.md)。
## Amazon ECS 是否可以自動處理獨立任務？
否。 AWS 無法為由 `RunTask`、排程任務 （例如透過 EventBridge 排程器） AWS Batch或 啟動的獨立任務建立替代任務 AWS Step Functions。Amazon ECS 僅管理屬於服務組成部分的任務。
## 對任務淘汰期間的服務可用性進行疑難排解
如果 Amazon ECS 在任務淘汰期間無法啟動替代任務，服務可用性可能會受到影響。此情況可能由錯誤的客戶設定引發，例如：
+ IAM 角色遺失或設定不正確
+ 目標子網路中的容量不足
+ 安全群組設定錯誤
+ 任務定義錯誤
當 Amazon ECS 無法啟動替代任務時，淘汰任務將在無替換的情況下停止，導致服務可用容量降低，甚至中斷服務。請監控服務的任務數量與 Amazon CloudWatch 指標，確保在淘汰事件期間，替代任務能順利啟動。
# 準備在 Amazon ECS 上淘汰 AWS Fargate 任務
若要為任務淘汰做準備，請執行下列操作：
1. 設定任務淘汰等待期間或使用 Amazon EC2 事件時段。
1. 擷取任務淘汰通知，以便通知團隊成員。
1. 您可以使用強制部署選項更新服務，以確保所有服務的任務在最新的平台修訂版上執行。此為選擇性步驟。
## 步驟 1：設定任務等待時間或使用 Amazon EC2 事件時段
您有兩個帳戶設定選項來設定 Fargate 開始任務淘汰的時間： `fargateTaskRetirementWaitPeriod`和 `fargateEventWindows`。
**使用 fargateTaskRetirementWaitPeriod 帳戶設定**
您可以設定 Fargate 開始任務淘汰的時間。預設等待期間為 7 天。對於需要立即套用更新的工作負載，請選擇立即設定 (`0`)。如果您需要更多時間，請設定 `7`或`14`日期選項。
我們建議您選擇較短的等待期，以便更快獲得更新的平台版本修訂版。
透過以根使用者或管理使用者的身分執行 `put-account-setting-default` 或 `put-account-setting` 來設定等待期間。對 `name` 使用 `fargateTaskRetirementWaitPeriod` 選項，並將 `value` 選項設定為以下值之一：
+ `0` - AWS 傳送通知，並立即開始淘汰受影響的任務。
+ `7` - AWS 傳送通知，並等待 7 個日曆天，再開始淘汰受影響的任務。這是預設值。
+ `14` - AWS 傳送通知，並等待 14 個日曆日，然後再開始淘汰受影響的任務。
如需詳細資訊，請參閱《Amazon Elastic Container Service API 參考》**中的 [put-account-setting-default](https://docs.aws.amazon.com/cli/latest/reference/ecs/put-account-setting-default.html) 和 [put-account-setting](https://docs.aws.amazon.com/cli/latest/reference/ecs/put-account-setting.html)。
**使用 fargateEventWindows 帳戶設定**
自 12/18/2025 起，Amazon ECS 可讓您為 Fargate 任務設定 [Amazon EC2 事件時段](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html)。如果您需要精確控制任務淘汰的確切時間，例如，將它們安排在週末以避免上班時間中斷，您可以為您的任務、服務或叢集設定 Amazon EC2 事件時段。
當您使用事件時段時，Fargate 會確保您的任務在下一個可用時段內淘汰前至少執行 3 天，除非使用者啟動的動作或重大運作狀態事件停止，例如基礎硬體降級。
將 `fargateEventWindows` 帳戶設定設為 `enabled`。您可以使用下列其中一個 APIs： `put-account-setting-default` 或 `put-account-setting`做為根使用者或管理使用者。
每個 Amazon EC2 事件時段每週必須開放至少 4 小時，而且每個時間範圍必須至少 2 小時。對於大型叢集和服務，我們建議設定事件時段，其持續時間較長 (8 小時或以上） 或更頻繁，至少每 3 天發生一次。您可以進一步檢閱[使用者指南](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/event-windows.html#event-windows-considerations) AWS Fargate 中 Amazon EC2 事件時段的考量，確保您的任務在淘汰前執行至少 3 天，除非使用者啟動的動作或重大運作狀態事件停止，例如基礎硬體降級。
**重要**
最好在事件時段內取代任務。如果您注意到任務在事件時段之外遭到淘汰，請考慮延長持續時間 (8 小時或以上） 或增加頻率 （至少每 3 天一次）。
若要將 Amazon EC2 事件時段套用至 Fargate 任務淘汰：
+ 將 `fargateEventWindows` 帳戶設定設為 `enabled`。您可以使用下列其中一個 APIs： `put-account-setting-default` 或 `put-account-setting`做為根使用者或管理使用者。請注意，這是針對 Fargate 任務使用 Amazon EC2 事件時段功能的一次性啟用。
+ 透過 AWS 主控台或 AWS CLI 建立 Amazon EC2 事件視窗。若要使用 CLI 建立事件時段，請使用 EC2 `create-instance-event-window` API 搭配時間範圍或 Cron 表達式。記下`InstanceEventWindowId`回應中的 。
```
aws ec2 create-instance-event-window \
--time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \
--tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1" \
--name myEventWindowName
```
或者，您可以在建立 EC2 事件時段時使用 cron 表達式。
```
aws ec2 create-instance-event-window \
--cron-expression "* 21-23 * * 2,3" \
--tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1" \
--name myEventWindowName
```
+ 然後，您可以使用 EC2 `associate-instance-event-window` API 將事件視窗與帳戶中的特定服務、叢集或所有任務建立關聯。
+ 對於 ECS 服務任務
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceTags=[{Key=aws:ecs:serviceArn,Value=your-service-arn}]"
```
+ 對於 ECS 叢集
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceTags=[{Key=aws:ecs:clusterArn,Value=your-cluster-arn}]"
```
+ 將事件時段與帳戶中的所有任務建立關聯
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceTags=[{Key=aws:ecs:fargateTask,Value=true}]"
```
您可以使用多個鍵值對，將事件時段與多個服務或叢集建立關聯。
Fargate 會依下列順序為每個任務選擇事件時段：
+ 如果有與任務服務相關聯的事件時段，則會使用該時段。這不適用於獨立或未受管任務。
+ 如果有與任務叢集相關聯的事件時段，則會使用該時段。
+ 如果為所有 Fargate 任務設定了事件時段，則會使用該時段。
+ 如果沒有事件時段與任務相符，則會使用 `fargateTaskRetirementWaitPeriod`設定。
**設定 Fargate 任務維護的事件時段**
當您在具有不同可用性需求的 Fargate 上執行多個 ECS 服務時，請考慮一個案例。您想要精確控制任務淘汰。您可以設定多個事件時段，如下所示：
+ **所有 Fargate 任務的預設維護**：在離峰時間 （每天 12AM 到 4AM) 建立例行維護的事件時段，並使用 ` aws:ecs:fargateTask`標籤將其與所有 Fargate 任務建立關聯。
+ **開發叢集的週末限定維護**：對於具有可容忍週末中斷服務的開發叢集，請建立 24 小時週末時段 （週六和週日，全天），並使用 `aws:ecs:clusterArn`標籤與叢集 ARN 將其與叢集建立關聯。
+ **關鍵任務服務的限制時段**：對於在工作日需要高正常執行時間的任務關鍵付款處理服務，請將維護限制為週末凌晨時間 （週六和週日，12AM 點至上午 4AM)，並將其與您的服務 ARN 使用 `aws:ecs:serviceArn` 標籤與特定服務建立關聯。
透過此組態，付款服務會使用其特定的僅限週末時段，開發叢集服務和任務會使用週末 24 小時時段，而所有其他 Fargate 任務會使用預設的每日維護時段。
如需詳細資訊，請參閱《Amazon Elastic Container Service API 參考》**中的 [put-account-setting-default](https://docs.aws.amazon.com/cli/latest/reference/ecs/put-account-setting-default.html) 和 [put-account-setting](https://docs.aws.amazon.com/cli/latest/reference/ecs/put-account-setting.html)。
## 步驟 2：擷取任務淘汰通知，提醒團隊採取動作
當即將淘汰任務時， AWS 會將任務淘汰通知傳送到 AWS Health 儀表板，並傳送給 上的主要電子郵件聯絡人 AWS 帳戶。 AWS Health 儀表板提供多種與其他 AWS 服務的整合，包括 Amazon EventBridge。您可以使用 EventBridge 從任務淘汰通知建立自動化，例如透過將訊息轉送到 ChatOps 工具來提高即將淘汰的可見性。 AWS Health Aware 是一種資源，可顯示 AWS Health 儀表板的強大功能，以及如何將通知分佈到整個組織中。您可以將任務淘汰通知轉送至 Slack 等聊天應用程式。
下圖說明了解決方案概觀。
![\[此圖表顯示用於擷取 Fargate 任務淘汰通知的 Fargate 解決方案。\]](http://docs.aws.amazon.com/zh_tw/AmazonECS/latest/developerguide/images/fargate-task-retirement-solution.png)
下面提供相關詳細資訊。
+ Fargate 會將任務淘汰通知傳送至 AWS Health 儀表板。
+ AWS Health 儀表板會將郵件傳送至 上的主要電子郵件聯絡人 AWS 帳戶，並通知 EventBridge。
+ EventBridge 具備可擷取淘汰通知的規則。
此規則用於篩選「事件詳細類型」如下的事件：`"AWS Health Event" and the Event Detail Type Code: "AWS_ECS_TASK_PATCHING_RETIREMENT"`
+ 此規則會觸發 Lambda 函式，該函式會透過 Slack 傳入 Webhook 將資訊轉送至 Slack。如需詳細資訊，請參閱 [Incoming Webhooks](https://slack.com/marketplace/A0F7XDUAZ-incoming-webhooks)。
如需程式碼範例，請參閱在 Github [上擷取 AWS Fargate 任務淘汰通知](https://github.com/aws-samples/capturing-aws-fargate-task-retirement-notifications/tree/main)。
## 步驟 3：控制任務替代時機
您無法控制任務淘汰的確切時間，但可以定義等待時間。若需按照自訂排程控制取代任務，您可以擷取任務淘汰通知，先了解任務淘汰日期。然後，您可以重新部署服務來啟動替代任務，並同步取代所有獨立任務。對於使用滾動部署的服務，您可以在淘汰開始時間前，搭配 `force-deployment` 選項使用 `update-service` 來更新服務。
下列 `update-service` 範例使用 `force-deployment` 選項。
```
aws ecs update-service —-service service_name \
--cluster cluster_name \
--force-new-deployment
```
對於使用藍/綠部署的服務，您需要在 AWS CodeDeploy中建立新的部署。如需有關如何建立部署的資訊，請參閱 *AWS Command Line Interface Reference* 中的 [create-deployment](https://docs.aws.amazon.com/cli/latest/reference/deploy/create-deployment.html)。