spiro-network

Compatibility

Salt Version Linux Windows macOS
master 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9
v3002.7 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9
v3003.3 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9
v3004 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9 3.5 3.6 3.7 3.8 3.9

Description

spiro-network

A variety of network utilities.

This is meant to be installed on minions.

Full docs available online.

Installation

On minions, install the spiro-network PyPI package.

Interface

A number of things are provided:

Modules

  • ipaddr.external_four, ipaddr.external_six: Queries external services for your IP, useful if the minion is behind a NAT or other complex network

  • ipaddr.four, ipaddr.six: Collates information about a minion’s IP address from several sources.

    • network.ipaddrs / network.ipaddrs6

    • AWS metadata if the metadata grain is available

    • ipaddr.external_four / ipaddr.external_six (above)

States

  • hostname.is: Sets the hostname, takes no arguments. (Note: See hostname(1) for information on FQDNs and other hostname variants.)

Configuration

spiro-network requires no configuration to function.