KCL 是一个开源的基于约束的记录及函数语言并通过成熟的编程语言技术和实践来改进对大量繁杂配置比如云原生 Kubernetes 配置场景的编写,致力于构建围绕配置的更好的模块化、扩展性和稳定性,更简单的逻辑编写,以及更简单的自动化和生态工具集成。
本栏目将会双周更新 KCL 语言社区最新动态,包括功能、官网更新和最新的社区动态等,帮助大家更好地了解 KCL 社区!
KCL 官网:https://kcl-lang.io
内容概述
感谢所有贡献者过去两周 (2023 09.07 - 10.11) 的杰出工作,以下是重点合并内容概述
🔧 语言及工具链更新
- KCL v0.6.0 于 9.15 发布,更新内容包括语言、工具链、社区集成,详细内容请查看 https://mp.weixin.qq.com/s/f6RCZqxS2iliRGIz0036yA
- KCL IDE 更新 - 支持对标准库和内置函数的悬停提示,支持对 KCL 代码错误的快速修复;发布适配 Intellij IDEA 2023.2 的插件版本
- KCL 包管理工具 KPM 更新 - kpm run 支持编译 KCL 文件,并集成了导入工具
- KCL 文档工具更新 - 支持将 docstring Examples 章节输出到文档
- KCL 语言更新 - 优化了一些错误信息的输出,部分的错误信息中增加了修复建议
📰 官网和用例更新
- KCL 官网新增 v0.6.0 文档版本
- KCL 模型新增容器、服务和 Pod Security Policy (PSP) 相关的配置编辑、校验 20 个 https://github.com/kcl-lang/krm-kcl/tree/main/examples
特别鸣谢
以下排名不分先后
- 感谢 @jakezhu9 对 KCL Import 工具 Terraform Schema 到 KCL Schema 转换的贡献 🙌 https://github.com/kcl-lang/kcl-go/pull/152
- 感谢 @jakezhu9 对 kpm 集成 Import 工具的贡献 🙌 https://github.com/kcl-lang/kpm/pull/194
- 感谢 @zwpaper 对 KCL 文档和 Tree Sitter Grammar 做出的贡献 🙌 https://github.com/kcl-lang/tree-sitter-kcl/pull/1 等
- 感谢 @mrgleeco, @ghpu, @steeling, @prahaladramji, @zwpaper 等在使用 KCL 及工具链过程中提出的宝贵反馈和讨论 🙌
精选更新
KCL IDE 插件更新
在最近的 0.6.0 发布中,KCL IDE 插件增加了标准库和 builtin 函数的悬停提示,新增支持对 KCL 代码错误的快速修复。此外,还增加了 language Server 侧的 e2e 测试及 konfig 仓库的集成测试,以保障 IDE 插件的稳定迭代。在尚未发布的版本中,还新增了 kcl-language-server version
子命令以输出版本信息。欢迎升级、使用 —— KCL 在各个 IDE 平台的插件安装方式请查看https://kcl-lang.io/docs/user_docs/getting-started/install/#2-install-kcl-ide-extension
IntelliJ 插件
- IntelliJ 插件现已适配 2023.2+ 版本,您可以在下面的链接中下载安装:
https://github.com/kcl-lang/intellij-kcl/releases
KCL 包管理工具
kpm run 支持编译 KCL 文件,并集成了导入工具,同时增加了 —quiet 来屏蔽输出日志。
KCL 语言更新
在尚未发布的版本中,KCL 的编译命令优化了一些错误信息的输出,部分的错误信息中增加了修复建议:
KCL 模型更新
近几周内,我们提供了更多针对容器、服务和 Pod Security Policy (PSP) 配置编辑及校验的使用案例。您可参照对应的示例引入以上配置和校验: https://github.com/kcl-lang/krm-kcl/tree/main/examples
下面我们以 Kubectl KCL 插件和 disallow-svc-lb 模型进行说明,disallow-svc-lb 的作用是对 Service 资源进行校验,不允许 Service 资源的类型设置为 LoadBalancer
,编写如下 YAML 文件 (manifests.yaml):
apiVersion: krm.kcl.dev/v1alpha1
kind: KCLRun
metadata:
name: disallow-svc-lb
annotations:
krm.kcl.dev/version: 0.0.1
krm.kcl.dev/type: validation
documentation: >-
A validation that prevents the creation of Service resources of type `LoadBalancer`
spec:
source: oci://ghcr.io/kcl-lang/disallow-svc-lb
---
apiVersion: v1
kind: Service
metadata:
name: my-service
spec:
selector:
app.kubernetes.io/name: MyApp
ports:
- name: http
protocol: TCP
port: 80
type: LoadBalancer # 错误地设置了 LoadBalancer
通过 Kubectl KCL 工具在客户端进行资源验证:
kubectl kcl apply -f manifests.yaml
我们会得到如下结果:
A validation that prevents the creation of Service resources of type `LoadBalancer`, for Service: my-service
社区动态
集成了 KCL 0.6 的 KusionStack 发布 0.9 版本,详细更新内容请查看:https://mp.weixin.qq.com/s/nZOHdmgcfOMRf0XUXfSJ-g
其他资源
❤️ 感谢所有 KCL 用户和社区小伙伴在社区中提出的宝贵反馈与建议。预计 11 月底我们会正式发布 KCL v0.7 新版本,敬请期待!
更多其他资源请参考: