Amazon ECS 受管執行個體的 Amazon ECS 任務定義參數

類型：字串

必要：是

當您註冊任務定義時，您會指定它的系列，這類似於任務定義以修訂版號碼指定的多個版本名稱。在特定系列註冊的第一個任務定義會得到修訂版 1，之後註冊的任何任務定義，則得到連續的修訂版號碼。

類型：字串陣列

必要：否

有效值:MANAGED_INSTANCES

驗證任務定義所依據的容量。這會啟動檢查，確保任務定義中使用的所有參數都能滿足 Amazon ECS 受管執行個體的需求。

類型：字串

必要：否

當您註冊任務定義時，您可以為 IAM 角色提供任務角色，該角色可讓任務許可中的容器，代您呼叫其關聯政策中指定的 AWS API。如需詳細資訊，請參閱Amazon ECS 任務 IAM 角色。

類型：字串

必要：有條件

任務執行角色的 Amazon Resource Name (ARN)，授予 Amazon ECS 容器代理程式代表您進行 AWS API 呼叫的許可。如需詳細資訊，請參閱Amazon ECS 任務執行 IAM 角色。

類型：字串

必要：否

預設：awsvpc

用於任務中容器的聯網模式。對於在 Amazon ECS 受管執行個體上託管的 Amazon ECS 任務，有效值為 awsvpc 與 host。如果未指定網路模式，預設網路模式為 awsvpc。

如果網路模式為 host，任務會略過網路隔離，而容器會直接使用主機的網路堆疊。

如果網路模式是 awsvpc，則任務會配置一個彈性網路介面，而當您使用此任務定義建立服務或執行任務時，您必須指定 NetworkConfiguration。如需詳細資訊，請參閱Amazon ECS 受管執行個體的 Amazon ECS 任務聯網。

host 和 awsvpc 網路模式為容器提供最高聯網效能，因為它們使用的是 Amazon EC2 網路堆疊。使用 host 和 awsvpc 網路模式，公開的容器連接埠會直接映射到對應的主機連接埠 (適用於 host 網路模式) 或已連接的彈性網路介面連接埠 (適用於 awsvpc 網路模式)。因此，您無法使用動態主機連接埠對應。

類型：字串

必要：否

預設：LINUX

在註冊任務定義時，您會指定作業系統系列。

此欄位的有效值為 LINUX。

服務中使用的所有任務定義都必須與此參數具有相同的值。

如果任務定義為服務的一部分，此值必須與服務 platformFamily 值相符。

類型：字串

必要：有條件

在註冊任務定義時，您會指定 CPU 架構。有效值為 X86_64 和 ARM64。

如果您未指定值，Amazon ECS 會根據容量提供者組態嘗試將任務放置在可用的 CPU 架構上。為了確保任務放置在特定的 CPU 架構上，請在任務定義cpuArchitecture中指定 的值。

服務中使用的所有任務定義都必須與此參數具有相同的值。

如需 ARM64 的相關資訊，請參閱 64 位元 ARM 工作負載的 Amazon ECS 任務定義。

類型：字串

必要：有條件

針對任務呈現的 CPU 單位硬性限制。您可以在 JSON 檔案中將 CPU 值指定為以 CPU 為單位或虛擬 CPU (vCPU) 為單位的字串。例如，可指定 1024 個 CPU 單位作為 CPU 值，也可指定 1 vCPU 個 vCPU 作為 CPU 值。註冊任務定義時，vCPU 值會轉換為整數，指出 CPU 單位。

此欄位為選用欄位。如果您的叢集沒有任何已註冊的容器執行個體具有可用的請求 CPU 單位，則任務會失敗。支援的值介於 0.125 個 vCPU 與 10 個 vCPU 之間。

類型：字串

必要：有條件

要分配給任務的記憶體硬性限制。您可以在任務定義中將記憶體值指定為以 MiB 或 GB 為單位的字串。例如，可指定 3072 MiB 作為記憶體值，也可指定 3 GB GB 作為記憶體值。註冊任務定義時，GB 值會轉換為整數，指出 MiB。

此欄位為選填，且可以使用任何值。如果指定任務層級的記憶體值，則容器層級的記憶體值是選用的。如果您的叢集沒有任何一個已註冊的容器執行個體具有可用的請求記憶體，則任務會失敗。您可以盡可能為特定執行個體類型的任務提供最多的記憶體，以將資源使用率最大化。如需詳細資訊，請參閱保留 Amazon ECS Linux 容器執行個體記憶體。

類型：EphemeralStorage 物件

必要：否

為任務配置的暫時性儲存量 (以 GB 為單位)。對於託管於 AWS Fargate的任務，此參數可用來擴充可用的暫時性儲存總量 (超過預設數量)。如需詳細資訊，請參閱搭配 Amazon ECS 使用綁定掛載。

類型：字串

必要：否

要用於任務中容器的 IPC 資源命名空間。有效值為 host、task 或 none。如果已指定 host，則任務內對相同容器執行個體指定 host IPC 模式的所有容器，會與主機 Amazon EC2 執行個體共用相同的 IPC 資源。如果已指定 task，則指定任務內的所有容器會共用相同的 IPC 資源。如果已指定 none，則任務內的容器內的 IPC 資源為私有，並且不會與任務中或容器執行個體上的其他容器共用。如果未指定任何值，則 IPC 資源命名空間共用取決於容器執行期組態。

類型：字串

必要：否

要用於任務中容器的程序命名空間。有效值為 host 或 task。如果已指定 host，則任務內對同一容器執行個體指定 host PID 模式的所有容器，會與主機 Amazon EC2 執行個體共用相同的程序命名空間。如果已指定 task，則指定任務內的所有容器會共用相同的程序命名空間。如果未指定任何值，預設值會是私有命名空間。

如果是使用 host PID 模式，這會提高將不需要的程序命名空間公開的風險。

類型：ProxyConfiguration 物件

必要：否

App Mesh 代理的組態詳細資訊。

類型：字串

必要：否

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

類型：字串

必要：否

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

類型：InferenceAccelerator 物件

必要：否

要用於任務中容器的 Elastic Inference 加速器。

類型：TaskDefinitionPlacementConstraint 物件陣列

必要：否

要針對任務使用的置放限制條件物件陣列。每項任務您最多可以指定 10 項限制條件 (此限制包含任務定義中的限制條件以及執行時間指定的限制條件)。

Amazon ECS 支援在 Amazon ECS 受管執行個體上執行之任務的 distinctInstace 與 memberOf 置放限制條件。使用 memberOf 置放限制條件的任務支援下列屬性：

如需有關置放限制條件的詳細資訊，請參閱定義 Amazon ECS 用於任務的容器執行個體。

類型：字串

必要：是

磁碟區名稱。可以包含最多 255 個字母 (大小寫)、數字和連字號。此名稱是參考容器定義 sourceVolume 中的 mountPoints 參數。

類型：HostVolumeProperties 物件

必要：否

此參數會在您使用綁定掛載主機磁碟區時指定。host 參數的內容決定繫結掛載主機磁碟區是否保留在主機容器執行個體上以及其存放位置。如果 host 參數是空的，則系統會為您的資料磁碟區指派主機路徑。不過，在與其相關聯的容器停止執行後，不保證保留資料。

類型：DockerVolumeConfiguration 物件

必要：否

此參數會在您使用 Docker 磁碟區時指定。

類型：EFSVolumeConfiguration 物件

必要：否

此參數會在您使用適用於任務儲存體的 Amazon EFS 檔案系統時指定。

類型：FSxWindowsFileServerVolumeConfiguration 物件

必要：否

此參數會在您為任務儲存使用 Amazon FSx for Windows File Server 檔案系統時指定。

類型：布林值

必要：否

指示是否應在啟動時設定磁碟區。此參數用於為獨立任務或作為服務一部分建立的任務建立 Amazon EBS 磁碟區。每個任務定義修訂版只能在磁碟區組態中於啟動時設定一個磁碟區。

類型：字串

必要：是

容器的名稱。最多允許 255 個字母 （大寫和小寫）、數字、連字號和底線。如果您在任務定義中連結多個容器，則一個容器的 name 可以輸入另一個容器的 links。這是為了連結容器。

類型：字串

必要：是

用來啟動容器的映像。此字串會直接傳遞至 Docker 常駐程式。根據預設，Docker Hub 登錄檔中的映像為可用。您也可以使用 repository-url/image:tag 或 repository-url/image@digest 指定其他存放庫。允許最多 255 個字元 (大小寫)、數字、連字號、底線、等號、句號、正斜線、井號。此參數會映射至 docker create-container 命令中的 Image，以及 docker run 命令的 IMAGE 參數。

類型：字串

有效值：enabled|disabled

必要：否

指定 Amazon ECS 是否會將容器定義中提供的容器映像標籤解析為映像摘要。此行為預設為 enabled。如果將容器的值設定為 disabled，Amazon ECS 不會將容器映像標籤解析為摘要，但會使用容器定義中指定的原始映像 URI 進行部署。如需有關容器映像解析的詳細資訊，請參閱容器映像解析度。

類型：整數

必要：否

提供給容器使用的記憶體數量 (MiB)。如果您的容器嘗試使用超過此處指定的記憶體，容器便會終止。為任務中所有容器預留的記憶體總量必須低於任務 memory 值 (如果已指定一個)。此參數會映射至 docker create-container 命令中的 Memory，以及 docker run 的 --memory 選項。

Docker 20.10.0 或更新版本的常駐程式會為容器保留最低 6 MiB 的記憶體。因此，不要為容器指定少於 6 MiB 的記憶體。

Docker 19.03.13-ce 或更舊版本的常駐程式會為容器保留最低 4 MiB 的記憶體。因此，不要為容器指定少於 4 MiB 的記憶體。

類型：整數

必要：否

為容器保留的記憶體軟性限制 (MiB)。當系統記憶體爭用時，Docker 會嘗試將容器記憶體保持在此軟性限制。但是，您的容器可以在需要時使用更多記憶體。容器可以使用最多達到以 memory 參數指定的硬性限制 (如適用)，或容器執行個體上的所有可用記憶體，以先達到者為準。此參數會映射至 docker create-container 命令中的 MemoryReservation，以及 docker run 的 --memory-reservation 選項。

如果未指定任務層級的記憶體值，您必須為容器定義中的 memory 或 memoryReservation 之一或兩者指定非零整數。若您同時指定兩者，memory 必須大於 memoryReservation。如果指定 memoryReservation，則會從放置容器的容器執行個體可用記憶體資源中減去該值。否則，即使用 memory 的值。

例如，若您的容器通常會使用 128 MiB 的記憶體，但會偶爾短期爆量到 256 MiB 的記憶體。您可以將 memoryReservation 設為 128 MiB，並將 memory 硬性限制設為 300 MiB。此組態讓容器只從容器執行個體的剩餘資源中保留 128 MiB 的記憶體。同時，其還允許容器在需要時使用更多的記憶體資源。

Docker 20.10.0 或更新版本的常駐程式會為容器保留最低 6 MiB 的記憶體。因此，不要為容器指定少於 6 MiB 的記憶體。

Docker 19.03.13-ce 或更舊版本的常駐程式會為容器保留最低 4 MiB 的記憶體。因此，不要為容器指定少於 4 MiB 的記憶體。

類型：整數

必要：否

為容器預留的 cpu 單位數。此參數會映射至 docker create-container 命令中的 CpuShares，以及 docker run 的 --cpu-shares 選項。

對於使用 EC2 容量提供者的任務，此欄位為可選項，唯一要求是任務內為所有容器預留的 CPU 總量必須低於任務層級的 cpu 值。

Linux 容器會按照與其配置數量相同的比例，與容器執行個體上的其他容器共用未配置的 CPU 單位。例如，若您在單一核心執行個體類型上執行單一容器任務，為該容器指定 512 個 CPU 單位，並且該任務是容器執行個體上唯一執行中的任務，該容器便可在任何指定時間內使用完整的 1,024 個 CPU 單位。但是，若您在該容器執行個體上啟動相同任務的另一個複本，可保證每個任務都可以在需要時取得至少 512 個 CPU 單位。此外，每個容器都可在其他容器沒有使用時浮動到更高的 CPU 用量。若兩個任務都一直維持在 100% 作用中的狀態，兩者能夠取得的單位數便會限制在 512 個 CPU 單位。

在 Linux 容器執行個體上，容器執行個體的 Docker 常駐程式會使用 CPU 值計算執行中容器的相對 CPU 共用比例。如需詳細資訊，請參閱 Docker 文件中的 CPU share constraint。Linux 核心允許的最低有效 CPU 共用值為 2。但是，CPU 參數並非必要項目，且您可以在容器定義中使用低於 2 的 CPU 值。針對低於 2 的 CPU 值 (包含 null)，行為會隨您的 Amazon ECS 容器代理版本而異：

在 Windows 容器執行個體上，CPU 限制會強制為絕對限制或配額。Windows 容器只能存取任務定義的描述中所指定之 CPU 數量。將空或零的 CPU 值以 0 的形式傳遞給 Docker，Windows 會將此值解釋為一個 CPU 的 1%。

類型：物件陣列

必要：否

連接埠映射會將容器的網路連接埠對外公開，讓用戶端可以存取您的應用程式。這也適用於同一任務中的容器間通訊。

針對使用 awsvpc 網路模式的任務定義，只指定 containerPort。一律略過 hostPort，且容器連接埠會自動映射至主機上的隨機高連接埠號碼。

此參數的大部分欄位 (包括 containerPort、hostPort、protocol) 會映射至 docker create-container 命令中的 PortBindings，以及 docker run 的 --publish 選項。若任務定義的網路模式設定為 host，則主機連接埠必須為未定義，或符合連接埠映射中的容器連接埠。

若您指定主機連接埠，請使用以下語法。

"portMappings": [
    {
        "containerPort": integer,
        "hostPort": integer
    }
    ...
]

若您希望取得自動指派的主機連接埠，請使用以下語法。

"portMappings": [
    {
        "containerPort": integer
    }
    ...
]

類型：RepositoryCredentials 物件

必要：否

私有登錄檔身分驗證的儲存庫憑證。

如需詳細資訊，請參閱在 Amazon ECS 中使用非AWS 容器映像。

類型：布林值

必要：否

若容器的 essential 參數標記為 true，並且該容器因為任何理由失敗或停止，則所有為任務之一部分的其他容器都會停止。若容器的 essential 參數標記為 false，則其失敗將不會影響任務中其餘的容器。若省略此參數，則容器會假設為「基本」。

所有任務都必須至少有一個基本容器。若您的應用程式由多個容器組成，將一般用途用的容器分組成元件，並將不同的元件分成多個任務定義。如需詳細資訊，請參閱為 Amazon ECS 建構您的應用程式。

類型：字串陣列

必要：否

傳遞至容器的進入點。此參數會映射至 docker create-container 命令中的 Entrypoint，以及 docker run 的 --entrypoint 選項。

"entryPoint": ["string", ...]

類型：字串陣列

必要：否

傳遞至容器的命令。此參數會映射至 docker create-container 命令中的 Cmd，以及 docker run 的 COMMAND 參數。如果有多個引數，每個引數在陣列中都是分開的字串。

"command": ["string", ...]

類型：字串

必要：否

容器內要執行命令的工作目錄。此參數會映射至 docker create-container 命令中的 WorkingDir，以及 docker run 的 --workdir 選項。

容器重新啟動政策及相關組態參數。在為容器設定重新啟動政策後，Amazon ECS 可以重新啟動容器，無需取代任務。如需詳細資訊，請參閱使用容器重新啟動政策在 Amazon ECS 任務中重新啟動個別容器。

用於容器的容器運作狀態檢查命令和相關的設定參數。如需詳細資訊，請參閱使用容器運作狀態檢查判斷 Amazon ECS 任務運作狀態。

類型：整數

必要：否

Amazon ECS 容器代理程式保留給容器的 cpu 數量。在 Linux 上，此參數會映射至 Create a container 區段中的 CpuShares。

對於在 Amazon ECS 受管執行個體上執行的任務，此欄位為選用項目。為任務中所有容器預訂的 CPU 總量必須低於任務階層的 cpu 值。

Linux 容器會按照與其配置數量相同的比例，與容器執行個體上的其他容器共用未配置的 CPU 單位。例如，若您在單一核心執行個體類型上執行單一容器任務，為該容器指定 512 個 CPU 單位。此外，該任務是在容器執行個體上運行的唯一任務。在此範例中，該容器便可在任何指定的時間內使用完整 1,024 個 CPU 單位。但是，假設您在該容器執行個體上啟動相同任務的另一個複本。每個任務都可以保證在需要的時候取得最少 512 個 CPU 單位。同樣，如果其他容器沒有使用剩餘的 CPU，每個容器都可以浮動到更高的 CPU 用量。但若兩個任務都一直維持在 100% 作用中的狀態，兩者能夠取得的單位數便會限制在 512 個 CPU 單位。

在 Linux 容器執行個體上，容器執行個體的 Docker 常駐程式會使用 CPU 值計算執行中容器的相對 CPU 共用比例。Linux 核心允許的有效 CPU 共用值，最小為 2，最大為 262144。但是，CPU 參數並非必要項目，且您可以在容器定義中使用小於 2 且大於 262144 的 CPU 值。針對小於 2 且大於 262144 的 CPU 值 (包含 null)，行為會隨您的 Amazon ECS 容器代理程式版本而異：

如需其他範例，請參閱 Amazon ECS 如何管理 CPU 和記憶體資源。

類型：ResourceRequirement 物件

必要：否

Amazon ECS 容器代理程式保留給容器的實體 GPUs 數量。為任務中所有容器保留的 GPU 數量不得超過任務啟動所在之容器執行個體上可用的 GPU 數量。如需詳細資訊，請參閱GPU 工作負載的 Amazon ECS 任務定義。

類型：ResourceRequirement 物件

必要：否

對於 InferenceAccelerator 類型，value 符合任務定義中指定之 InferenceAccelerator 的 deviceName。如需詳細資訊，請參閱Elastic Inference 加速器名稱 （已棄用）。

類型：布林值

必要：否

假設容器的 essential 參數標記為 true，並且該容器因為任何理由失敗或停止。然後，會停止屬於該任務一部分的所有其他容器。若容器的 essential 參數標記為 false，則其失敗將不會影響任務中其餘的容器。若省略此參數，則容器會假設為「基本」。

所有任務都必須至少有一個基本容器。假設您有一個由多個容器組成的應用程式。然後，將用於一般用途的容器分組為元件，並把不同的元件分到多個任務定義。如需詳細資訊，請參閱為 Amazon ECS 建構您的應用程式。

"essential": true|false

類型：字串陣列

必要：否

傳遞至容器的進入點。

"entryPoint": ["string", ...]

類型：字串陣列

必要：否

傳遞至容器的命令。此參數會映射至 create-container 命令中的 Cmd，以及 docker run 的 COMMAND 參數。如果有多個引數，確保每個引數在陣列中是分開的字串。

"command": ["string", ...]

類型：字串

必要：否

容器內要執行命令的工作目錄。此參數會映射到 Docker Remote API 的建立容器區段中的 WorkingDir 以及 docker run 的 --workdir 選項。

"workingDirectory": "string"

類型：物件陣列

必要：否

內含要傳遞至容器之環境變數的檔案清單。此參數會映射至 docker run 命令的 --env-file 選項。

您最多可以指定 10 個環境檔案。檔案副檔名必須是 .env。環境檔案中的每一行都包含 VARIABLE=VALUE 格式的環境變數。以 # 開頭的行會被視為註解，而忽略。

如果在容器定義中指定了個別環境變數，它們的優先順序高於環境檔案中包含的變數。如果指定了內含相同變數的多個環境檔案，則處理順序為由上而下。建議您使用唯一的變數名稱。如需詳細資訊，請參閱將個別環境變數傳遞至 Amazon ECS 容器。

類型：物件陣列

必要：否

傳遞至容器的環境變數。此參數會映射至 docker create-container 命令中的 Env 參數，以及 docker run 命令的 --env 選項。

"environment" : [
    { "name" : "string", "value" : "string" },
    { "name" : "string", "value" : "string" }
]

類型：物件陣列

必要：否

代表公開到容器之秘密的物件。如需詳細資訊，請參閱將敏感資料傳遞至 Amazon ECS 容器。

"secrets": [
    {
        "name": "environment_variable_name",
        "valueFrom": "arn:aws:ssm:region:aws_account_id:parameter/parameter_name"
    }
]

類型：布林值

必要：否

此參數為 true 時，容器便會取得主機容器執行個體的更高許可 (類似 root 使用者)。此參數會映射至 docker create-container 命令中的 Privileged，以及 docker run 的 --privileged 選項。

類型：字串

必要：否

要在容器內使用的使用者。此參數會映射至 docker create-container 命令中的 User，以及 docker run 的 --user 選項。

您可以使用下列格式指定 user。如果指定 UID 或 GID，您必須使用正整數指定它。

類型：布林值

必要：否

此參數為 true 時，容器會取得根檔案系統的唯讀存取權。此參數會映射至 docker create-container 命令中的 ReadonlyRootfs，以及 docker run 的 --read-only 選項。

類型：字串陣列

必要：否

提供 SELinux 和 AppArmor 多層級安全系統自訂標籤的字串清單。此欄位對使用 Fargate 的任務中的容器無效。

類型：Ulimit 物件陣列

必要：否

容器中要設定的 ulimits 清單。如果在任務定義中指定 ulimit 值，該值會覆寫 Docker 設定的預設值。此參數會映射至 docker create-container 命令中的 Ulimits，以及 docker run 的 --ulimit 選項。有效命名值會顯示在 Ulimit 資料類型中。

在 Fargate 上託管的 Amazon ECS 任務會使用作業系統設定的預設資源限制值，但是 Fargate 會覆寫的 nofile 資源限制參數除外。nofile 資源限制會對容器可使用的開放檔案數量設限。預設的 nofile 軟性限制為 1024，預設的硬性限制為 65535。

此參數需要容器執行個體上的 Docker Remote API 1.18 版或更新版本。若要檢查容器執行個體的 Docker Remote API 版本，請登入容器執行個體，並執行下列命令：sudo docker version --format '{{.Server.APIVersion}}'

類型：字串到字串映射

必要：否

要新增到容器的標籤索引鍵/值映射。此參數會映射至 docker create-container 命令中的 Labels，以及 docker run 的 --label 選項。

此參數需要容器執行個體上的 Docker Remote API 1.18 版或更新版本。

"dockerLabels": {"string": "string"
      ...}

類型：布林值

必要：否

當此參數為 true 時，聯網便會在容器中關閉。

預設值為 false。

"disableNetworking": true|false

類型：字串陣列

必要：否

link 參數可讓容器彼此通訊，而無需連接埠映射。只有在任務定義的網路模式設定為 bridge 時才支援此參數。name:internalName 建構模組與 Docker 連結中的 name:alias 類似。最多可輸入 255 個字母 (大小寫)、數字、連字號與底線。

"links": ["name:internalName", ...]

類型：字串

必要：否

您容器要使用的主機名稱。此參數會映射至 docker create-container 中的 Hostname，以及 docker run 的 --hostname 選項。

"hostname": "string"

類型：字串陣列

必要：否

提供給容器的 DNS 伺服器清單。

"dnsServers": ["string", ...]

類型：物件陣列

必要：否

要附加到容器上 /etc/hosts 檔案的主機名稱和 IP 地址映射清單。

此參數會映射至 docker create-container 命令中的 ExtraHosts，以及 docker run 的 --add-host 選項。

"extraHosts": [
      {
        "hostname": "string",
        "ipAddress": "string"
      }
      ...
    ]

類型：布林值

必要：否

此參數為 true 時，容器會取得根檔案系統的唯讀存取權。此參數會映射至 docker create-container 命令中的 ReadonlyRootfs，以及 docker run 的 --read-only 選項。

預設值為 false。

"readonlyRootFilesystem": true|false

類型：物件陣列

必要：否

容器中資料磁碟區的掛載點。此參數會映射至 Docker API 中 create-container 的 Volumes，以及 docker run 的 --volume 選項。

Windows 容器可在 $env:ProgramData 所在的相同磁碟上掛載整個目錄。Windows 容器無法在不同的磁碟機上掛載目錄，且掛載點不能跨磁碟機使用。您必須指定掛載點，將 Amazon EBS 磁碟區直接連接至 Amazon ECS 任務。

類型：物件陣列

必要：否

要從其他容器掛載的資料磁碟區。此參數會映射至 docker create-container 命令中的 VolumesFrom，以及 docker run 的 --volumes-from 選項。

"volumesFrom": [
                {
                  "sourceContainer": "string",
                  "readOnly": true|false
                }
              ]

類型：LogConfiguration 物件

必要：否

容器的日誌組態規格。

例如，使用日誌組態的任務定義，請參閱Amazon ECS 任務定義範例。

此參數會映射至 docker create-container 命令中的 LogConfig，以及 docker run 的 --log-driver 選項。根據預設，容器會和 Docker 常駐程式使用一樣的日誌記錄驅動程式。不過，容器可以在容器定義中使用此參數指定日誌驅動程式，和 Docker 常駐程式使用不同的日誌驅動程式。若要讓容器使用不同的日誌驅動程式，必須在容器執行個體上適當設定日誌系統 (或在不同的日誌伺服器上使用遠端記錄選項)。

指定容器的日誌組態時，請考量下列事項：

"logConfiguration": {
      "logDriver": "awslogs",""splunk", "awsfirelens",
      "options": {"string": "string"
        ...},
	"secretOptions": [{
		"name": "string",
		"valueFrom": "string"
	}]
}

類型：FirelensConfiguration 物件

必要：否

容器的 FireLens 組態。這是用來指定及設定容器日誌的日誌路由器。如需詳細資訊，請參閱將 Amazon ECS 日誌傳送至 AWS 服務或 AWS Partner。

{
    "firelensConfiguration": {
        "type": "fluentd",
        "options": {
            "KeyName": ""
        }
    }
}

類型：ResourceRequirement 物件陣列

必要：否

指派給容器的資源類型和數量。目前僅支援資源 GPU。

類型：整數

必要：否

範例值：120

解析容器的相依性時在放棄之前等待的持續時間 (以秒為單位)。

例如，您在任務定義中指定兩個容器，其中的 containerA 對達到 COMPLETE、SUCCESS 或 HEALTHY 狀態的 containerB 有相依性。如果為 containerB 指定 startTimeout 值，但在該時間內沒有達到所需狀態，則 containerA 不會啟動。

最大值為 600 秒 (10 分鐘）。

類型：整數

必要：否

範例值：120

當容器本身未正常結束時，強制終止容器之前的等待期間 (以秒為單位)。

如果未指定參數，則會使用預設值 30 秒。最大值為 86400 秒 (24 小時）。

類型：ContainerDependency 物件陣列

必要：否

針對容器啟動和關閉而定義的相依性。容器可以包含多個相依性。針對容器啟動而定義相依性時，它會保留給容器關閉。如需範例，請參閱「容器相依性」。

此參數要求任務或服務使用平台版本 1.3.0 或更新版本 (Linux) 或 1.0.0 (Windows)。

"dependsOn": [
    {
        "containerName": "string",
        "condition": "string"
    }
]

類型：SystemControl 物件

必要：否

要在容器中設定的命名空間核心參數清單。此參數會映射至 docker create-container 命令中的 Sysctls，以及 docker run 的 --sysctl 選項。例如，您可以規劃 net.ipv4.tcp_keepalive_time 設定以維持壽命較長的連線。

不建議您指定單一任務中多個容器的網路相關 systemControls 參數，而單一任務也使用 awsvpc 或 host 網路模式。執行此操作的缺點如下：

如果您為任務中的容器設定要使用的 IPC 資源命名空間，以下各項條件套用到您的系統控制。如需詳細資訊，請參閱IPC 模式。

"systemControls": [
    {
         "namespace":"string",
         "value":"string"
    }
]

類型：布林值

必要：否

此參數為 true 時，您可部署需要配置 stdin 或 tty 的容器化應用程式。此參數會映射至 docker create-container 命令中的 OpenStdin，以及 docker run 的 --interactive 選項。

預設值為 false。

類型：布林值

必要：否

當此參數為 true 時，會配置 TTY。此參數會映射至 docker create-container 命令中的 Tty，以及 docker run 的 --tty 選項。

預設值為 false。

類型：LinuxParameters 物件

必要：否

套用到容器的 Linux 特定修改項目，例如 Linux 核心功能。