Technology · Ebook

NMState: Declarative Host Networking

by Shriira Press

NMState is a library and command-line tool that manages a host's network declaratively: you describe the interfaces, addresses, routes, and DNS you want as a YAML or JSON document, and nmstatectl drives NetworkManager to make the system match it — verifying the result and rolling back automatically if anything goes wrong. This book moves from the pain of imperative network commands to NMState's desired-state model and schema, the checkpoint-and-rollback transaction that makes remote changes safe, and the catalogue of interface types from bonds to bridges. It then crosses into Kubernetes, where kubernetes-nmstate exposes the same engine through the NodeNetworkConfigurationPolicy, NodeNetworkConfigurationEnactment, and NodeNetworkState custom resources, and closes with the operational habits that keep declarative networking dependable in production.

Contents

1. 1Preface
2. 2Chapter 1 — The Trouble with Configuring Networks
3. 3Chapter 2 — The Desired-State Model
4. 4Chapter 3 — The State Schema
5. 5Chapter 4 — Verification, Checkpoints, and Rollback
6. 6Chapter 5 — Interface Types and Real Topologies
7. 7Chapter 6 — NMState on Kubernetes
8. 8Chapter 7 — NMState in Practice