range-config について
range-config は、有効な Ludus YAML 設定の作成と、トポロジー、ネットワーク、ロール設計の選択肢の説明を支援します。スキーマ検証、サーバー上のテンプレートと Ansible 依存関係の確認、段階的な設定作成を重視します。
主な機能
- 01VM とロールの定義支援
- 02スキーマヘッダーによる YAML 検証
- 03テンプレートと Ansible 依存関係の確認
- 04ネットワークとテストルールの設計説明
- 05ホスト名や VLAN などの制約提示
活用シーン
- 01対象環境向けの範囲設定作成
- 02VLAN と 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 のホスト名は、NETBIOS の制限により 15 文字までです。
-
VLAN は 2〜255 にする必要があり、VM の IP アドレスの第 3 オクテットになります（例：vlan 10 = 10.X.10.Y）。
-
ip_last_octet は、同一 VLAN 内で一意である必要があります。
-
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を使用してください。