mirror of
https://github.com/Telecominfraproject/olg-ucentral-schema.git
synced 2026-03-20 03:39:23 +00:00
a37f8ccfa0
When VyOS applies configuration via /config-file load operation, empty ethernet interface blocks cause the interfaces to go Admin Down, breaking bridge connectivity and all networking. This fix adds a description field to ethernet interface configuration, providing minimal but valid configuration that keeps interfaces operational during config load operations. Tested on MS-01 with multi-VLAN configuration - all interfaces and bridges remain up (u/u) after configuration application. Signed-off-by: Mike Hansen <mike.hansen@netexperience.com>
uCentral Schema
Collection of JSON schemas and ucode template (utpl) files used by uCentral for validating the data model and rendering incoming configuration JSON into UCI batch sequences.
This software is a part of the OpenWiFi AP NOS.
Building
Dependencies
In order to run the test cases you will need the following tools:
- ucode
- ucentral-jsonschema
- jsonlint-php
- pip3 install jsonschema2md
- pip3 install json-schema-for-humans
- pip3 install python-json2yaml
Unit testing
./run_tests.sh
Documentation
JSDoc is used to generate API documentation
with a ucode transpiler (ucode-transpiler.js), configured by jsdoc.conf.json.
Additional JSON schema docs are generated using
json-schema-for-humans via
the script generate.sh.
Developer Notes
Generated documentation
- JSDoc: https://ucentral.io/docs/
schemaobject: http://ucentral.io/docs/ucentral-schema.htmlstateobject: https://ucentral.io/docs/ucentral-state.html
Installed files
The following ucode scripts are installed to the AP:
schemareader.uc- autogenerated schema readerrenderer/*- renderer sources and templatescommand/*- predefined command implementations, e.g. invoked by ucentral-clientsystem/*- scripts to generate system information (e.g. state, telemetry, health, capabilities)