pve_ceph_init
Initialize default Ceph configuration on a Proxmox node. Dry-run returns a plan; confirm=True executes the setup.
Instructions
MUTATION: create the initial Ceph default configuration and set up symlinks on a node.
RISK_MEDIUM: one-time cluster-bootstrap step. IDEMPOTENT on re-call (schema truth): if a [global] section already exists in ceph.conf, the existing fsid/auth/pool defaults are preserved and most parameters here are silently ignored — this is NOT guaranteed to apply the options above on a re-call. No CAPTURE possible — no 'current Ceph init state' read exists; idempotent re-call is itself the safety net. Dry-run by default (returns a PLAN); confirm=True executes (POST /nodes/{node}/ceph/init) and returns {"status": "ok"| "submitted", "result": None}. No rollback primitive on this plane.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| node | No | PVE node to initialize; defaults to the configured node if omitted. | |
| size | No | Targeted number of replicas per object (1-7, default 3). | |
| confirm | No | False (default) returns a dry-run PLAN only; True executes the init. | |
| network | No | Network (CIDR) to use for all Ceph-related traffic. | |
| pg_bits | No | Placement-group bits (6-14, default 6). Deprecated in recent Ceph versions. | |
| min_size | No | Minimum number of available replicas per object to allow I/O (1-7, default 2). | |
| disable_cephx | No | Disable cephx authentication. WARNING: cephx protects against man-in-the-middle attacks; only consider disabling on a private network. | |
| proximo_target | No | Which configured Proxmox target to run this call against — a target name from your multi-target config (a specific PVE/PBS/PMG/PDM box). Omit to use the single/default target from the environment; the selection applies only to this call. | |
| cluster_network | No | Separate cluster network (CIDR) for OSD heartbeat/replication/recovery traffic; REQUIRES network to also be set. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |