mesosphere/dcos-commons

DC/OS SDK开发镜像

镜像概述和主要用途

DC/OS SDK是一个工具、库和文档的集合，旨在简化Kafka、Cassandra、HDFS、Spark、TensorFlow等技术与DC/OS的集成过程。本镜像作为mesosphere/dcos-commons项目的开发环境，提供了构建和部署DC/OS服务所需的基础组件和规范定义能力。

核心功能和特性

• 声明式服务定义：通过YAML格式的服务规范文件， declaratively 定义服务的结构和行为
• Pod与任务管理：支持定义Pod规格及其中的任务，包括任务目标状态、资源分配和命令执行
• 环境变量注入：支持通过环境变量动态配置服务参数，如Pod数量、CPU资源等
• 持久化卷配置：提供容器卷定义功能，支持数据持久化存储

使用场景和适用范围

适用于开发需要在DC/OS平台上部署和运行的分布式服务，尤其适合需要集成主流大数据、流处理和机器学习技术的场景。开发人员可利用本镜像快速构建符合DC/OS规范的服务部署包。

使用方法和配置说明

Hello World服务规范示例

服务规范通过YAML文件 declaratively 定义helloworld服务：

yaml
name: "helloworld"
pods:
  helloworld:
    count: {{COUNT}}
    tasks:
      server:
        goal: RUNNING
        cmd: "echo 'Hello World!' >> helloworld-container-volume/output && sleep 10"
        cpus: {{SERVER_CPU}}
        memory: 32
        volume:
          path: "helloworld-container-volume"
          type: ROOT
          size: 64

配置说明

• 服务名称：通过name: "helloworld"定义服务名称

• Pod规格：

  yaml
  pods:
    helloworld:
      count: {{COUNT}}
      tasks:
        ...
  

  定义helloworld Pod的规格，其中count: {{COUNT}}指定Pod实例数量，COUNT为环境变量（通过Marathon注入调度进程，本示例默认值为1）

• 任务规格：

  yaml
  tasks:
    server:
      goal: RUNNING
      cmd: "echo 'Hello World!' >> helloworld-container-volume/output && sleep 10"
      cpus: {{SERVER_CPU}}
      memory: 32
  

  定义server任务，配置包括：

  • goal: RUNNING：任务目标状态为运行中
  • cmd：任务执行命令，将"Hello World!"写入输出文件并休眠10秒
  • cpus: {{SERVER_CPU}}：CPU资源分配（本示例默认值为0.5）
  • memory: 32：内存资源分配（32MB）

• 持久化卷配置：

  yaml
  volume:
    path: "helloworld-container-volume"
    type: ROOT
    size: 64
  

  配置64MB的持久化卷，路径为helloworld-container-volume，用于任务数据持久化

参考资料

• https://mesosphere.github.io/dcos-commons/developer-guide/
• https://mesosphere.github.io/dcos-commons/reference/api/

贡献

欢迎贡献！详见CONTRIBUTING。

许可证

DC/OS SDK采用Apache License 2.0许可证。