Fargate 注意事项 - Amazon Elastic Container Service
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

Fargate 注意事项

要使用 Fargate,您必须将任务定义配置为使用 Fargate 启动类型。使用 Fargate 时还有其他注意事项。

任务定义参数

使用 Fargate 启动类型的任务并非支持所有可用的 Amazon ECS 任务定义参数。某些参数完全不受支持,而其他参数对于 Fargate 任务的行为则不同。

以下任务定义参数在 Fargate 任务中无效:

  • disableNetworking

  • dnsSearchDomains

  • dnsServers

  • dockerSecurityOptions

  • extraHosts

  • gpu

  • ipcMode

  • links

  • placementConstraints

  • privileged

  • maxSwap

  • swappiness

以下任务定义参数在 Fargate 任务中有效,但应注意以下限制:

  • linuxParameters – 当指定适用于容器的 Linux 特定选项时,对于 capabilities,您可以添加的唯一功能是 CAP_SYS_PTRACEdevicessharedMemorySizetmpfs 参数不受支持。有关更多信息,请参阅 Linux 参数

  • volumes – Fargate 任务仅支持绑定挂载主机卷,因此, dockerVolumeConfiguration 参数不受支持。有关更多信息,请参阅

  • cpu - 对于 Amazon Fargate 上的 Windows 容器,该值不能小于 1 vCPU。

为确保您的任务定义可验证用于 Fargate,可在注册任务定义时指定以下内容:

  • 在 Amazon Web Services Management Console中,为 Requires Compatibilities (需要兼容性) 字段指定 FARGATE

  • 在 Amazon CLI 中指定 --requires-compatibilities 选项。

  • 在 Amazon ECS API 中指定 requiresCompatibilities 标记。

操作系统和架构

为 Amazon Fargate 配置任务和容器定义时,您必须指定容器运行的操作系统。Amazon Fargate 支持以下操作系统:

  • Amazon Linux 2

    注意

    Linux 容器仅使用主机操作系统中的内核和内核配置。例如,内核配置包括 sysctl 系统控件。Linux 容器映像可以由包含任何 Linux 发行版中的文件和程序的基本映像创建。如果 CPU 架构匹配,则可以在任何操作系统上通过任何 Linux 容器映像运行容器。

  • Windows Server 2019 Full

  • Windows Server 2019 Core

  • Windows Server 2022 Full

  • Windows Server 2022 Core

当您在 Amazon Fargate 上运行 Windows 容器时,您必须具有 X86_64 CPU 架构。

当您在 Amazon Fargate 上运行 Linux 容器时,您可以使用 X86_64 CPU 架构,也可以使用 ARM64 架构用于基于 ARM 的应用程序。有关更多信息,请参阅 使用 Amazon ECS 上的 64 位 ARM 工作负载

任务 CPU 和内存

Amazon Fargate 的 Amazon ECS 任务定义需要您在任务级别指定 CPU 和内存。尽管您还可以在容器级别为 Fargate 任务指定 CPU 和内存,但这是可选项。只需在任务级别指定这些资源便可满足大多数使用案例。下表显示了任务级 CPU 和内存的有效组合。您可以在 JSON 文件中以 MiB 或 GB 为单位指定内存值。您可以在 JSON 文件中将 CPU 值指定为以 CPU 单位数或虚拟 CPU(vCPU)为单位的整数。

CPU 值

内存值

Amazon Fargate 支持的操作系统

256 (.25 vCPU)

512MiB、1GB、2GB

Linux

512 (.5 vCPU)

1GB、2GB、3GB、4GB

Linux

1024 (1 vCPU)

2GB、3GB、4GB、5GB、6GB、7GB、8GB

Linux、Windows

2048 (2 vCPU)

4GB 到 16GB 之间 (以 1GB 为增量)

Linux、Windows

4096 (4 vCPU)

8GB 到 30GB 之间 (以 1GB 为增量)

Linux、Windows

8192 (8 vCPU)

注意

此选项需要 Linux 平台 1.4.0 或更高版本。

16 GB 到 60 GB 之间(以 4 GB 为增量)

Linux

16384 (16vCPU)

注意

此选项需要 Linux 平台 1.4.0 或更高版本。

32 GB 到 120 GB 之间(以 8 GB 为增量)

Linux

任务联网

Amazon Fargate 的 Amazon ECS 任务要求使用 awsvpc 网络模式,该模式可为每个任务提供一个弹性网络接口。在使用此网络模式运行任务或创建服务时,必须指定一个或多个要附加网络接口的子网以及一个或多个要应用于该网络接口的安全组。

如果您使用的是公有子网,请决定是否为网络接口提供公有 IP 地址。对于公有子网中拉取容器映像的 Fargate 任务,需要向该任务的弹性网络接口分配一个公有 IP 地址,还需要一个到互联网的路由,或一个可以将请求路由到互联网的 NAT 网关。对于私有子网中拉取容器映像的 Fargate 任务,您需要私有子网中的 NAT 网关以将请求路由到互联网。在 Amazon ECR 中托管容器映像时,您可以将 Amazon ECR 配置为使用接口 VPC 端点。在这种情况下,任务的专用 IPv4 地址将用于图像提取。有关 Amazon ECR 接口端点的更多信息,请参阅 Amazon Elastic Container Registry 用户指南中的 Amazon ECR 接口 VPC 端点 (Amazon PrivateLink)

以下是 Fargate 服务的 networkConfiguration 部分的示例:

"networkConfiguration": { "awsvpcConfiguration": { "assignPublicIp": "ENABLED", "securityGroups": [ "sg-12345678" ], "subnets": [ "subnet-12345678" ] } }

任务资源限制

Amazon Fargate 上的 Linux 容器的 Amazon ECS 任务定义支持使用 ulimits 参数来定义要为容器设置的资源限制。

Amazon Fargate 上的 Windows 的 Amazon ECS 任务定义支持使用 ulimits 参数来定义要为容器设置的资源限制。

Fargate 上托管的 Amazon ECS 任务使用操作系统设置的默认资源限制值,nofile 资源限制参数除外。nofile 资源限制对容器可以使用的打开文件数量设置限制。在 Fargate 上,默认的 nofile 软限制为 1024,硬限制为 65535。您可以将两个限制的值最高设置为 1048576

下面是一个示例任务定义代码段,介绍如何定义 nofile 限制已经增加了一倍:

"ulimits": [ { "name": "nofile", "softLimit": 2048, "hardLimit": 8192 } ]

有关可以调整的其他资源限制的更多信息,请参阅资源限制

日志记录

事件日志记录

Amazon ECS 将其采取的操作记录到 EventBridge 中。您可以使用 EventBridge 的 Amazon ECS 事件来接收有关 Amazon ECS 集群、服务和任务当前状态的近实时通知。此外,您还可以自动执行操作以响应这些事件。有关更多信息,请参阅 使用 EventBridge 自动响应 Amazon ECS 错误

任务生命周期日志记录

在 Fargate 上运行的任务会发布时间戳,以便在任务生命周期的各个状态中跟踪任务。通过描述 Amazon CLI 和开发工具包中的任务,可以在 Amazon Web Services Management Console 中的任务详细信息中查看时间戳。例如,您可以使用时间戳来评估任务下载容器映像所花费的时间,并决定是应优化容器映像大小,还是使用 Seekable OCI 索引。有关容器映像实践的更多信息,请参阅 容器映像的最佳实践

应用程序日志记录

Amazon Fargate 的 Amazon ECS 任务定义支持用于日志配置的 awslogssplunkawsfirelens 日志驱动程序。

awslogs 日志驱动程序会将您的 Fargate 任务配置为向 Amazon CloudWatch Logs 信息。下面显示了任务定义中配置 awslogs 日志驱动程序的代码段:

"logConfiguration": { "logDriver": "awslogs", "options": { "awslogs-group" : "/ecs/fargate-task-definition", "awslogs-region": "us-east-1", "awslogs-stream-prefix": "ecs" } }

有关在任务定义中使用 awslogs 日志驱动程序以将容器日志发送到 CloudWatch Logs 的更多信息,请参阅 使用 awslogs 日志驱动程序

有关任务定义中的 awsfirelens 日志驱动程序的更多信息,请参阅使用自定义日志路由

有关在任务定义中使用 splunk 日志驱动程序的更多信息,请参阅splunk 日志驱动程序

任务存储

对于 Fargate 上托管的 Amazon ECS 任务,支持以下存储类型:

使用 Seekable OCI(SOCI)延迟加载容器映像

Fargate 上使用 Linux 平台版本 1.4.0 的 Amazon ECS 任务可以使用 Seekable OCI(SOCI)来帮助更快地启动任务。借助 SOCI,容器只需花几秒钟的时间进行映像拉取即可启动,从而在后台下载映像时为环境设置和应用程序实例化提供了时间。这称为延迟加载。当 Fargate 启动 Amazon ECS 任务时,Fargate 会自动检测任务中是否存在映像的 SOCI 索引,并在不等待下载整个映像的情况下启动容器。

对于在没有 SOCI 索引的情况下运行的容器,容器映像将在容器启动之前完全下载。此行为在 Fargate 的所有其他平台版本上以及 Amazon EC2 实例上经 Amazon ECS 优化的 AMI 上均相同。

Seekable OCI 索引

Seekable OCI(SOCI)是 Amazon 开发的一种开源技术,它可以通过延迟加载容器映像来更快地启动容器。SOCI 的工作原理是为现有容器映像中的文件创建索引(SOCI 索引)。此索引有助于更快地启动容器,从而提供在下载整个映像之前从容器映像中提取单个文件的功能。SOCI 索引必须作为构件存储在与容器注册表中的映像相同的存储库中。您只能使用来自可信来源的 SOCI 索引,因为该索引是映像内容的权威来源。有关更多信息,请参阅介绍用于延迟加载容器映像的 Seekable OCI

注意事项

如果您希望 Fargate 使用 SOCI 索引在任务中延迟加载容器映像,请考虑以下几点:

  • 只有在 Linux 平台版本 1.4.0 上运行的任务才能使用 SOCI 索引。不支持在 Fargate 上运行 Windows 容器的任务。

  • 支持在 X86_64 或 ARM64 CPU 架构上运行的任务。使用 ARM64 架构的 Linux 任务不支持 Fargate Spot 容量提供程序。

  • 任务定义中的容器映像必须在与映像相同的容器注册表中具有 SOCI 索引。

  • 任务定义中的容器映像必须存储在兼容的映像注册表中。以下列出了兼容的注册表:

    • Amazon ECR 私有注册表。

  • 仅支持使用 gzip 压缩或未压缩的容器映像。不支持使用 zstd 压缩的容器映像。

  • 建议您尝试使用大于 250 MiB 压缩后的容器映像进行延迟加载。您不太可能看到加载较小映像的时间缩短。

  • 由于延迟加载可能会改变任务启动所需的时间,因此您可能需要对各种超时时间进行更改,例如 Elastic Load Balancing 的运行状况检查宽限期。

  • 如果要防止延迟加载容器映像,请从容器注册表中删除 SOCI 索引。如果任务中的容器映像不符合其中一个注意事项,则使用默认方法下载该容器映像。

创建 Seekable OCI 索引

对于要延迟加载的容器映像,需要创建 SOCI 索引(元数据文件),并将其与容器映像一起存储在容器映像存储库中。要创建和推送 SOCI 索引,您可以使用 GitHub 上的开源 soci-snapshotter CLI 工具。或者,您可以部署 CloudFormation Amazon SOCI 索引构建器。这是一种无服务器解决方案,可以在将容器映像推送到 Amazon ECR 时自动创建和推送 SOCI 索引。有关解决方案和安装步骤的更多信息,请参阅 GitHub 上的 CloudFormation Amazon SOCI 索引构建器。CloudFormation Amazon SOCI 索引构建器是自动开始使用 SOCI 的一种方法,而开源 SOCI 工具在索引生成方面具有更大的灵活性,并且能够将索引生成集成到持续集成和持续交付(CI/CD)管道中。

注意

要为映像创建 SOCI 索引,该映像必须存在于正在运行 soci-snapshotter 的计算机上的 containerd 映像存储中。如果映像在 Docker 映像存储中,则无法找到该映像。

验证任务是否使用延迟加载

要验证任务是否使用 SOCI 延迟加载,请从任务内部检查任务元数据端点。在您查询任务元数据端点版本 4 时,在您要查询的容器的默认路径中有一个 Snapshotter 字段。此外,/task 路径中每个容器都有 Snapshotter 字段。此字段的默认值为 overlayfs,如果使用 SOCI,则此字段设置为 soci。有关更多信息,请参阅《适用于 Amazon Fargate 的 Amazon Elastic Container Service 用户指南》中的任务元数据端点版本 4