Amazon EC2 Container Service
开发人员指南 (API Version 2014-11-13)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。点 击 Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.

Amazon ECS 任务放置约束

任务放置约束 是放置任务时会考虑的一条规则。有关更多信息,请参阅 Amazon ECS 任务放置

约束类型

Amazon ECS 支持以下类型的任务放置约束:

distinctInstance

将每项任务放置在不同的容器实例中。

memberOf

将任务放置在满足表达式的容器实例中。

有关表达式语法的更多信息,请参阅集群查询语言

属性

您可以将自定义元数据添加到容器实例中,称为属性。每个属性都有一个名称和一个可选字符串值。您可以使用 Amazon ECS 提供的内置属性,或自定义属性。

内置属性

Amazon ECS 会自动将以下属性应用于您的容器实例。

ecs.ami-id

用于启动实例的 AMI 的 ID。本属性的示例值为 "ami-eca289fb"。

ecs.availability-zone

实例所在的可用区。本属性的示例值为 "us-east-1a"。

ecs.instance-type

实例的实例类型。本属性的示例值为 "g2.2xlarge"。

ecs.os-type

实例的操作系统。本属性可能的值为 "linux" 和 "windows"。

自定义属性

您可以将自定义属性应用于您的容器实例。例如,您可以定义名为 "stack"、值为 "prod" 的属性。

添加属性

您可以使用 AWS 管理控制台,在实例注册时使用容器代理添加或手动添加自定义属性。有关使用容器代理的更多信息,请参阅 Amazon ECS 容器代理配置参数

使用控制台添加自定义属性

  1. https://console.amazonaws.cn/ecs/ 上打开 Amazon ECS 控制台。

  2. 在导航窗格中,选择 Clusters 并选择一个集群。

  3. ECS Instances 选项卡上,选择容器实例的复选框。

  4. 选择 ActionsView/Edit Attributes

  5. 对于每个属性,请执行以下操作:

    1. 选择 Add attribute

    2. 键入属性的名称和值。

    3. 选择选中标记图标保存属性。

  6. 属性添加完毕后,选择 Close

使用 AWS CLI 添加自定义属性

以下示例说明了如何使用 put-attributes 命令添加自定义属性。

示例:单个属性

以下示例将自定义属性 "stack=prod" 添加到默认集群的指定容器实例中。

Copy
aws ecs put-attributes --attributes name=stack,value=prod,targetId=arn

示例:多个属性

以下示例将自定义属性 "stack=prod" 和 "project=a" 添加到默认集群的指定容器实例中。

Copy
aws ecs put-attributes --attributes name=stack,value=prod,targetId=arn name=project,value=a,targetId=arn

按属性筛选

您可以为容器实例应用筛选条件,从而能够查看自定义属性。

使用控制台按属性筛选容器实例

  1. 打开 Amazon EC2 控制台 https://console.amazonaws.cn/ec2/

  2. 选择具有容器实例的群集。

  3. 选择 ECS Instances

  4. 通过选择齿轮图标 ( ) 并选择要显示的属性来设置列可见性首选项。此设置将在与您的账户关联的所有容器群集中保留。

  5. 使用 Filter by attributes 文本字段,键入或选择要作为筛选条件的属性。格式必须为 AttributeName:AttributeValue

    对于 Filter by attributes,键入或选择要作为筛选条件的属性。在选择属性名称后,系统会提示您提供属性值。

  6. 根据需要向筛选条件添加其他属性。通过选择某个属性旁的 X 可删除该属性。

使用 AWS CLI 按属性筛选容器实例

以下示例说明了如何使用 list-constainer-instances 命令按属性筛选容器实例。有关筛选语法的更多信息,请参阅集群查询语言

示例:内置属性

以下示例使用内置属性列出 g2.2xlarge 实例。

Copy
aws ecs list-container-instances --filter "attribute:ecs.instance-type == g2.2xlarge"

示例:自定义属性

以下示例列出了具有自定义属性 "stack=prod" 的实例。

Copy
aws ecs list-container-instances --filter "attribute:stack == prod"

示例:排除属性值

以下示例列出了具有自定义属性 "stack",且其值仅为 "prod" 的实例。

Copy
aws ecs list-container-instances --filter "attribute:stack != prod"

示例:多个属性值

以下示例使用内置属性列出 t2.small 或 t2.medium 类型的实例。

Copy
aws ecs list-container-instances --filter "attribute:ecs.instance-type in [t2.small, t2.medium]"

示例:多个属性

以下示例使用内置属性列出可用区 us-east-1a 中的 T2 实例。

Copy
aws ecs list-container-instances --filter "attribute:ecs.instance-type =~ t2.* and attribute:ecs.availability-zone == us-east-1a"

任务组

您可以将一组相关任务组成任务组。在执行分布放置时,具有相同任务组名称的所有任务均被视为一组。例如,假设一个集群中运行着不同应用程序,如数据库和 Web 服务器。为确保您的数据库在各可用区之间达到平衡,请将它们添加到名为 "databases" 的任务组,然后使用此任务组约束任务放置。

当您使用 RunTaskStartTask 操作启动任务时,可以为该任务指定任务组名称。如果您没有为该任务指定任务组,默认名称是任务定义的系列名称 (例如,family:my-task-definition)。

对于服务计划程序启动的任务,任务组名称是服务的名称 (例如,service:my-service-name)。

限制

  • 任务组名称必须为 255 个字符或更少。

  • 每项任务只能处于一个组中。

  • 任务启动后,您将无法修改其任务组。

约束示例

您可以使用以下操作指定任务放置约束:CreateServiceRegisterTaskDefinitionRunTask

以下约束将任务放置于 T2 实例。

Copy
"placementConstraints": [ { "expression": "attribute:ecs.instance-type =~ t2.*", "type": "memberOf" } ]

以下约束将任务放置于 "databases" 任务组中的实例。

Copy
"placementConstraints": [ { "expression": "task:group == databases", "type": "memberOf" } ]

以下约束将组中的每项任务放置于不同实例上。

Copy
"placementConstraints": [ { "type": "distinctInstance" } ]