mesos 配置向导

mesos master 和 slave 可以通过命令行参数或环境变量来传递一系列的配置选项。通过运行 mesos-master --help 或者 mesos-slave --help 可以查看相关的可用选项。每个选项可以通过以下两种方式设置：

• 执行命令的时候使用 –-option_name=value 来传递配置选项。value 既可以是数值，也可以指定包含参数的文件 (--opthon_name=file://文件路径)。 该路径既可以是绝对路径，也可以是相对当前工作目录的相对路径。

• 通过设定环境变量 MESOSOPTION_NAME (变量名都以 MESOS 开头)
  执行时会先读取环境变量，然后才看命令行参数

配置参数会首先在环境中搜索，然后才是命令行。

重要的配置

如果你有特定的需求，当配置 Mesos 的时候请参考 ./configure --help。另外，本文档列举了最新的配置选项。如果你想知道手头的版本支持哪些标志位，你可以运行带有 --help 的命令，例如 mesos-master --help。

Master 和 Slave 的配置选项

下列选项 都被 master 和 slave 所支持：

{
  "disabled_endpoints" : {
    "paths" : [
      "/files/browse",
      "/metrics/snapshot"
    ]
  }
}

{
  "libraries": [
    {
      "file": "/path/to/libfoo.so",
      "modules": [
        {
          "name": "org_apache_mesos_bar",
          "parameters": [
            {
              "key": "X",
              "value": "Y"
            }
          ]
        },
        {
          "name": "org_apache_mesos_baz"
        }
      ]
    },
    {
      "name": "qux",
      "modules": [
        {
          "name": "org_apache_mesos_norf"
        }
      ]
    }
  ]
}

masters 和 slaves 同时支持以下这些日志选项 更多日志信息，请访问 http://mesos.apache.org/documentation/latest/logging/

Master 配置选项

必选参数

zk://host1:port1,host2:port2,.../path
zk://username:password@host1:port1,host2:port2,.../path
file:///path/to/file (where file contains one of the above)

可选参数

{
  "register_frameworks": [
    {
      "principals": { "type": "ANY" },
      "roles": { "values": ["a"] }
    }
  ],
  "run_tasks": [
    {
      "principals": { "values": ["a", "b"] },
      "users": { "values": ["c"] }
    }
  ],
  "teardown_frameworks": [
    {
      "principals": { "values": ["a", "b"] },
      "framework_principals": { "values": ["c"] }
    }
  ],
  "set_quotas": [
    {
      "principals": { "values": ["a"] },
      "roles": { "values": ["a", "b"] }
    }
  ],
  "remove_quotas": [
    {
      "principals": { "values": ["a"] },
      "quota_principals": { "values": ["a"] }
    }
  ]
}

{
  "credentials": [
    {
      "principal": "sherman",
      "secret": "kitesurf"
    }
  ]
}

username secret

{
  "limits": [
    {
      "principal": "foo",
      "qps": 55.5
    },
    {
      "principal": "bar"
    }
  ],
  "aggregate_default_qps": 33.3
}

通过 --with-network-isolator 配置时可用的标记

Slave 选项

必选项

可选项

{
  "principal": "username",
  "secret": "secret"
}

{
  "type": "MESOS",
  "volumes": [
    {
      "host_path": "./.private/tmp",
      "container_path": "/tmp",
      "mode": "RW"
    }
  ]
}

{
  "PATH": "/bin:/usr/bin",
  "LD_LIBRARY_PATH": "/usr/local/lib"
}

[
  {
    "name": "cpus",
    "type": "SCALAR",
    "scalar": {
      "value": 24
    }
  },
  {
    "name": "mem",
    "type": "SCALAR",
    "scalar": {
      "value": 24576
    }
  }
]

当配置了 ' –with-network-isolator ', 以下标记位才会生效：

--ephemeral_ports_per_container=VALUE   有网络隔离器分配临时端口给一个容器。此端口号必须是 2 的倍数。( 默认: 1024 )
--eth0_name = VALUE             公网接口的名称 ( 如 eth0 )。如果没有指定，网络隔离器会尝试基于主机的默认网关来猜测它。
--lo_name=VALUE                 网络 loopback 接口的名称( 例如, lo )。如果没有指定，网络隔离器会尝试猜测它。
--egress_rate_limit_per_container=VALUE 每个容器的出口流量限制，单位是 字节/每秒。如果没有指定或指定为零，网络隔离器不会强制限制容器的出口流量。这个标记使用字节类型, 定义在 stout 。
--[no-]network_enable_socket_statistics_summary 是否从每个容器收集 socket 统计摘要。这个标记位被用在  'network/port_mapping' 隔离器。 ( 默认: false )
--[no-]network_enable_socket_statistics_details 是否从每个容器收集 socket 细节信息。该标记用于 ' network/port_mapping ' 隔离器。( 默认: false )

Mesos构建配置选项

配置脚本有以下可选的功能标志

--enable-shared[=PKGS]    建立共享库 [ 默认: yes ]
--enable-static[=PKGS]    建立静态库 [ 默认: yes ]
--enable-fast-install[=PKGS] 快速安装 [ 默认: yes ]
--disable-libtool-lock    避免锁死 ( 可能会破坏并行编译 )
--disable-java            不需要构建 Java 绑定
--disable-python          不需要构建 Python 绑定
--enable-debug            启用 Debug 调试。如果设置了 CFLAGS/CXXFLAGS ，这个选项不会改变它们。默认: no
--enable-optimize         启用优化 如果设置了 CFLAGS/CXXFLAGS ，这个选项不会改变它们。默认: no
--disable-bundled         预装相关依赖，而不是绑定 libraries 。
--disable-bundled-distribute 不包含构建和使用绑定的分发包来替换在 PYTHONPATH 中的已安装版本。
--disable-bundled-pip    excludes 不包含构建和使用绑定的 pip 包来替换在 PYTHONPATH 中的已安装版本.
--disable-bundled-wheel      不包含构建和使用绑定的 wheel 包来替换在 PYTHONPATH 中的已安装版本
--disable-python-dependency-install 当在 make install 期间安装 python 包，不需要外部的依赖或安装。

配置脚本有以下的标志位针对可选的包选项：

--with-gnu-ld            假设 C 编译器使用 GNU ld [ 默认: no ]
--with-sysroot=DIR       在 DIR 中搜索依赖库 ( 或者如果编译器的 sysroot 没有指定 )
--with-zookeeper[=DIR]      不包含构建和已构建的 ZooKeeper 包来替代在一个给定的目录为前缀名的地址下的已安装版本。
--with-leveldb[=DIR]        不包含构建的和使用与 LevelDB 绑定的包来替代在一个给定的目录为前缀名的地址下的已安装版本。
--with-glog[=DIR]           不包含构建的和使用与 glog 绑定的包来替代在一个给定的目录为前缀名的地址下的已安装版本。
--with-protobuf[=DIR]       不包含构建的和使用与 protobuf 绑定的包来替代在一个给定的目录为前缀名的地址下的已安装版本。
--with-gmock[=DIR]          不包含构建的和使用与 gmock 绑定的包来替代在一个给定的目录为前缀名的地址下的已安装版本
--with-curl=[=DIR] 指定在哪里找到 curl 库
--with-sasl=[=DIR] 指定在哪里找到 sasl2 库
--with-zlib=[=DIR] 指定在哪里找到 zlib 库
--with-apr=[=DIR] 指定在哪里找到 apr-1 库
--with-svn=[=DIR] 指定在哪里找到 svn-1 库
--with-network-isolator 建立网络隔离

一些 influential 的环境变量配置脚本：

使用这些变量来重写 'configure'生成的选择项或帮助其来查找库文件和非标准的名字/地址一起来编程。

   JAVA_HOME              JDK 根目录
   JAVA_CPPFLAGS          JNI 目录
   JAVA_JVM_LIBRARY       libjvm.so 的完整路径
   MAVEN_HOME             mvn 的根目录
   PROTOBUF_JAR　         在 prefixed builds　上完整的 protobuf jar　路径
   PYTHON　               指定使用哪个 Python 解析器
   PYTHON_VERSION         已经安装并使用的 Python 版本号 例如，'2.3'。该字符串将追加到 Python 解析器