配置

配置 #

本文档将指导您如何配置 kwok/kwokctl 选项。

入门 #

要进行配置,您需要创建一个 YAML 配置文件。此文件遵循 Kubernetes 的版本约定等。

一个最小的有效配置文件如下所示

kind: KwokConfiguration
apiVersion: config.kwok.x-k8s.io/v1alpha1
options:
---
kind: KwokctlConfiguration
apiVersion: config.kwok.x-k8s.io/v1alpha1
options:

此配置指定我们正在配置 kwok/kwokctl,并且我们正在使用的配置版本是 v1alpha1 (apiVersion: config.kwok.x-k8s.io/v1alpha1)。

不同的版本可能支持不同的选项和行为,这就是我们必须始终指定版本的原因。此机制受 Kubernetes 资源和组件配置的启发。

要使用此配置,请将内容放在文件 ~/.kwok/kwok.yaml 中,或使用 --config=kwok.yaml 从同一目录运行命令。

配置类型的结构由 Go 结构定义,该结构在此处 描述

有关 CLI 标志、环境变量和配置文件的说明 #

使用以下优先级顺序。每个项目优先于其下方的项目

  1. 在命令行上指定的标志
  2. 环境变量(前缀为 KWOK_
  3. 在配置文件 --config= 中指定的值
  4. 基本配置文件 ~/.kwok/kwok.yaml
  5. 默认值

使用 kwok #

使用 kwok 时,它从配置文件获取其配置,并忽略所有其他配置。

使用 kwokctl #

使用 kwokctl 时,它从配置文件获取其配置,并将配置文件传递给 kwok