Amazon ECS 服務定義參數

類型：字串

必要：是

容量提供者的簡短名稱或完整 Amazon Resource Name (ARN)。

類型：整數

有效範圍：介於 0 到 1,000 之間的整數。

必要：否

加權值會指定應使用指定容量提供者其已啟動任務總數的相對百分比。

例如，假設您的策略包含兩個容量提供者，且兩者的加權值都是一。當基本條件符合時，工作會平均分配給兩個容量提供者。以此類推，假設您為 capacityProviderA 指定了加權值 1；並為 capacityProviderB 指定了加權值 4。那麼，每有一個任務使用 capacityProviderA 執行，就會有四個任務是使用 capacityProviderB 執行。

類型：整數

有效範圍：介於 0 到 100,000 之間的整數。

必要：否

基礎值指定至少要在指定容量提供者上執行多少任務數量。容量提供者策略中只有一個容量提供者可以定義基礎。

類型：整數

必要：否

如果服務使用滾動更新 (ECS) 部署類型，則 maximumPercent 參數代表在部署期間，服務中允許處於 RUNNING、STOPPING 或 PENDING 狀態的任務數量上限。以百分比表示 desiredCount 即無條件捨去至最接近的整數。您可以使用此參數來定義部署批次大小。例如，如果您的服務使用 REPLICA服務排程器，且具有四個任務desiredCount的 ，且maximumPercent值為 200%，則排程器會在停止四個較舊任務之前啟動四個新任務。前提是有執行此操作所需的叢集資源。使用 REPLICA 服務排程器的服務，其預設 maximumPercent 值為 200%。

Amazon ECS 排程器會使用此參數來取代運作狀態不佳的任務，方法是先啟動替代任務，然後停止運作狀態不佳的任務，只要有可用於啟動替代任務的叢集資源即可。如需排程器如何取代運作狀態不佳任務的詳細資訊，請參閱 Amazon ECS 服務。

如果您的服務使用 DAEMON 服務排程器類型，maximumPercent 應該維持 100%。這是預設值。

部署期間的任務最大數量等於 desiredCount 乘以 maximumPercent/100，無條件捨去到最接近的整數值。

如果服務使用藍/綠 (CODE_DEPLOY) 或EXTERNAL部署類型，以及使用 EC2 啟動類型的任務，則百分比上限值會設為預設值。值用於定義在容器執行個體處於 RUNNING 狀態時，服務中保持 DRAINING 狀態的任務數量上限。

如果服務使用藍/綠 (CODE_DEPLOY) 或EXTERNAL部署類型，且服務中的任務使用 Fargate 啟動類型，則不會使用百分比上限值。描述您的服務時，仍會傳回 值。

類型：整數

必要：否

如果服務使用滾動更新 (ECS) 部署類型，則 minimumHealthyPercent 表示部署期間必須保持在 RUNNING 狀態的服務任務數量下限。這表示為無條件進位到最接近整數的 desiredCount 的百分比。您可以使用此參數，而無須使用額外的叢集容量進行部署。

例如，如果您的服務有四個任務desiredCount的 ，即 50% minimumHealthyPercent的 和 100% maximumPercent的 ，則服務排程器會停止兩個現有任務，以在啟動兩個新任務之前釋放叢集容量。

如果任何任務運作狀態不佳，且如果 maximumPercent 不允許 Amazon ECS 排程器啟動替代任務，排程器會使用 minimumHealthyPercent做為限制條件one-by-one停止運作狀態不佳的任務，以清除啟動替代任務的容量。如需排程器如何取代運作狀態不佳任務的詳細資訊，請參閱 Amazon ECS 服務。

對於不使用負載平衡器的服務，請考慮下列事項：

對於會使用負載平衡器的服務，請考慮下列事項：

minimumHealthyPercent 的複本服務預設值是 100%。使用 服務排程DAEMON的服務minimumHealthyPercent預設值為 0% AWS CLI、 AWS SDKs 和 APIs，以及 50% AWS Management Console。

部署期間運作良好任務的最低數量等於 desiredCount 乘以 minimumHealthyPercent/100，無條件進位到最接近的整數值。

如果服務使用藍/綠 (CODE_DEPLOY) 或EXTERNAL部署類型，且正在執行使用 EC2 啟動類型的任務，則運作狀態最低百分比值會設定為預設值。值用於定義當容器執行個體處於 RUNNING 狀態時，服務中保持 DRAINING 狀態之任務數量的下限。

若服務使用的是藍/綠 (CODE_DEPLOY) 或 EXTERNAL 部署類型，並且執行使用 Fargate 啟動類型的任務，則不使用運作良好百分比下限值，雖然描述服務時會傳回此值。

類型：字串

有效值：ECS | CODE_DEPLOY | EXTERNAL

必要：是

要使用的部署控制器類型。部署控制器有三種類型：

類型：字串

必要：否

限制類型。使用 distinctInstance 以確保特定群組中的每個任務執行於不同的容器執行個體。使用 memberOf，以將選擇限制於特定群組或有效的待選項目。任務定義並不支援 distinctInstance 值。

類型：字串

必要：否

限制所套用的叢集查詢語言運算式。如果限制條件類型為 distinctInstance，則無法指定運算式。如需詳細資訊，請參閱建立表達式以定義 Amazon ECS 任務的容器執行個體。

類型：字串

有效值：random | spread | binpack

必要：否

置放策略類型。random 置放策略會將任務隨機置放於各個可用的待選項目。spread 置放策略根據 field 參數，以平均分散的方式置放於各個可用的待選項目。binpack 策略會根據以 field 參數指定的結果，將任務置放於資源最少的可用待選項目。例如，如果您在記憶體上進行 binpack，任務會放置在剩餘記憶體最少，但仍足以執行任務的執行個體上。

類型：字串

必要：否

套用置放策略的欄位。若是 spread 置放策略，有效的值為 instanceId (或擁有相同效果的 host)，或任何平台以及套用至 attribute:ecs.availability-zone 等容器執行個體的自訂屬性。若是 binpack 置放策略，有效值為 cpu 與 memory。若是 random 置放策略，此欄位並不使用。

類型：字串

長度限制：長度下限為 1。長度上限為 128。

必要：否

組成標籤的鍵值組的一部分。索引鍵是一般標籤，作用就像更特定標籤值的類別。

類型：字串

長度限制：長度下限為 0。長度上限為 256。

必要：否

組成標籤的鍵值組的選用部分。值就像標籤類別 (索引鍵) 內的描述項。

類型：物件

必要：否

代表任務或服務之子網路和安全群組的物件。

類型：字串

必要：否

與服務相關聯的 Elastic Load Balancing 目標群組的完整 Amazon Resource Name (ARN)。

僅在使用 Application Load Balancer 或Network Load Balancer時，才指定目標群組 ARN。

類型：字串

必要：否

要與服務建立關聯的負載平衡器名稱。

如果您使用 Application Load Balancer 或 Network Load Balancer，請略去負載平衡器名稱參數。

類型：字串

必要：否

要與負載平衡器建立關聯的容器 (這會出現在容器定義中) 名稱。

類型：整數

必要：否

要與負載平衡器建立關聯之容器的連接埠。此連接埠必須對應至服務中任務所使用之任務定義中的 containerPort。針對使用 EC2 啟動類型的任務，容器執行個體必須允許傳入連接埠對應的 hostPort 的流量。

類型：布林值

必要：是

指定是否要搭配此服務使用 Service Connect。

類型：字串

必要：否

用於 Service Connect 之 AWS Cloud Map 命名空間的簡短名稱或完整 Amazon Resource Name (ARN)。命名空間必須位於與 Amazon ECS 服務和叢集相同的 AWS 區域 。命名空間的類型不會影響 Service Connect。如需 的詳細資訊 AWS Cloud Map，請參閱《 AWS Cloud Map 開發人員指南》中的使用 服務。

類型： 物件陣列

必要：否

Service Connect 服務物件的陣列。這些是其他 Amazon ECS 服務用來連線到此服務的名稱和別名 (又稱為端點)。

對於屬於命名空間成員且僅連線至命名空間內其他服務的「用戶端」Amazon ECS 服務來說，此欄位不是必要欄位。以接受傳入請求的前端應用程式為例，這些請求由連接到服務的負載平衡器傳入或透過其他方式傳入。

物件會從任務定義中選取連接埠、指派 AWS Cloud Map 服務的名稱，以及一組別名 （也稱為端點） 和連接埠，供用戶端應用程式參考此服務。

類型：字串

必要：否

服務登錄檔的 Amazon Resource Name (ARN)。目前支援的服務登錄檔為 AWS Cloud Map。如需詳細資訊，請參閱 AWS Cloud Map 開發人員指南中的使用服務。

類型：整數

必要：否

如果您的服務探索服務指定了 SRV 記錄，則使用該連接埠值。如果已使用 awsvpc 網路模式和 SRV 記錄，則此欄位為必要項目。

類型：字串

必要：否

容器名稱值用於您的「服務探索」服務。該值已於任務定義中指定。如果服務任務指定的任務定義是使用 bridge 或 host 網路模式，您必須透過任務定義指定 containerName 與 containerPort 組合。如果服務任務指定的任務定義使用 awsvpc網路模式，並已使用類型 SRV DNS 記錄，您必須指定 containerName 和 containerPort 組合或 port 值，但不得同時指定兩者。

類型：整數

必要：否

用於您的「服務探索」服務的連接埠值。該值已於任務定義中指定。如果服務任務指定的任務定義是使用 bridge 或 host 網路模式，您必須透過任務定義指定 containerName 與 containerPort 組合。如果服務任務指定的任務定義使用 awsvpc 網路模式，並已使用類型 SRV DNS 記錄，您必須指定 containerName 和 containerPort 組合或 port 值，但不得同時指定兩者。

類型：字串

必要：是

建立或更新服務時設定的磁碟區名稱。最多允許 255 個字母 （大寫和小寫）、數字、底線 (_) 和連字號 (-)。此值必須符合任務定義中指定的磁碟區名稱。

類型：物件

必要：否

用於建立 Amazon EBS 磁碟區的磁碟區組態，這些磁碟區連接到服務建立或更新時由服務維護的任務。每個任務連接一個磁碟區。