Skip to main content

· 阅读需要 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 社区 加入我们。

更多其他资源请参考：

· 阅读需要 1 分钟

简介​

在之前的几次更新中，我们为 KCL 语言增加了包管理的能力，解决了如何获取和发布三方库的问题。随之而来的新问题是，在开发程序的过程中，小伙伴们往往不确定该使用哪个库解决自己的问题。在通过包管理工具使用三方库之前，需要结合具体云原生运维场景的需求和各种三方库的能力去挑选合适的库使用。

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

因此，我们借助同为 CNCF 的 ArtifactHub 项目构建了一个 KCL 三方库的市场，在这个市场中，有需求的朋友们能够根据自己的需求自由选择自己需要的三方库，有想法愿意分享的朋友们，也可以在这个市场中与大家分享。接下来，我们将通过一个简单的发布应用的案例来近距离感受一下如何在 ArtifactHub 上检索 KCL 三方库，并结合库文档的内容进行 KCL 程序开发。

前置工作​

安装环境

使用以下命令启动 minikube

minikube start --cache-images=true

如果您的 minikube 中没有安装 Ingress 控制器，您可以使用如下命令安装：

minikube addons enable ingress

HelloWorld 案例​

首先，我们可以准备一个简单的 js 应用。

const express = require("express");
const app = express();
const port = 8080;

// 定义一个响应 GET 请求的路由
app.get("/", (req, res) => {
  res.send("欢迎来到我的Web应用程序！");
});

// 启动服务器
app.listen(port, () => {
  console.log(`Web app listening http://localhost:${port}`);
});

并且为这个应用准备一个镜像，并将镜像上传到镜像中心。

FROM node:14
WORKDIR /usr/src/app
COPY package*.json ./
RUN npm install
COPY . .
EXPOSE 8080
CMD [ "node", "app.js" ]

本文的案例中我们将使用镜像地址 ghcr.io/test/my-web-app:1.0 来展示具体的内容。完成了准备工作，我们就可以使用 KCL 编写对应的发布代码了。

使用 ArtifactHub 搜索您需要的包​

首先，我想要将我的 my-web-app 应用发布，我需要借助 k8s 的三方库完成我的工作。直接在 ArtifactHub 中搜索 k8s关键字，可以看到目前提供的 k8s 的三方库。

index-page

在 k8s 模型的主页中，您可以找到关于 k8s 包的文档，不同版本等更加详细的内容。

k8s-page

右侧的 INSTALL 按钮为您提供了安装 k8s 三方库的方式。

k8s-install-page

我们这里是使用 k8s 作为包的依赖，因此如下命令进行安装：

kcl mod init my-kubernetes-config && cd my-kubernetes-config && kcl mod add k8s:1.28

接下来，我们需要编写发布应用对应的 deployment, service 和 ingress 三个部分。这里需要使用到我们刚才添加的 k8s 包中的 Deployment, Service和 Ingress 三个 schema。  更多关于 schema 的内容可以查阅: https://kcl-lang.io/docs/next/reference/lang/tour#schema

如果您对这三个内容不太了解，您可以直接在模型的详情页进行搜索。以 Deployment 为例，您可以在文档中看到更加详细的信息。

deployment

根据文档的内容，我们可以在 main.k 文件中编写如下 deployment

import k8s.api.apps.v1 as d

deployment = d.Deployment {
    metadata.name = "web-app-deployment"
    spec = {
        selector.matchLabels = {app = "web-app"}
        template = {
            metadata.labels = {app = "web-app"}
            spec.containers = [{
                name = "web-app"
                image = "ghcr.io/test/my-web-app:1.0"
                ports = [{containerPort = 80}]
            }]
        }
    }
}

关于 Service, 可以查到相关文档：

service

对应的 service内容如下：

import k8s.api.core.v1 as s
service = s.Service {
    metadata.name = "web-app-service"
    spec.selector = {"app": "web-app"}
    spec.ports = [{
        port: 80
        targetPort: 8080
    }]
}

关于 Ingress, 可以查到相关文档

ingress

对应的 ingress内容如下：

import k8s.api.networking.v1 as i

ingress = i.Ingress {
    metadata.name = "web-app-ingress"
    spec.rules = [
        {
            host: "web-app.example.com"
            http.paths = [
                {
                    path: "/"
                    pathType: "Prefix"
                    backend.service.name: "web-app-service"
                    backend.service.port: {
                        number: 8080
                    }
                }
            ]
        }
    ]
}

最后，在 main.k 文件中增加如下内容，将 deployment, service 和 ingress 渲染为 yaml 格式。

manifests.yaml_stream([
    deployment
    service
    ingress
])

您可以使用如下命令编译对应的 KCL 程序，并且 apply。

kcl run main.k | kubectl apply -f -

进行到这里，我们已经在 ArtifactHub 的帮助下成功发布了应用 my-web-app。

最后，我们通过 kubectl 端口转发，来看一下发布的效果。使用以下命令进行转发。

kubectl port-forward service/web-app-service 8080:80

然后通过如下命令或者直接通过浏览器访问 http://localhost:8080 来访问我们发布的应用。

curl http://localhost:8080

如果您通过 curl 命令行访问，您将会获得输出：

$ curl http://localhost:8080

欢迎来到我的 Web 应用程序！

如果您通过浏览器访问，您将会看到：

browser

总结​

本文通过一个简单的应用发布，为大家展示了如何在 ArtifactHub 上选择合适的 KCL 三方库，目前 ArtifactHub 上已经提供超过 150 个 KCL 三方库供大家选择，快来看看有没有你需要的 KCL 模型吧 ！

在本文提供的案例中，我们用 KCL 编写了发布应用的程序。在后续的更新中，我们将进一步通过动态参数等特性对本文中的 KCL 程序进行抽象以及使用更多的应用模型介绍如 Open Application Model (OAM) 等，并且打包成一个单独的模块发布到 ArtifactHub 中，如果您也有想要与他人分享的 KCL 模块，我们将继续更新详细的步骤和指南，帮助您成功发布您的包。敬请期待！