Skip to main content

1 post tagged with "Biweekly-Newsletter"

查看所有标签

· 阅读需要 1 分钟

KCL 是一个 CNCF 基金会托管的基于约束的记录及函数语言，期望通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写，致力于构建围绕配置的更好的模块化、扩展性和稳定性，更简单的逻辑编写，以及更简单的自动化和生态工具集成。

本栏目将会双周更新 KCL 语言社区最新动态，包括功能、官网更新和最新的社区动态等，帮助大家更好地了解 KCL 社区！

KCL 官网：https://kcl-lang.io

内容概述​

感谢所有贡献者过去两周 (2023 11.24 - 12.07) 的杰出工作，以下是重点内容概述

📦 模型更新

KCL 模型数量新增至 240 个，主要新增与 Crossplane Provider 相关的模型和与 JSON 合并操作相关的库

🔧 工具链更新

  • 文档工具更新
    • 支持模型依赖的三方库的文档生成，比如 k8s 模型
  • 验证工具更新
    • 支持验证结果和错误定位到 YAML/JSON 文件，输出错误行列号信息
  • 导入工具更新
    • 支持 OpenAPI multiplyOf 规范映射到 KCL multiplyof 函数进行校验
    • 支持 YAML Stream 格式的 Kubernetes CRD 文件输出为多个 KCL 文件
    • 优化 KCL 代码生成，去除空的 check 语句

🏄 SDK 更新

  • 在 KCL 已有 Go 和 Python SDK 的基础上新增 Rust SDK (不需要 LLVM 依赖), 初步包含 KCL 文件编译、校验、测试和格式化代码等 API

💻 IDE 更新

  • 体验改进
    • 支持增量解析和异步编译功能，提升性能
  • 错误修复
    • 修复 assert 语句中字符串插值变量不能跳转的异常
    • 修复了字符串中异常触发函数补全的异常
    • 修复 import 语句别名语义检查和补全的异常
    • 修复了 schema 中 check 表达式补全的异常

📒 文档更新

特别鸣谢​

以下排名不分先后

  • 感谢 @professorabhay 支持 KCL 测试 Diff 功能 🙌
  • 感谢 @patrycju, @Callum Lyall, @Even Solberg, @Matt Gowie, @ShiroDN 在使用 KCL 过程中的交流与宝贵反馈 🙌

精选更新​

在 KCL 中使用 Kubernetes Strategy Merge Patch 更新配置​

在目前的 KCL 版本中支持使用各种属性运算符对配置进行更新和覆盖操作，但是能力还比较原子，无法很好地覆盖云原生常规的配置策略场景，对于 Kubernetes 配置，会频繁地使用到 Kubernetes 原生支持的 Json Merge Patch 和 Strategy Merge Patch 能力，比如使用 kubectl patch, kustomize 和大部分与云原生配置/策略工具开箱支持的 Patch 能力。

因此，为了避免在 KCL 中处理 Kubernetes 配置时反复使用 KCL 属性运算符编写配置 Patch 的模版代码，我们提供了 Kubernetes Strategy Merge Patch 库用于 Kubernetes 配置更新，并且支持所有 Kubernetes 原生对象定义的合并策略，比如列表对象的覆盖，修改和添加等。下面是使用方式

  • 新建工程并添加 Strategy Merge Patch 库依赖
kcl mod init && kcl mod add strategic_merge_patch
  • 在 main.k 中编写配置 Patch 代码 (以 Deployment 模版的 labels, replicas 和 container 字段为例)
import strategic_merge_patch as s

original = {
    apiVersion = "apps/v1"
    kind = "Deployment"
    metadata = {
        name = "my-deployment"
        labels.app = "my-app"
    }
    spec: {
        replicas = 3
        template.spec.containers = [
            {
                name = "my-container-1"
                image = "my-image-1"
            }
            {
                name = "my-container-2"
                image = "my-image-2"
            }
        ]
    }
}
patch = {
    apiVersion = "apps/v1"
    kind = "Deployment"
    metadata = {
        name = "my-deployment"
        labels.version = "v1"
    }
    spec: {
        replicas = 4
        template.spec.containers = [
            {
                name = "my-container-1"
                image = "my-new-image-1"
            }
            {
                name = "my-container-3"
                image = "my-image-3"
            }
        ]
    }
}
got = s.merge(original, patch)
  • 运行命令获得输出
kcl run

输出为

original:
  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: my-deployment
    labels:
      app: my-app
  spec:
    replicas: 3
    template:
      spec:
        containers:
          - name: my-container-1
            image: my-image-1
          - name: my-container-2
            image: my-image-2
patch:
  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: my-deployment
    labels:
      version: v1
  spec:
    replicas: 4
    template:
      spec:
        containers:
          - name: my-container-1
            image: my-new-image-1
          - name: my-container-3
            image: my-image-3
got:
  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: my-deployment
    labels:
      app: my-app
      version: v1
  spec:
    replicas: 4
    template:
      spec:
        containers:
          - name: my-container-1
            image: my-new-image-1
          - name: my-container-2
            image: my-image-2
          - name: my-container-3
            image: my-image-3

可以看到 Deployment 模版的 labels, replicas 和 container 字段都被更新为了正确的值，更多文档和使用方式请查阅 https://artifacthub.io/packages/kcl/kcl-module/strategic_merge_patch

其他资源​

❤️ 感谢所有 KCL 用户和社区小伙伴在社区中提出的宝贵反馈与建议。后续我们会发布更多 KCL 云原生模型和工具集成文章，敬请期待! 查看 KCL 社区 加入我们。

更多其他资源请参考：

· 阅读需要 1 分钟

KCL 是一个 CNCF 基金会托管的基于约束的记录及函数语言，期望通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写，致力于构建围绕配置的更好的模块化、扩展性和稳定性，更简单的逻辑编写，以及更简单的自动化和生态工具集成。

本栏目将会双周更新 KCL 语言社区最新动态，包括功能、官网更新和最新的社区动态等，帮助大家更好地了解 KCL 社区！

KCL 官网：https://kcl-lang.io

内容概述​

感谢所有贡献者过去两周 (2023 11.09 - 11.23) 的杰出工作，以下是重点内容概述

📦 模型更新

💬 语言更新

  • 体验改进
    • 优化配置代码块的语法缩进检查，不再强制报错
    • 支持通过文件路径通配符作为编译入口
  • 错误修复
    • 修复部分场景字典类型的类型推导错误
    • 修复 Schema 参数数量的检查

🔧 工具链更新

💻 IDE 更新

  • 体验改进
    • 支持包管理工具引入的外部包依赖 import 语句补全
  • 错误修复
    • 修复函数参数未定义类型错误显示位置

🏄 API 更新

🔥 架构升级

  • KCL 设计并重构了新的语义模型以及支持最近符号查找和符号语义信息查询 API
  • IDE 补全，跳转和悬停等功能实现迁移至新语义模型，显著降低 IDE 功能开发难度和代码量

🚀 性能提升

  • KCL 编译器支持语法增量解析以及语义增量检查，大部分场景提升 KCL 编译构建和 IDE 插件使用性能 5-10 倍

特别鸣谢​

以下排名不分先后

精选更新​

在 Artifact Hub 上检索 KCL 代码包及云原生模型​

  • 通过 k8s 模型编写或者校验 Kubernetes 配置

  • 通过 Open Application Model (OAM) 开放应用模型配合 KubeVela 控制器进行应用发布与运维

  • 查找 KCL 代码库如 jsonpatch 进行配置操作

后续我们会通过一系列文章讲解各个模型更具体使用场景以及工作流程，敬请期待! 200+ 模型的源代码位于 https://github.com/kcl-lang/modules，欢迎社区的小伙伴进行共建。❤️

其他资源​

❤️ 感谢所有 KCL 用户和社区小伙伴在社区中提出的宝贵反馈与建议。预计 11 月底我们会正式发布 KCL v0.7 新版本，敬请期待! 查看 KCL 社区 加入我们。

更多其他资源请参考：