搜公众号
推荐 原创 视频 Java开发 开发工具 Python开发 Kotlin开发 Ruby开发 .NET开发 服务器运维 开放平台 架构师 大数据 云计算 人工智能 开发语言 其它开发 iOS开发 前端开发 JavaScript开发 Android开发 PHP开发 数据库
Lambda在线 > k8s技术圈 > jsonnet 和 Kubernetes

jsonnet 和 Kubernetes

k8s技术圈 2019-02-09
举报

Jsonnet 是 Google 开源的一门配置语言,用于增强 JSON 暴露出来的短板,它与 JSON 完全兼容并加入了一些新特性,包括注释、引用、算术运算、条件操作符、数组和对象深入、引入函数、局部变量、继承等,Jsonnet 程序被编译为兼容 JSON 的数据格式,简单来说 Jsonnet 就是 JSON 的增强版。

核心的思想就是某些 JSON 字段会被作为在编译时计算的变量或者表达式保留下来,比如,JSON 对象 {"size":10}可以表示为 {size:5+5},除此之外,我们还可以使用在编译期间引用的 ::来声明隐藏的字段,比如 {x::5,y::5,size:$.x+$.y}也会被计算成 {"size":10}

Jsonnet 对象还可以通过将对象连接在一起来覆盖字段值来进行子类化,例如,我们定义下面的内容:

 
   
   
 
  1. local base = {

  2.    x:: error "必须定义'x'的值",

  3.    y:: 2,  // 属性y有默认值2

  4.    size: $.x + $.y

  5. };

然后 Jsonnet 表达式 (base+{x::8})就将会被编译成 {"size":10},我们需要提供属性 x的值,否则会引发错误,这样,我们就可以把 base看成在 Jsonnet 中定义抽象基类了。

当然除此之外,Jsonnet 还有一些其他的用法,更多关于 Jsonnet 的使用方法,我们可以前往官方网站 https://jsonnet.org/ 查看说明。

Jsonnet 和 Kubernetes

Kubernetes 作为一个强大的容器化编排系统,可以通过 JSON 和 YAML 文件来管理各种资源对象,自然 Jsonnet 也是支持的。

如果我们只在 Jsonnet 中只配置一个 Kubernetes 对象的话,那么我们就会错过了在具有共性的对象集合之间删除重复数据的能力。幸运的是,我们有几种方法可以来配置 Kubernetes 对象集合:使用 YAML 流输出、多文件输出或者单个 kubectl 列对象,熟悉 Kubernetes 的都知道,后面一种是 Kubernetes 支持的,无需 Jsonnet 提供任何支持,它允许我们将几个 Kubernetes 对象组合成一个对象,这是一个非常重要的能力,因为它不需要任何的中间文件。

Kubernetes 社区对 Jsonnet 非常活跃,下面的一些资源对你了解 Jsonnet 可能有所帮助:

  • Jsonnet repo 的一个简单例子:https://github.com/google/jsonnet/tree/master/case_studies/kubernetes

  • Kubecfg(https://github.com/ksonnet/kubecfg)是一个使用 Jsonnet 来管理 Kubernetes 资源的工具,另外还附带一个模板库(https://github.com/bitnami-labs/kube-libsonnet),可以通过这篇文章了解更多信息(https://engineering.bitnami.com/articles/an-example-of-real-kubernetes-bitnami.html)。

  • Heptio(https://heptio.com)是 Ksonnet(https://ksonnet.io) 的 Kubecfg 的一个分支,它使用一个 Jsonnet 库,该库是从 Kubernetes API 规范中自动生成的,现在这个库已经形成了一个框架,可以使用更高级的方式来描述 Kubernetes 对象。

  • Kapitan(https://github.com/deepmind/kapitan)是 Deepmind(https://deepmind.com/)与 Jsonnet和文本模板驱动 Kubernetes 的另外一个工具。

  • Box(https://www.box.com/)在博客(https://blog.box.com/blog/kubernetes-box-microservices-maximum-velocity/)和 Youtube(https://youtu.be/QIDrdZlEQdw?t=10m35s)上谈到了其内部Kubernetes为主的基础设施如何使用 Jsonnet 的。

  • Databricks(https://databricks.com/)写了一篇关于如何使用 Jsonnet 来管理 Kubernetes 基础设施的(https://databricks.com/blog/2017/06/26/declarative-infrastructure-jsonnet-templating-language.html),除此之外,他们还写了一个关于 Jsonnet 的风格指南(https://github.com/databricks/jsonnet-style-guide)。

下面是一个我们平时经常使用的 YAML 文件来声明的对象资源:(kube.yaml)

 
   
   
 
  1. kind: ReplicationController

  2. apiVersion: v1

  3. metadata:

  4.  name: spark-master-controller

  5. spec:

  6.  replicas: 1

  7.  selector:

  8.    component: spark-master

  9.  template:

  10.    metadata:

  11.      labels:

  12.        component: spark-master

  13.    spec:

  14.      containers:

  15.        - name: spark-master

  16.          image: k8s.gcr.io/spark:1.5.2_v1

  17.          command: ["/start-master"]

  18.          ports:

  19.            - containerPort: 7077

  20.            - containerPort: 8080

  21.          resources:

  22.            requests:

  23.              cpu: 100m

如果将上述 YAML 文件转换成对应的 Jsonnet 文件的:(output.jsonnet)

 
   
   
 
  1. {

  2.  kind: 'ReplicationController',

  3.  apiVersion: 'v1',

  4.  metadata: {

  5.    name: 'spark-master-controller',

  6.  },

  7.  spec: {

  8.    replicas: 1,

  9.    selector: {

  10.      component: 'spark-master',

  11.    },

  12.    template: {

  13.      metadata: {

  14.        labels: {

  15.          component: 'spark-master',

  16.        },

  17.      },

  18.      spec: {

  19.        containers: [

  20.          {

  21.            name: 'spark-master',

  22.            image: 'k8s.gcr.io/spark:1.5.2_v1',

  23.            command: [

  24.              '/start-master',

  25.            ],

  26.            ports: [

  27.              {

  28.                containerPort: 7077,

  29.              },

  30.              {

  31.                containerPort: 8080,

  32.              },

  33.            ],

  34.            resources: {

  35.              requests: {

  36.                cpu: '100m',

  37.              },

  38.            },

  39.          },

  40.        ],

  41.      },

  42.    },

  43.  },

  44. }

Kubernetes 集合

在某些地方,Kubernetes API 对象使用命名对象或者键值对的列表,而不是使用对象将名称映射到值,这使得这些对象很难在 Jsonnet 中引用和扩展,例如,Pod 的容器声明部分如下所示:

 
   
   
 
  1. local PodSpec = {

  2.    containers: [

  3.        {

  4.            name: "foo",

  5.            env: [

  6.                {name: 'var1', value: 'somevalue'},

  7.                {name: 'var2', value: 'somevalue'}

  8.            ]

  9.        },

  10.        {

  11.            name: 'bar',

  12.            env: [

  13.                {name: 'var2', value: 'somevalue'},

  14.                {name: 'var3': value: 'somevalue'}

  15.            ]

  16.        }

  17.    ]

  18. };

如果我们想要覆盖它来修改环境变量 var3 的值,那么我们可以使用数组索引来引用特定的容器和环境变量:

 
   
   
 
  1. PodSpec {

  2.  containers:[

  3.    super.containers [0],

  4.    super.containers [1] {

  5.      env:[

  6.        super.env [0],

  7.        super.env [1] {value'othervalue'},

  8.      ],

  9.    },

  10.  ],

  11. }

但是很明显上面的代码是比较乱的,更好的解决方案是使用对象来表示映射,然后转换为 Kubernetes 对象。首先定义一个工具类:(utils.libsonnet)

 
   
   
 
  1. // utils.libsonnet

  2. {

  3.  pairList(tab, kfield='name', vfield='value'):: [

  4.    { [kfield]: k, [vfield]: tab[k] }

  5.    for k in std.objectFields(tab)

  6.  ],


  7.  namedObjectList(tab, name_field='name'):: [

  8.    tab[name] + { [name_field]: name }

  9.    for name in std.objectFields(tab)

  10.  ],

  11. }

然后定义 Pod :(pod-spec.jsonnet)

 
   
   
 
  1. local utils = import 'utils.libsonnet';


  2. local PodSpec = {

  3.  containersObj:: {

  4.    foo: {

  5.      envObj:: {

  6.        var1: 'somevalue',

  7.        var2: 'somevalue',

  8.      },

  9.      env: utils.pairList(self.envObj),

  10.    },

  11.    bar: {

  12.      envObj:: {

  13.        var2: 'somevalue',

  14.        var3: 'somevalue',

  15.      },

  16.      env: utils.pairList(self.envObj),

  17.    },

  18.  },

  19.  containers:

  20.    utils.namedObjectList(self.containersObj),

  21. };


  22. PodSpec {

  23.  containersObj+: {

  24.    bar+: { envObj+: { var3: 'othervalue' } }

  25.  }

  26. }

然后编译后就可以得到环境变量被替换后的结果:(output.json)

 
   
   
 
  1. {

  2.  "containers": [

  3.    {

  4.      "env": [

  5.        {

  6.          "name": "var2",

  7.          "value": "somevalue"

  8.        },

  9.        {

  10.          "name": "var3",

  11.          "value": "othervalue"

  12.        }

  13.      ],

  14.      "name": "bar"

  15.    },

  16.    {

  17.      "env": [

  18.        {

  19.          "name": "var1",

  20.          "value": "somevalue"

  21.        },

  22.        {

  23.          "name": "var2",

  24.          "value": "somevalue"

  25.        }

  26.      ],

  27.      "name": "foo"

  28.    }

  29.  ]

  30. }

这种模式也使得引用的时候更加容易,现在,我们就可以使用以下代码访问相同的环境变量:

 
   
   
 
  1. PodSpec.containersObj.bar.envObj.var3

原文链接:https://jsonnet.org/articles/kubernetes.html

版权声明:本站内容全部来自于腾讯微信公众号,属第三方自助推荐收录。《jsonnet 和 Kubernetes》的版权归原作者「k8s技术圈」所有,文章言论观点不代表Lambda在线的观点, Lambda在线不承担任何法律责任。如需删除可联系QQ:516101458

文章来源: 阅读原文

相关阅读

举报