mesosphere/marathon

Marathon 镜像文档

镜像概述和主要用途

Marathon 是一款经过生产验证的 https://mesos.apache.org/ 框架，用于容器编排。DC/OS 是开始使用 Marathon 最简单的方式。Marathon 提供 https://mesosphere.github.io/marathon/docs/rest-api.html 用于启动、停止和扩展应用，采用 Scala 编写，可通过运行多个实例实现高可用模式，运行任务的状态存储在 Mesos 状态抽象中。

作为"元框架"，Marathon 可启动其他 Mesos 框架（如 Chronos 或 http://storm.apache.org），确保它们在机器故障时仍能存活。它可以启动任何可在标准 shell 中启动的应用，甚至可通过 Marathon 启动其他 Marathon 实例。自 Marathon 0.7.0 和 Mesos 0.20.0 起，原生支持 https://mesosphere.github.io/marathon/docs/native-docker.html%E3%80%82

核心功能和特性

• 高可用性（HA）：可运行任意数量的 Marathon 调度器，但只有一个被选举为领导者；访问非领导者节点时，请求会被代理到当前领导者
• **https://mesosphere.github.io/marathon/docs/constraints.html**%EF%BC%9A%E4%BE%8B%E5%A6%82%EF%BC%8C%E6%AF%8F%E4%B8%AA%E6%9C%BA%E6%9E%B6%E3%80%81%E8%8A%82%E7%82%B9%E7%AD%89%E4%BB%85%E8%BF%90%E8%A1%8C%E4%B8%80%E4%B8%AA%E5%BA%94%E7%94%A8%E5%AE%9E%E4%BE%8B
• **https://mesosphere.github.io/marathon/docs/service-discovery-load-balancing.html**%EF%BC%9A%E9%80%9A%E8%BF%87 HAProxy 或事件 API 实现
• **https://mesosphere.github.io/marathon/docs/health-checks.html**%EF%BC%9A%E9%80%9A%E8%BF%87 HTTP 或 TCP 检查应用健康状态
• **https://mesosphere.github.io/marathon/docs/rest-api.html#event-subscriptions**%EF%BC%9A%E5%85%81%E8%AE%B8%E6%8F%90%E4%BE%9B HTTP 端点接收通知，例如与外部负载均衡器集成
• **https://mesosphere.github.io/marathon/docs/marathon-ui.html**%EF%BC%9A%E6%8F%90%E4%BE%9B Web 界面管理应用
• **https://mesosphere.github.io/marathon/docs/rest-api.html**%EF%BC%9A%E4%BE%BF%E4%BA%8E%E9%9B%86%E6%88%90%E5%92%8C%E8%84%9A%E6%9C%AC%E5%8C%96%E6%93%8D%E4%BD%9C
• 基本认证（Basic Auth）和 SSL：保障 API 访问安全
• **https://mesosphere.github.io/marathon/docs/metrics.html**%EF%BC%9A%E5%8F%AF%E9%80%9A%E8%BF%87 /metrics 端点以 JSON 格式查询，或推送到 graphite/statsd/datadog

使用场景和适用范围

Marathon 适用于需要在 Mesos 集群上进行容器编排和服务管理的场景，主要包括：

• 管理生产环境中的微服务和容器化应用，确保高可用性和故障恢复
• 部署和扩展 Docker 容器，实现资源的高效利用
• 作为元框架启动和管理其他 Mesos 框架（如 Chronos、Storm），保障整个集群服务的稳定性
• 需要通过 API 或 UI 进行应用生命周期管理（启动、停止、扩展）的场景
• 对服务健康检查、负载均衡和事件通知有需求的分布式系统

详细的使用方法和配置说明

依赖项

编译时依赖

• sbt：Scala 构建工具，安装说明见 http://www.scala-sbt.org/0.13/tutorial/Setup.html
• JDK 1.8+

运行时依赖

• libmesos：与 Apache Mesos master 通信的 JNI 绑定库，随 Apache Mesos 安装提供
• Apache Zookeeper：可单独为 Marathon 安装，或使用 Mesos 已有的 Zookeeper

安装

通过 DC/OS 快速开始

最简单的方式是使用 DC/OS，Marathon 已预捆绑在 DC/OS 中。

安装 Mesos

Marathon 需要 libmesos 共享库，该库包含 Marathon 与 Mesos master 通信的 JNI 绑定。安装 Mesos 有两种方式：

从预打包版本安装

预打包版本的安装说明见 https://mesosphere.github.io/marathon/docs/%E3%80%82

从源码构建 Mesos

注意：仅在从源码构建 Marathon 时选择此选项，否则可能导致 Marathon 预打包版本与源码构建的 Mesos 版本不兼容。

编译 Mesos 源码的说明见 http://mesos.apache.org/gettingstarted/%E3%80%82%E5%A6%82%E9%9C%80%E5%9C%A8%E9%9D%9E%E9%BB%98%E8%AE%A4%E4%BD%8D%E7%BD%AE%E5%AE%89%E8%A3%85 Mesos 库和可执行文件，配置时使用 --prefix 选项：

console
./configure --prefix=<Mesos 安装路径>

make install 会将 libmesos（Linux 上为 libmesos.so，Mac OS X 上为 libmesos.dylib）安装到指定目录。

安装 Marathon

预打包版本的安装说明见 https://mesosphere.github.io/marathon/docs/%E3%80%82%E4%B9%9F%E5%8F%AF%E4%BB%8E%E6%BA%90%E7%A0%81%E6%9E%84%E5%BB%BA%EF%BC%9A

从源码构建

1. 克隆仓库并使用 sbt 构建 JAR：

   console
   git clone https://github.com/mesosphere/marathon.git
   cd marathon
   sbt assembly
   

2. （可选）运行 ./bin/build-distribution 打包为 可执行 JAR。

开发模式运行

Mesos 本地模式允许在不启动完整 Mesos 集群的情况下运行 Marathon，适用于实验，不推荐生产环境。需运行 ZooKeeper 存储状态。以下命令在 Mesos 本地模式启动 Marathon，浏览器访问 http://localhost:8080 可查看 Marathon UI：

console
./bin/start --master local --zk zk://localhost:2181/marathon

生产环境运行和配置选项详见 https://mesosphere.github.io/marathon/docs/%E3%80%82

Docker 开发模式运行

注意：当前 Docker 容器可能因 Mesos 最新版本的异常行为而失败，会出现关于 work_dir 的未解决错误，类似：Failed to start a local cluster while loading agent flags from the environment: Flag 'work_dir' is required, but it was not provided

构建镜像

console
docker build -t marathon-head .

运行 Zookeeper（如无可用实例）

console
docker run --name some-zookeeper --restart always -d docker.xuanyuan.run/zookeeper

链接 Zookeeper 容器运行

console
docker run --link some-zookeeper:zookeeper docker.xuanyuan.run/marathon-head --master local --zk zk://zookeeper:2181/marathon

不链接 Zookeeper 容器运行

console
docker run docker.xuanyuan.run/marathon-head --master local --zk zk://localhost:2181/marathon

检查容器内容

console
docker run -it --entrypoint=/bin/bash docker.xuanyuan.run/marathon-head -s

Marathon 客户端工具

• https://github.com/shoenig/marathonctl%EF%BC%9A%E4%BE%BF%E6%8D%B7%E7%9A%84 Marathon 命令行控制工具
• https://rubygems.org/gems/marathon-api%EF%BC%9A 使用 Ruby 客户端运行 Chronos 示例：

  console
  marathon -M http://foo.bar:8080 start -i chronos -u https://s3.amazonaws.com/mesosphere-binaries-public/chronos/chronos.tgz \
      -C "./chronos/bin/demo ./chronos/config/nomail.yml \
      ./chronos/target/chronos-1.0-SNAPSHOT.jar" -c 1.0 -m 1024
  

• https://github.com/eBayClassifiedsGroup/marathon_deploy%EF%BC%9A%E4%BD%BF%E7%94%A8 JSON 或 YAML 文件（带 ENV 宏）部署的命令行工具
• https://github.com/guidewire/marathon-client%EF%BC%9A%E7%94%B1 Guidewire 开发
• https://github.com/mohitsoni/marathon-client%EF%BC%9A%E7%94%B1 Mohit Soni 开发
• https://github.com/holidaycheck/marathon-maven-plugin%EF%BC%9A%E7%94%B1 HolidayCheck 开发
• https://github.com/thefactory/marathon-python%EF%BC%9A%E7%94%B1 The Factory 开发
• https://github.com/Wizcorp/marathon-client.py%EF%BC%9A%E7%94%B1 Wizcorp 开发
• https://github.com/gambol99/go-marathon%EF%BC%9A%E7%94%B1 Rohith Jayawardene 开发
• https://github.com/jbdalido/gomarathon%EF%BC%9A%E7%94%B1 Jean-Baptiste Dalido 开发
• https://github.com/silas/node-mesos%EF%BC%9A%E7%94%B1 Silas Sewell 开发
• https://github.com/codemomentum/marathonclj%EF%BC%9A%E7%94%B1 Halit Olali 开发

帮助与支持

问题报告

发现问题可通过 https://github.com/mesosphere/marathon/issues 页面提交。为加快响应，请提供尽可能详细的问题复现步骤；如与 Web UI 相关，请添加 gui 标签。

社区支持

• 邮件列表：https://groups.google.com/forum/?hl=en#!forum/marathon-framework
• IRC 频道：freenode 上的 #marathon（Marathon 支持）和 #mesos（Mesos 支持）
• Mesosphere 团队也可解答问题

UX 研究参与

如希望参与设计研究并测试 Marathon 未发布的新功能，可加入 UX Research 列表。