Metronome 放置约束

了解 Metronome 放置约束

Metronome 放置约束控制作业运行的位置。约束有三个部分:字段名称、算子和值。该字段可以是代理的主机名或代理的任何属性。

Metronome 支持 Marathon™ 算子的子集,并且支持 Marathon 的所有特殊字段名称。

字段名称

代理属性作为字段名称

字段名称以 @ 开头的约束引用代理属性。

主机名

字段名称与代理主机名相匹配时输入 @hostname 参见 LIKE 算子,查看使用示例。

分域和分区作为字段名称

使用 @region@zone 字段名称配置 故障域感知和容量扩展. 参见 IS 算子,查看使用示例。

属性作为字段名称

如果 @hostname@region@zone 未指定为字段名称,则字段名称将被解释为 Mesos 代理属性

Metronome 支持文本、标量和范围属性值。对于标量和范围,Metronome 将对格式化值进行字符串比较,因为它们将 根据 Mesos 中的规范进行指定。

算子

IS 算子

支持 DC/OS™ 1.12.1 及更高版本。

(必填):Mesos 标量或文本值,由 Mesos 属性和资源类型规范指定:

scalar : floatValue

floatValue : ( intValue ( "." intValue )? ) | ...

intValue : [0-9]+

text : [a-zA-Z0-9_/.-]

比较文本值

指定 IS 限制后,任务仅在具有指定值的节点上启动。

{
  "id": "sleep-cluster",
  "cmd": "sleep 60",
  "instances": 3,
  "constraints": [["rack", "IS", "rack-1"]]
}

比较标量值

比较标量时,将值与最接近的千分位数进行比较(使用半偶舍入法)。

假设代理的属性为“级别:0.8”,则匹配以下限制:

[["level", "IS", "0.8"]]

[["level", "IS", "0.80"]]

[["level", "IS", "0.8001"]]

示例

以下示例将导致作业在 us-east-1 区域中运行:

{
  "description": "Remote Sleeper",
  "id": "sleeper-remote",
  "run": {
    ...,
    "placement": {
      "constraints": [
        { "attribute": "@region", "operator": "IS", "value": "us-east-1" }
      ]
    }
  }
}

LIKE 算子

(必填):属性值的正则表达式。

LIKE 接受正则表达式作为参数,并且只允许在字段值与正则表达式匹配的代理上运行任务。请注意,必须匹配整个值(假设正则表达式周围有隐式 ^$

{
  "description": "Important Job",
  "id": "sleeper",
  "run": {
    ...,
    "placement": {
      "constraints": [
        { "attribute": "@hostname", "operator": "LIKE", "value": "host-[7-9]" }
      ]
    }
  }
}

LIKE 约束不会匹配缺少相关属性的代理发出的 offer。

如果相关属性是一个标量,则会利用半偶(half-even)舍入法舍入到最接近的千分位数;小数点后的零会去掉。

UNLIKE 算子

(必填):属性值的正则表达式。

UNLIKE 类似于 LIKE 算子,但指示 Metronome 仅在字段值 不与正则表达式匹配的代理上运行任务。

{
  "description": "Important Job",
  "id": "sleeper",
  "run": {
    ...,
    "placement": {
      "constraints": [
        { "attribute": "@hostname", "operator": "UNLIKE", "value": "temp-host-.*" }
      ]
    }
  }
}

UNLIKE 约束将匹配缺少相关属性的代理发出的 offer。