关于 range-config
range-config 帮助构建有效的 Ludus YAML 配置，并解释拓扑、网络和角色设计的取舍。它强调模式验证、服务器模板与 Ansible 依赖检查，以及分步完善配置。
主要功能
- 01指导定义虚拟机与角色
- 02使用模式头验证 YAML
- 03检查模板及 Ansible 依赖
- 04说明网络与测试规则设计
- 05提示主机名、VLAN 等约束
适用场景
- 01为目标环境编写范围配置
- 02检查 VLAN 和 IP 地址设置
- 03部署前核对角色与模板是否可用
安装
复制下面的命令，在终端中运行。
$
npx skills add https:/安装后在 Claude Code 中输入/range-config确认已加载。
附带文件agents/openai.yamlreferences/schema.md
详细介绍
Ludus 范围配置
使用此技能构建安全、有效的 Ludus YAML 配置，并说明拓扑、网络和角色设计方面的权衡。
关键原则
-
始终建议在配置顶部添加 YAML 架构验证标头：
# yaml-language-server: $schema=https://docs.ludus.cloud/schemas/range-config.json -
在 vm_name 和 hostname 字段中使用
{{ range_id }}模板字符串。此字符串会解析为用户的范围 ID（例如，“JS”）。 -
Windows 主机名最多只能有 15 个字符，这是 NETBIOS 的限制。
-
VLAN 必须为 2-255，并作为 VM IP 地址的第三个八位组（例如，vlan 10 = 10.X.10.Y）。
-
同一 VLAN 中的 ip_last_octet 必须唯一。
-
Linux VM 设置
linux: true，Windows VM 使用windows:键，macOS VM 设置macOS: true。 -
域角色包括：
primary-dc、alt-dc或member。 -
role_vars 必须是字典——不要在变量前加连字符。
-
部署前，服务器上必须已存在相应角色——验证已安装的角色，并添加缺少的角色。
工作流程
- 明确目标环境和预期用途。
- 确定所需的 VM 和角色。
- 验证服务器上是否有可用的所需模板。
- 分步骤构建或修改 YAML，每次只做少量且有效的改动。
- 根据场景提出适当的网络规则和测试行为。
- 验证所需的 Ansible 角色/集合是否已安装；建议添加缺少的角色/集合。
- 根据架构参考验证结构和值。
参考资料
- 使用
references/schema.md查看完整的架构详情、有效值、默认值和完整示例。 - 使用
https://docs.ludus.cloud/docs/configuration查看官方配置指南。 - 使用
https://docs.ludus.cloud/schemas/range-config.json进行基于架构的验证。
评论
支持 Markdown