diff --git a/CLAUDE.md b/CLAUDE.md index 837a875..5530611 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -28,9 +28,12 @@ incu-contrib/ └── notes/ # Research notes and reference material ├── clustering-guide.md # Detailed Incus clustering walkthrough ├── operations-center-guide.md # Operations Center provisioning & management - ├── networking-guide.md # OVN overlay networking tutorial (bridge + OVN + LAN) + ├── networking-guide.md # OVN overlay networking tutorial (bridge + OVN + LAN) ├── shared-storage-guide.md # iSCSI + lvmcluster shared storage (tested) + ├── production-lab-guide.md # Manual cluster + OVN + HA (validated end-to-end) ├── migration-guide.md # Migration paths into Incus from other hypervisors + ├── incus-version-compatibility.md # Incus versions across platforms + ├── iso-download-methods.md # ISO download/customization research └── utm-support.md # UTM support design document (future) ``` diff --git a/README.md b/README.md index 002d58d..af6a6db 100644 --- a/README.md +++ b/README.md @@ -27,19 +27,22 @@ See [`incusos/README.md`](incusos/README.md) for full documentation. ### [`notes/`](notes/) -Research notes and reference material: +Guides and reference material (roughly in learning order): -- [`incus-version-compatibility.md`](notes/incus-version-compatibility.md) -- - Incus package versions across platforms (macOS, Debian/Ubuntu, Arch), - install instructions, and certificate management notes. -- [`iso-download-methods.md`](notes/iso-download-methods.md) -- - Original research on ISO download/customization approaches. - [`clustering-guide.md`](notes/clustering-guide.md) -- Detailed Incus clustering walkthrough (manual cluster formation via remotes). - [`operations-center-guide.md`](notes/operations-center-guide.md) -- Operations Center provisioning, cluster management, and tested limitations. +- [`networking-guide.md`](notes/networking-guide.md) -- + OVN overlay networking tutorial (bridge + OVN + LAN access). +- [`shared-storage-guide.md`](notes/shared-storage-guide.md) -- + iSCSI + lvmcluster shared storage for instant migration. +- [`production-lab-guide.md`](notes/production-lab-guide.md) -- + Manual cluster + OVN + HA workloads (validated end-to-end). - [`migration-guide.md`](notes/migration-guide.md) -- Migration paths into Incus from Proxmox, UTM, VMware Fusion, and Docker. +- [`incus-version-compatibility.md`](notes/incus-version-compatibility.md) -- + Incus package versions across platforms and install instructions. - [`utm-support.md`](notes/utm-support.md) -- Design document for future UTM support on macOS. diff --git a/incusos/README.md b/incusos/README.md index 4e3a6a6..4275c84 100644 --- a/incusos/README.md +++ b/incusos/README.md @@ -656,19 +656,31 @@ openssl pkcs12 -export \ See the [`examples/`](examples/) directory for sample seed configurations: +**Seed templates:** + - [`incus-standalone.yaml`](examples/incus-standalone.yaml) -- Single Incus server with defaults - [`incus-cluster-node.yaml`](examples/incus-cluster-node.yaml) -- Cluster node (no defaults) - [`ops-center.yaml`](examples/ops-center.yaml) -- Operations Center - [`network-static.yaml`](examples/network-static.yaml) -- Static network configuration + +**Proxmox connection:** + - [`proxmox.yaml.example`](examples/proxmox.yaml.example) -- Proxmox connection config template -- [`proxmox-lab.yaml`](examples/proxmox-lab.yaml) -- Proxmox: 4-VM lab (self-contained, includes proxmox: section) -- [`proxmox-minimal.yaml`](examples/proxmox-minimal.yaml) -- Proxmox: single standalone VM (self-contained) -- [`lab-cluster.yaml`](examples/lab-cluster.yaml) -- Proxmox: 3-node cluster (uses proxmox.yaml) -- [`lab-single.yaml`](examples/lab-single.yaml) -- Proxmox: single standalone node (uses proxmox.yaml) -- [`lab-advanced.yaml`](examples/lab-advanced.yaml) -- Proxmox: 3-node heterogeneous migration cluster -- [`lab-oc.yaml`](examples/lab-oc.yaml) -- Proxmox: Operations Center + 3 nodes (uses proxmox.yaml) -- [`lab-oc-deploy.yaml`](examples/lab-oc-deploy.yaml) -- Proxmox: OC server only (for hybrid OC workflow) -- [`lab-oc-nodes.yaml`](examples/lab-oc-nodes.yaml) -- Proxmox: 3 OC-managed nodes (requires `--iso`) + +**Lab configs (Proxmox deployment):** + +- [`proxmox-lab.yaml`](examples/proxmox-lab.yaml) -- 4-VM lab (self-contained, includes proxmox: section) +- [`proxmox-minimal.yaml`](examples/proxmox-minimal.yaml) -- Single standalone VM (self-contained) +- [`lab-single.yaml`](examples/lab-single.yaml) -- Single standalone node (uses proxmox.yaml) +- [`lab-cluster.yaml`](examples/lab-cluster.yaml) -- 3-node cluster (uses proxmox.yaml) +- [`lab-advanced.yaml`](examples/lab-advanced.yaml) -- 3-node heterogeneous migration cluster +- [`lab-production.yaml`](examples/lab-production.yaml) -- Production-like cluster (OVN + HA) +- [`lab-replace.yaml`](examples/lab-replace.yaml) -- Node replacement testing +- [`lab-networking.yaml`](examples/lab-networking.yaml) -- OVN networking lab +- [`lab-oc.yaml`](examples/lab-oc.yaml) -- Operations Center + 3 nodes (uses proxmox.yaml) +- [`lab-oc-deploy.yaml`](examples/lab-oc-deploy.yaml) -- OC server only (for hybrid OC workflow) +- [`lab-oc-nodes.yaml`](examples/lab-oc-nodes.yaml) -- 3 OC-managed nodes (requires `--iso`) +- [`lab-iscsi-target.yaml`](examples/lab-iscsi-target.yaml) -- iSCSI target reference config ## Platform Support