Skip to main content
版本: 0.7.0

快速开始

0. 前置条件

1. 初始化一个空的 KCL 包

使用 kcl mod init 命令创建一个名为 my_package 的 kcl 程序包, 并且在我们创建完成一个名为 my_package 的包后,我们需要通过命令 cd my_package 进入这个包来进行后续的操作。

kcl mod init my_package && cd my_package

kcl 将会在执行kcl mod init my_package命令的目录下创建两个默认的配置文件 kcl.modkcl.mod.lock

- my_package
|- kcl.mod
|- kcl.mod.lock
|- # 你可以直接在这个目录下写你的kcl程序。

kcl.mod.lockkcl 用来固定依赖版本的文件,是自动生成的,请不要人工修改这个文件。

kcl 将会为这个新包创建一个默认的 kcl.mod。如下所示:

[package]
name = "my_package"
edition = "0.0.1"
version = "0.0.1"

2. 为 KCL 包添加依赖

然后,您可以通过 kcl mod add 命令来为您当前的库添加一个外部依赖。

如下面的命令所示,为当前包添加一个版本号为 1.28 并且名为 k8s 的依赖包。

kcl mod add k8s:1.28

kcl 会为您将依赖添加到 kcl.mod 文件中.

[package]
name = "my_package"
edition = "0.0.1"
version = "0.0.1"

[dependencies]
k8s = "1.28" # The dependency 'k8s' with version '1.28'

编写一个程序使用包 konfig 中的内容

在当前包中创建 main.k

- my_package
|- kcl.mod
|- kcl.mod.lock
|- main.k # Your KCL program.

并且将下面的内容写入 main.k 文件中。

# 导入并使用外部依赖 `k8s` 包中的内容。
import k8s.api.core.v1 as k8core

k8core.Pod {
metadata.name = "web-app"
spec.containers = [{
name = "main-container"
image = "nginx"
ports = [{containerPort = 80}]
}]
}

3. 运行 KCL 代码

你可以使用 kcl 编译刚才编写的 main.k 文件, 得到编译后的结果。

kcl run

输出为

apiVersion: v1
kind: Pod
metadata:
name: web-app
spec:
containers:
- image: nginx
name: main-container
ports:
- containerPort: 80