sylve_manual_switch (Resource)

A Sylve manual network switch: a plain bridge interface with no physical port bound to it. Safe to create/destroy on any host, unlike a “standard” switch (not covered by this provider) which requires binding a real physical NIC and can sever connectivity on a single-NIC host – see the provider’s dev notes. VMs/jails reference this by name via their own switch_name attribute.

Example Usage

# A named label on an already-existing bridge interface -- Sylve does
# NOT create the bridge itself (unlike a "standard" switch, which this
# provider deliberately doesn't implement, see the README). Create the
# bridge out of band first, e.g.:
#   ssh sylve-host 'ifconfig bridge10 create'
resource "sylve_manual_switch" "lan" {
  name   = "lan"
  bridge = "bridge10"
}

Schema

Required

  • bridge (String) Underlying FreeBSD bridge interface name, e.g. “bridge10”. Immutable, same reason as name.
  • name (String) Switch name, referenced by VM/jail switch_name attributes. Immutable: Sylve’s API has no update endpoint for manual switches (only create/delete), so changing this recreates the resource.

Read-Only

  • id (String) Terraform resource identity – the switch’s numeric ID as a string.

Not published on the Terraform Registry yet -- see the repo's README for local dev_overrides usage in the meantime.

This site uses Just the Docs, a documentation theme for Jekyll.