KCL JSON/YAML 配置数据一键集成 [一个自研编程语言能做什么？(系列 4)]

什么是 KCL

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

简介

在 KCL 中，不仅可以将 KCL 编写的配置代码编译输出为 YAML 格式的数据，还可以将 JSON/YAML 等数据直接嵌入到 KCL 语言当中。

使用 KCL 进行数据集成

1. 获得示例

git clone https://github.com/KusionStack/kcl-lang.io.git/ cd ./kcl-lang.io/examples/data-integration 

2. YAML 集成

我们可以运行以下命令来显示 KCL YAML 集成配置。

cat yaml.k 

import yaml schema Server: ports: [int] server: Server = yaml.decode("""\ ports: - 80 - 8080 """) server_yaml = yaml.encode({ ports = [80, 8080] }) 

在上述代码中，我们通过 KCL 内置的 yaml 模块以及其中的 yaml.decode 直接完成 YAML 数据的集成，并且使用 Server schema 对集成的 YAML 数据直接进行校验。此外，我们可以使用 yaml.encode 完成 YAML 数据的序列化。

我们通过如下命令可以获得配置输出:

$ kcl yaml.k server: ports: - 80 - 8080 server_yaml: "ports:\n - 80\n - 8080\n" 

3. JSON 集成

同样的，对于 JSON 数据，我们可以使用 json.encode 和 json.decode 函数以同样的方式进行数据集成。

我们可以运行以下命令来显示 KCL JSON 集成配置。

cat json.k 

import json schema Server: ports: [int] server: Server = json.decode('{"ports": [80, 8080]}') server_json = json.encode({ ports = [80, 8080] }) 

执行命令输出为:

$ kcl json.k server: ports: - 80 - 8080 server_json: "{\"ports\": [80, 8080]}" 

小结

本文介绍了如何在 KCL 中进行数据集成，使用 KCL 内置的 yaml 和 json 包将 YAML 和 JSON 数据直接集成到 KCL 语言中，并使用相应的解码和编码功能对其进行验证和序列化。