← Back to team overview

group.of.nepali.translators team mailing list archive

[Bug 1664702] Re: No documented way to pass in bond or bridge paramters

 

Should have been marked Fix Released for Zesty too.

** Changed in: nplan (Ubuntu)
       Status: New => Fix Released

-- 
You received this bug notification because you are a member of नेपाली
भाषा समायोजकहरुको समूह, which is subscribed to Xenial.
Matching subscriptions: Ubuntu 16.04 Bugs
https://bugs.launchpad.net/bugs/1664702

Title:
  No documented way to pass in bond or bridge paramters

Status in netplan:
  Fix Released
Status in nplan package in Ubuntu:
  Fix Released
Status in nplan source package in Xenial:
  Fix Committed

Bug description:
  [Impact]
  Documentation is important for users to know how to write the required configuration file for bond or bridge device parameters.

  [Test case]
  - Run nplan integration tests on the release
  - Validate that netplan generate && netplan apply alone, without config, behave as expected (no result)
  - Validate that netplan generate && netplan apply with minimal config writes /run/NetworkManager/conf.d/10-globally-managed-devices.conf
  - Validate that netplan generate && netplan apply works with any existing configuation.
  - Validate that documentation shipped with netplan includes information about the allowed parameters for bond and bridge devices (see /usr/share/doc/netplan/netplan.html)

  [Regression potential]
  Any failure to work with existing configuration should be considered a regression. Any new failure of the test suite would be a regression.

  ---

  According to the current documentation[1], there is no way to set bond
  or bridge parameters. This is a requirement for the MAAS use case.

  MAAS passes these parameters in the v1 YAML the same way as they are
  represented in /etc/network/interfaces[2], inside a 'params'
  dictionary. This allows interface type specific settings such as
  spanning-tree and bonding modes to be specified, such as:

  br0:
    params:
      bridge_stp: on
  ...
  bond0:
    params:
      bond-mode: 4

  (Note the quirk there with '-' being used for the bond and '_' for the
  bridge; this is due to to an inconsistency regarding the /e/n/i
  syntax.)

  I'm tentatively thinking of passing them in the same way, to prevent
  information loss. But perhaps this could be standardized; a 'params'
  dictionary could be used for generic OS or renderer-specific settings
  where there is no guarantee of support, but netplan could standardize
  commonly-used settings and present them in an "official" after they
  each parameter has been fully specified.

  [1]:
  https://git.launchpad.net/netplan/tree/doc/netplan.md

  [2]:
  https://wiki.debian.org/NetworkConfiguration

To manage notifications about this bug go to:
https://bugs.launchpad.net/netplan/+bug/1664702/+subscriptions