289138da94
TIL! Using the existence of obscure member sys._MEIPASS, I can detect if we're running from a bundled PyInstaller binary, versus running from Python directly. Add schema.yaml to the datas of the PyInstaller spec. Then, if the -/--schema flag is given, use it, and if it's not given, default to the built-in one if we're running from a bundled binary, or fall-through to ./schema.yaml in other cases. This avoids the need for config/schema.py as a carbon-copy of the schema, slick!
60 lines
2.0 KiB
Markdown
60 lines
2.0 KiB
Markdown
# A VPP Configuration Utility
|
|
|
|
This tool reads a configuration file, checks it for syntax and semantic correctness, and then
|
|
reconciles a running [VPP](https://fd.io/) daemon with its configuration. It is meant to be
|
|
re-entrant and stateless. The tool connects to the VPP API and creates/removes all of the
|
|
configuration in a minimally intrusive way.
|
|
|
|
***NOTE*** This code is under development, and probably won't work well until this note is removed.
|
|
If you're interested in helping, reach out to <pim at ipng dot ch> to discuss options.
|
|
|
|
## Building
|
|
|
|
This program expects Python3 and PIP to be installed. It's known to work on OpenBSD and Debian.
|
|
|
|
```
|
|
sudo pip3 install argparse
|
|
sudo pip3 install yamale
|
|
sudo pip3 install pyyaml
|
|
sudo pip3 install pyinstaller
|
|
|
|
## Ensure all unittests pass.
|
|
./tests.py -d -t unittest/yaml/*.yaml
|
|
|
|
## Build the tool
|
|
pyinstaller vppcfg.spec --onefile
|
|
dist/vppcfg -h
|
|
```
|
|
|
|
## Running
|
|
|
|
```
|
|
usage: vppcfg [-h] [-d] [-q] [-f] {check,dump,plan,apply} ...
|
|
|
|
positional arguments:
|
|
{check,dump,plan,apply}
|
|
check check given YAML config for validity (no VPP)
|
|
dump dump current running VPP configuration (VPP readonly)
|
|
plan plan changes from current VPP dataplane to target config (VPP readonly)
|
|
apply apply changes from current VPP dataplane to target config
|
|
|
|
optional arguments:
|
|
-h, --help show this help message and exit
|
|
-d, --debug enable debug logging, default False
|
|
-q, --quiet be quiet (only warnings/errors), default False
|
|
-f, --force force progress despite warnings, default False
|
|
|
|
Please see vppcfg <command> -h for per-command arguments
|
|
```
|
|
|
|
## Documentation
|
|
|
|
Main user-focused documentation:
|
|
* [YAML Configuration Guide](docs/config-guide.md)
|
|
* [User Guide](docs/user-guide.md)
|
|
|
|
Developer deep-dives:
|
|
* [Validation](https://ipng.ch/s/articles/2022/03/27/vppcfg-1.html)
|
|
* [Path Planning](https://ipng.ch/s/articles/2022/04/02/vppcfg-2.html)
|
|
* [Design - Reconciliation](docs/design.md)
|