Struct Network 

pub struct Network {
    pub cidr: String,
    pub internet: bool,
    pub gateway: Option<String>,
    pub docker: Option<NetworkDocker>,
    pub vlans: IndexMap<u16, Vlan>,
    pub switch: Option<String>,
    pub vlan: Option<(String, u16)>,
    pub tc: Option<Tc>,
    pub ipv6: Option<Ipv6>,
    pub external: Option<String>,
    pub bridged: Option<Bridged>,
    pub mtu: Option<u16>,
}

A network: an address block, whether it reaches the internet, and what routes it.

Fields

cidr: String

The network’s private IPv4 block (inside 10.0.0.0/8, 172.16.0.0/12 or 192.168.0.0/16), a /24 to a /29, e.g. 10.20.0.0/24. A LAN split into vlans may be larger, from /8.

internet: bool

Whether machines on it may reach the internet (default true).

gateway: Option<String>

A machine of the environment that routes this network (an edge firewall): it takes the gateway address, and its own configuration decides what crosses it. Isoloom adds no router of its own here, so reach and internet on this network become expected behavior for the checks to verify.

docker: Option<NetworkDocker>

How the Docker target lays this network out, when it differs from the other targets.

vlans: IndexMap<u16, Vlan>

The VLANs this LAN is split into, by id (1-4094), each with its own block inside the LAN’s. Machines join one as <lan>.vlan<id> (office.vlan10); a reach rule naming the LAN covers all of its VLANs. Each VLAN becomes a network of its own, <lan>-vlan<id>; the LAN itself stays a network only when a machine joins it directly.

switch: Option<String>

On a LAN split into vlans: a switch appliance of the environment (docker.appliance: cisco-iol-l2 or cisco-vios-l2) that switches it, instead of Isoloom’s own Linux switch. Its ports are derived, so the machine lists no networks: an access port per VLAN, then a trunk per machine on several of the LAN’s VLANs. Docker targets only.

vlan: Option<(String, u16)>

Set by parsing on the networks a LAN’s VLANs become: that LAN and the VLAN’s id, so a target can carry them on one 802.1Q segment (a machine on several of them gets a trunk).

tc: Option<Tc>

Link impairment on traffic entering this network through Isoloom’s router (a slow or lossy link): delay, jitter, loss, rate. Needs the router on the network (a reach rule touching it, no gateway machine).

ipv6: Option<Ipv6>

The network’s IPv6 block: dual-stack beside cidr, or IPv6-only (only: true). Machines get an IPv6 address on it (derived from their octet, or handed out by the target) and routes to the other IPv6 blocks the reach rules open.

external: Option<String>

An existing network, by its name on the target (a Docker network, a Proxmox bridge, an ESXi port group): the machines join it, and Isoloom never creates or deletes it. cidr is its block, and the machines keep fixed addresses in it.

bridged: Option<Bridged>

Bridged to an interface of the host, so the machines sit on the host’s own LAN (fixed addresses in cidr, or DHCP from the LAN).

mtu: Option<u16>

The largest packet the network carries, in bytes (576 to 9216): smaller to mimic a tunnel or a VPN link, jumbo frames (9000) for a storage network. A LAN’s VLANs carry the LAN’s. Default: the target’s own (1500 on most).

Implementations

impl Network

pub fn is_outside(&self) -> bool

Whether the network is outside the environment (external or bridged): Isoloom doesn’t make it, route it or put its own machines on it.

pub fn is_dhcp(&self) -> bool

Whether its machines take their address from the LAN’s DHCP server.

Trait Implementations

impl Clone for Network

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Network

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Network

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl JsonSchema for Network

fn schema_name() -> Cow<'static, str>

The name of the generated JSON Schema.

fn schema_id() -> Cow<'static, str>

Returns a string that uniquely identifies the schema produced by this type.

fn json_schema(generator: &mut SchemaGenerator) -> Schema

Generates a JSON Schema for this type.

fn inline_schema() -> bool

Whether JSON Schemas generated for this type should be included directly in parent schemas, rather than being re-used where possible using the $ref keyword.

impl PartialEq for Network

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for Network

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Network