Skip to content

Latest commit

 

History

History
56 lines (45 loc) · 2.26 KB

README.md

File metadata and controls

56 lines (45 loc) · 2.26 KB

Bonding configuration generation

Script

Requirements

  • Python >= 3.7 (rpm: python3)
  • jinja2 (rpm: python3-jinja2)
  • pyyaml (rpm: python3-pyyaml)

Parameters file

  • primary: opens block for Ignition data
    • device: name for the bonding device
    • kernel_options: bonding kernel module parameters
    • phy_devices: array listing the physical devices composing the bond
    • vlans: array listing the VLAN IDs and their network configuration details
  • secondary: opens block for NMState data
    • device: name for the bonding device
    • config: opens block for bonding kernel module parameters
      • mode: bonding mode (active-backup, balance-rr, ...)
      • options: dictionary holding key/value parameters (e.g. miimon: 140)
    • phy_devices: array listing the physical devices composing the bond
    • vlans: array listing the VLAN IDs and their network configuration details
    • routes: opens block for routes configuration
      • dst: route destination
      • metric: route metric
      • gw: route gateway
      • iface: route interface
      • table: routing table ID
    • dns: opens block for DNS resolver data
      • search: array listing DNS domain names for looking up short host names
      • nameservers: array listing IP addresses to be used as DNS servers

Usage

  • The parameters file uses two sections, primary and secondary to define Ignition settings and NMState details respectively

  • The script can generate, both Ignition and NMState configuration files at the same time using -a|--all or independently, using -i|--ignition or -n|--nmstate. It does all by default.

  • Using the parameters example as follows:

    $ scripts/bonding.py -f examples/parameters.yaml.sample -t templates -o /tmp/out -a
    $ ls -la /tmp/out
    total 8
    drwxrwxr-x.   2 sjr  sjr    80 Dec  4 12:28 .
    drwxrwxrwt. 117 root root 2700 Dec  4 12:28 ..
    -rw-rw-r--.   1 sjr  sjr   899 Dec  4 12:28 2160-nmstate-bonding-manifest.yaml
    -rw-rw-r--.   1 sjr  sjr  1562 Dec  4 12:28 8847-ignition-bond.ign

    At this point the two files can be used to inject the configuration into the nodes.