l8k 是 k8s-launch-kit 的命令行工具,本条目为其共享参考,涵盖二进制定位、全局标志、输出格式、退出码与错误处理。
用途与命令:l8k discover 发现集群硬件并生成 cluster-config.yaml;l8k generate 依据配置与 profile 生成 Kubernetes YAML(可用 --for <preset> 跳过已知 SKU 的集群发现);l8k deploy 应用清单并安装或升级 Network Operator Helm release;l8k clean 删除 Network Operator 自定义资源并卸载 Helm release;l8k validate 校验 Helm release、清单、组件版本与连通性;l8k preset list/update 列出或下载拓扑预设;l8k sosreport 收集诊断信息;l8k schema 以 JSON 列出全部能力;l8k version 打印版本。根命令 l8k --discover-cluster-config ... 仍可用于向后兼容的完整流水线。
安装与定位:源码开发在仓库根执行 make build,随后使用 ./build/l8k;安装可选,make install 复制二进制与资源,make dev-install 将资源链接进源码树,二者均使用 scripts/install-local.sh。安装后二进制位于 /usr/local/bin/l8k,模板位于 /usr/local/share/l8k/profiles/。已安装 CLI 用 command -v l8k 定位;源码开发不要用无关的已安装二进制替代。
常用标志:--target <NAME>(默认 host,dpf 保留但未实现)、--kubeconfig、--user-config、--output text|json、--yes/-y(仅根命令)、--quiet/-q、--log-level、--network-operator-namespace、--network-namespaces、--node-selector、--image-pull-secrets、--skip-network-operator-helm 等。--yes 与 --quiet 仅根命令可用;--deploy-timeout 属于根/独立 deploy;--overwrite-existing 属于 generate/独立 deploy。
退出码:0 成功;1 一般错误;2 校验错误;3 集群错误;4 部署错误;5 部分成功。JSON 模式下错误以结构化对象输出,含 code、message、category、transient、suggestion。
限制:dpf 目标未实现,不要尝试 DPF 配置;clean 无 dry-run;发现与连通性检查会创建集群资源;不得在输出中暴露凭据或 kubeconfig 内容。其余细节暂未提供。