initial commit

api/config-examples.md

@@ -0,0 +1,78 @@
+# Jagacloud Config Examples
+
+## Agent config `/etc/jagacloud/agent.yaml`
+```yaml
+listen_addr: ":8000"
+libvirt_uri: "qemu:///system"
+lxc_path: "/etc/jagacloud/lxc"
+podman_socket: "/run/podman/podman.sock"
+auth_token: "replace-me"
+storage_pools:
+  - name: local-dir
+    type: dir
+    path: /var/lib/jagacloud/images
+  - name: local-lvm
+    type: lvm
+    path: /dev/vg0
+bridges:
+  - name: vmbr0
+    vlan_aware: true
+    mtu: 1500
+```
+
+## VM spec (persisted)
+`/etc/jagacloud/vm/100.yaml`
+```yaml
+id: "100"
+name: "vm-100"
+cpus: 4
+memory_mb: 8192
+disks:
+  - name: root
+    pool: local-lvm
+    size_gb: 40
+    bus: virtio
+nics:
+  - bridge: vmbr0
+    vlan: 10
+    model: virtio
+cloud_init:
+  user: debian
+  ssh_keys:
+    - "ssh-ed25519 AAA... user@host"
+```
+
+## Container spec (persisted)
+`/etc/jagacloud/ct/200.yaml`
+```yaml
+id: "200"
+name: "ct-200"
+unprivileged: true
+limits:
+  cpus: 2
+  memory_mb: 2048
+template: "debian-bookworm"
+rootfs:
+  pool: local-dir
+  size_gb: 10
+nics:
+  - bridge: vmbr0
+    vlan: 20
+```
+
+## Network bridge (systemd-networkd snippet)
+`/etc/jagacloud/network/vmbr0.netdev`
+```ini
+[NetDev]
+Name=vmbr0
+Kind=bridge
+```
+
+`/etc/jagacloud/network/vmbr0.network`
+```ini
+[Match]
+Name=vmbr0
+
+[Network]
+VLANFiltering=yes
+```