技术概述

了解 Pod

Pod 是特殊类型的 Mesos 任务组,而 pod 中的任务或容器是组成员。通过 Mesos 启动组指令,将 pod 实例的容器一起彻底启动。

DC/OS 作为单一服务处理并展示 pod。pod 共享网络命名空间中的容器和临时卷。您可以通过 pod 定义配置 pod,这类似于 Marathon 应用定义。然而 Pod 和应用定义之间有一些差异。例如:

  • 您必须指定端点(不是端口号),以便其他应用程序与 Pod 通信。
  • Pod 具有单独的重置 API。
  • Pod 仅支持 Mesos 级健康检查。

网络

Marathon Pod 仅支持 DC/OS 通用容器运行时间,该运行时间支持多种镜像格式,包括 Docker。

通用容器运行时间允许每个 pod 实例的容器通过 VLAN 或专用网络共享网络命名空间并进行通信,从而简化网络。如果在 pod 定义中指定没有名称的容器网络,它将被分配到默认网络。如果您已使用 AWS 模板 安装了 DC/OS,则默认网络是 dcos

如果其他应用需要与您的 pod 通信,请在 pod 定义中指定一个端点。其他应用程序将通过访问这些端点与 Pod 进行通信。参见 示例部分,了解更多信息。

在您的 pod 定义中,您可以声明 hostcontainer 网络类型。借助 host 类型创建的 Pod 共享主机的网络命名空间。借助 container 类型创建的 Pod 则使用虚拟网络。如果您指定 container 网络类型且 Marathon 未配置为具有默认网络名称,您也必须在 name 字段中声明虚拟网络名称。参见完整 JSON 的 示例 部分。

临时存储库

Pod 内的容器共享临时存储库。在 pod 级别声明卷,且在被 name 引用之后安装到特定容器中。

Pod 事件和状态

更新已启动的 pod 时,只有在重新部署完成时才可使用 pod 的新版本。查询系统,了解在重新部署之前部署哪个版本时,您收到的回复可能是先前的版本。询问 Pod 状态时会收到同样的答复:如果更新 pod,在完成重新部署之前,状态更改将不会反映在查询中。

历史记录永久关联 pod_id。如果删除 pod,然后重新使用该 ID,即使 Pod 的详细信息不同,新的 pod 仍会显示先前的历史记录(例如,版本信息)。

Pod 定义

Pod 通过 JSON pod 定义接受配置,与 Marathon 方式相似 应用定义。您必须声明 Pod 中每个容器所需的资源,因为Mesos(而非 Marathon)决定了对 Pod 请求的所有资源执行隔离的方式和时间。参见 示例 部分,了解完整的 pod 定义。

环境变量

在 pod 级别定义的环境变量将传播到所有 pod 容器。Pod 级环境变量被在 pod 容器级别定义的环境变量覆盖。

端口的环境变量使用 pod 容器端点名称(即,ENDPOINT_<ENDPOINT_NAME>=)定义。

以下是反映 多个 Pod JSON pod 定义示例 的环境变量示例。

  1. MESOS_EXECUTOR_ID=instance-test-pod.c2b47e5c-d1f5-11e6-a247-a65e72d2dda4
  2. MARATHON_CONTAINER_RESOURCE_DISK=32.0
  3. SHLVL=1
  4. EP_CONTAINER_HTTPENDPOINT=8080
  5. PYTHON_PIP_VERSION=9.0.1
  6. MARATHON_CONTAINER_RESOURCE_MEM=32.0
  7. ENDPOINT_HTTPENDPOINT=8080
  8. GPG_KEY=97FC712E4C024BBEA48A61ED3A5CA953F73C700D
  9. EP_HOST_HTTPENDPOINT2=21529
  10. MARATHON_APP_ID=/test-pod
  11. EP_CONTAINER_HTTPENDPOINT2=8081
  12. ENDPOINT_HTTPENDPOINT2=8081
  13. MARATHON_CONTAINER_RESOURCE_CPUS=0.1
  14. PATH=/usr/local/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin
  15. MESOS_SANDBOX=/mnt/mesos/sandbox
  16. MARATHON_CONTAINER_RESOURCE_GPUS=0
  17. HOST=10.0.1.60
  18. PYTHON_VERSION=3.5.2
  19. MARATHON_APP_VERSION=2017-01-03T20:46:54.497Z
  20. MARATHON_APP_LABELS=
  21. MARATHON_CONTAINER_ID=healthtask1
  22. PWD=/mnt/mesos/sandbox
  23. EP_HOST_HTTPENDPOINT=21528

执行器资源

执行器在每个节点上运行,以管理脚本。默认情况下,执行器为每个 Pod 保留 32 MB 和 0.1 个 CPU 作为日常使用。在为 Pod 中的容器声明资源需求时,请将此日常使用考虑在内。可以修改 Pod 定义的 executorResources 字段中的执行器资源。

  1. {
  2. "executorResources": {
  3. "cpus": 0.1,
  4. "mem": 64,
  5. "disk": 10mb
  6. }
  7. }

密钥

在 Pod 定义的 secrets 字段中指定密钥。论据应该是存储库中的密钥的完全限定路径。

  1. {
  2. "secrets": {
  3. "someSecretName": { "source": "/fully/qualified/path" }
  4. }
  5. }

Pod 支持临时卷,临时卷在 pod 级别定义。Pod 定义必须包括 volumes 字段(其中至少指定卷的名称)和 volumeMounts 字段(其中至少指定卷挂载路径)。

  1. {
  2. "volumes": [
  3. {
  4. "name": "etc"
  5. }
  6. ]
  7. }
  1. {
  2. "volumeMounts": [
  3. {
  4. "name": "env",
  5. "mountPath": "/mnt/etc"
  6. }
  7. ]
  8. }

Pod 还支持主机卷。Pod 卷参数可以声明 host 字段,用于引用代理上的已有文件或目录。

  1. {
  2. "volumes": [
  3. {
  4. "name": "local",
  5. "host": "/user/local"
  6. }
  7. ]
  8. }

注意:重新启动 pod 后,数据不复存在。

共享内存

由于 pod 中的任务在同一个代理上运行,因此可以为任务定义共享内存段。任务可以拥有自己的专用共享内存,也可以使用执行器定义的共享内存段:

可以在容器和/或执行器上定义 linuxInfo 对象,用 modeshmSize 定义 ipcInfo

规则通常如下:

对于 mode

  • PRIVATE:容器/执行器具有专用共享内存段
  • SHARE_PARENT:容器/执行器使用其各自父代的共享内存段。
注意:如果是 SHARE_PARENT,这用于执行器,则共享内存命名空间与代理共享。这种情况可能会在 Mesos 配置中被禁用,可能并非总是有效。 对于 shmSize
  • 只能在模式为 PRIVATE 时使用
  • 允许以兆字节定义共享内存段的大小

任务的专用共享内存段

本示例定义了一个 pod,其带有一个具有 16MB 大小专用共享内存段的容器。

  1. {
  2. "id": "/pod",
  3. "containers": [
  4. {
  5. "name": "container0",
  6. "resources": {
  7. "cpus": 0.1,
  8. "mem": 32
  9. },
  10. "image": {
  11. "kind": "DOCKER",
  12. "id": "private/image"
  13. },
  14. "linuxInfo": {
  15. "ipcInfo": {
  16. "mode": "PRIVATE",
  17. "shmSize": 16
  18. }
  19. },
  20. "exec": {
  21. "command": {
  22. "shell": "sleep 1000"
  23. }
  24. }
  25. }
  26. ]
  27. }

任务之间共享

要共享 IPC 命名空间,需要定义执行器(任务的父容器)上的共享内存设置和大小。任务本身需要将模式设置为 SHARE_PARENT

此示例定义了一个具有共享内存的两个容器的 pod,该内存在执行器上定义,因此可以被两个容器访问。

  1. {
  2. "id": "/pod",
  3. "containers": [
  4. {
  5. "name": "container0",
  6. "resources": {
  7. "cpus": 0.1,
  8. "mem": 32
  9. },
  10. "image": {
  11. "kind": "DOCKER",
  12. "id": "private/image"
  13. },
  14. "linuxInfo": {
  15. "ipcInfo": {
  16. "mode": "SHARE_PARENT"
  17. }
  18. },
  19. "exec": {
  20. "command": {
  21. "shell": "sleep 1000"
  22. }
  23. }
  24. },
  25. {
  26. "name": "container1",
  27. "resources": {
  28. "cpus": 0.1,
  29. "mem": 32
  30. },
  31. "image": {
  32. "kind": "DOCKER",
  33. "id": "private/image"
  34. },
  35. "linuxInfo": {
  36. "ipcInfo": {
  37. "mode": "SHARE_PARENT"
  38. }
  39. },
  40. "exec": {
  41. "command": {
  42. "shell": "sleep 1000"
  43. }
  44. }
  45. }
  46. ],
  47. "linuxInfo": {
  48. "ipcInfo": {
  49. "mode": "PRIVATE",
  50. "shmSize": 16
  51. }
  52. }
  53. }

容器

Marathon Pod 支持 DC/OS 通用容器运行时间。通用容器运行时 支持多个镜像,例如 Docker

以下 JSON 为 Pod 指定了 Docker 镜像:

  1. {
  2. "image":{
  3. "id":"mesosphere/marathon:latest",
  4. "kind":"DOCKER",
  5. "forcePull":false
  6. }
  7. }

限制

  • 目前仅支持基于 Mesos 的运行状况检查。
  • 不支持就绪检查。
  • 不支持服务端口。
  • 无法配置依赖关系。
  • 通用环境变量(例如 $PORT0)未传递。