89f5d94591
=== Breaking changes - Rust API: `VrfConfig.table_id` changed `u32` to `Option<u32>`.(2900bf5e) - Rust API: Use Box to wrap Interface enum entries. (5d5319ca) === New features - Add 802.1x PEAP auth. (f43657da) === Bug fixes - nm: Fix incorrect device-reapply call. (b1255c3d, 19e60c17) - nm: Change unknown device state log to debug. (20d72e7e) - nm: send lldp with correct D-Bus type INT32. (35557b0d) - gen_diff: Include context information for `gen_diff()`. (c34563d9) - gen_diff: Use original desired interface when creating new interface. (ee8c8a26) Signed-off-by: Gris Ge <fge@redhat.com>
Nmstate: A Declarative Network API
A declarative network management API for hosts.
Copr build status, all repos are built for Fedora Linux and RHEL/CentOS Stream/EPEL 8+:
- Latest release:
- Git base:
Nmstate is a library with an accompanying command line tool that manages host networking settings in a declarative manner. The networking state is described by a pre-defined schema. Reporting of current state and changes to it (desired state) both conform to the schema.
Nmstate is aimed to satisfy enterprise needs to manage host networking through a northbound declarative API and multi provider support on the southbound. NetworkManager acts as the main (and currently the only) provider supported.
Nmstate provides:
- Rust crate -- nmstate
- Command line tools --
cargo install nmstatectl - Python library --
libnmstate - Go binding
- C binding
More document could be found at nmstate.io
The codes of nmstate are licensed under Apache 2.0
except the test codes in tests folder are licensed under
LGPL 2.1+
State example:
Desired/Current state example (YAML):
---
dns:
config:
server:
- 192.0.2.1
search:
- example.org
routes:
config:
- destination: 0.0.0.0/0
next-hop-interface: eth1
next-hop-address: 192.0.2.1
interfaces:
- name: eth1
type: ethernet
description: Main-NIC
state: up
ipv4:
enabled: true
dhcp: false
address:
- ip: 192.0.2.9
prefix-length: 24
ipv6:
enabled: false
Contact
Nmstate GitHub Issues pages for discussion.
Matrix room: #nmstate:fedora.im
Contributing
Yay! We are happy to accept new contributors to the Nmstate project. Please follow these instructions to contribute.
Installation
For Fedora 29+, sudo dnf install nmstate.
For other distribution, please see the install guide.
Documentation
- Rust crate
- libnmstate API
- Code examples
- State examples
- nmstatectl user guide
- nmstatectl man page:
man nmstatectl
Changelog
Please refer to CHANGELOG