Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/wobcom/cosmo
a fairly odd fairy to generate network configuration from Netbox
https://github.com/wobcom/cosmo
Last synced: 26 days ago
JSON representation
a fairly odd fairy to generate network configuration from Netbox
- Host: GitHub
- URL: https://github.com/wobcom/cosmo
- Owner: wobcom
- License: mit
- Created: 2023-01-17T12:06:52.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-04-30T20:57:34.000Z (8 months ago)
- Last Synced: 2024-05-01T19:38:59.632Z (8 months ago)
- Language: Python
- Size: 84 KB
- Stars: 4
- Watchers: 4
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE.md
Awesome Lists containing this project
- awesome-netbox - wobcom/cosmo - Cosmo is another fairy that converting Netbox data into input data for our (wobcom) templating solution (Inspirations)
README
# Cosmo
Cosmo is another fairy that converting Netbox data into input data for our templating solution.
The output is quite specific to our setup and automation stack, so consider it not a solution, more an inspiration.
## Output
We generate a file for each device - configured in cosmo.yaml - with our needed values.
Also, we generate a device manifest with values which may be interesting for all devices.
### Device Values
This contains three different variables, which are going to be included in our Ansible solution.
It contains `junos__device_model` which tells us the Juniper model and the base configuration, i.e. port speed.
Also, it contains `junos__generated_interfaces` which contains all information to render the list of interfaces.
Furthermore, it generates a `junos__generated_routing_instances` containing all information for Junos Routing Instances.
Our Ansible playbook merges the `junos__generated*` values with the group variables and host variables to be able to do overrides and
additional, very specific config. We add e.g. ISIS addresses manually, because we haven't found a good representation in Netbox yet.
### Device Manifest
TBD.
## Getting started
### Setup
If you are using Nix as a package manager you can start right away using the included `flake.nix` file.
For everyone else:
- Install Python3 packages listed in `requirements.txt`
- `pip3 install -r requirements.txt`
### Usage
#### Configuration File
cosmo needs a `cosmo.yml` to make sure that it only fetches the correct devices.
`cosmo.example.yaml` provides an example configuration.
#### Environment Variables
You need to specify the Netbox instance, which should be used. Also, you need to provide an API token.
Make sure, that this API token is only eligible to read from Netbox, we do not need write access.
An API token can be obtained in your Netbox instance: `https://$URL/user/api-tokens/`
```shell
export NETBOX_URL=https://your-netbox.example.com
export NETBOX_API_TOKEN=abc123
```
#### Generating Variables
Cosmo can be used by simply calling the following command to regenerate all files in geneated_variables.
Note: **It will only consider devices listed in `cosmo.yaml`**
```shell
$ cosmo
Fetching information from Netbox, make sure VPN is enabled on your system.
Info: Generating router1
Info: Generating router2
```
##### Limit Mode
We are also able to regenerate sessions/filters for one router only. This can be used, if no full rollout is neccessary. You can add a list of hosts that should be generated, calling --limit multiple times or adding multiple hostnames split by comma. If this list ist omitted, the full config is generated. This flag can be combined with fast mode.
```
cosmo --limit=router2
```
## Authors
+ Ember Keske
+ Johann Wagner
+ Fiona Weber
## License
See `LICENSE.md`