Skip to main content
版本: 0.10

配置

简介​

配置是软件系统的一个重要方面，由于不断发展的业务需求、基础设施需求和其他因素，这些系统会不断发生变化。通常，快速改变这些系统的行为可能具有挑战性，尤其是当这样做需要昂贵且耗时的重建和重新部署过程时。在这种情况下，仅仅对业务代码进行更改可能是不够的。幸运的是，配置提供了一种低开销的方式来修改系统功能。

我们可以根据需要将静态配置存储在 JSON 或 YAML 等文件中。此外，配置也可以存储在高级语言中，从而实现更灵活的配置。这种语言可以进行编码、呈现和静态配置。KCL 是一种提供此类功能的配置语言。开发人员可以编写 KCL 代码来生成 JSON/YAML 和其他配置。

使用 KCL 编写配置代码​

KCL 的核心特性是其建模和约束能力，KCL 核心功能基本围绕 KCL 这个两个核心特性展开，对于代码而言（包括配置代码）都存在对配置数据约束的需求，比如类型约束、配置字段必选/可选约束、范围约束、不可变性约束等，这也是 KCL 致力于解决的核心问题之一。

现在我们已经了解了 KCL 的基本功能，让我们探索如何使用它来生成配置。

0. 先决条件​

1. 获取示例​

首先，执行如下命令获取示例

git clone https://github.com/kcl-lang/kcl-lang.io.git/
cd ./kcl-lang.io/examples/configuration

我们可以执行如下命令显示配置代码

cat nginx.k

输出为:

schema Nginx:
    """Schema for Nginx configuration files"""
    http: Http

schema Http:
    server: Server

schema Server:
    listen: int | str    # The attribute `listen` can be int type or a string type.
    location?: Location  # Optional, but must be non-empty when specified

schema Location:
    root: str
    index: str

nginx = Nginx {
    http.server = {
        listen = 80
        location = {
            root = "/var/www/html"
            index = "index.html"
        }
    }
}

2. 使用 KCL 生成 YAML​

执行如下命令:

kcl nginx.k

我们可以获得如下 YAML 输出

nginx:
  http:
    server:
      listen: 80
      location:
        root: /var/www/html
        index: index.html

3. 为配置添加动态参数​

此外，我们可以通过 KCL 内置函数 option 动态接收外部参数。例如，对于下面的 KCL 文件（db.k），我们可以使用命令行 -D 标志来接收外部动态参数。

env: str = option("env") or "dev"  # The attribute `env` has a default value "den"
database: str = option("database")
hosts = {
    dev = "postgres.dev"
    stage = "postgres.stage"
    prod = "postgres.prod"
}
dbConfig = {
    host = hosts[env]
    database = database
    port = "2023"
    conn = "postgres://${host}:${port}/${database}"
}
# Use the `-D` flag to input external parameters.
kcl db.k -D database="foo"

输出为

env: dev
database: foo
hosts:
  dev: postgres.dev
  stage: postgres.stage
  prod: postgres.prod
dbConfig:
  host: postgres.dev
  database: foo
  port: "2023"
  conn: "postgres://postgres.dev:2023/foo"

小结​

通过使用 KCL，我们可以生成更低低级别的数据配置。此外，我们通过 -D 标志设置动态参数以满足不同的场景需求。有关更多 KCL 的功能和教程，请参阅此处。