Skip to content

Commit

Permalink
Updating readme
Browse files Browse the repository at this point in the history
  • Loading branch information
bl4ko committed Feb 7, 2024
1 parent 23910a5 commit 2b2f9d4
Showing 1 changed file with 13 additions and 8 deletions.
21 changes: 13 additions & 8 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,16 +1,25 @@
# Netbox-SSOT

Netbox-ssot is a tool to keep Netbox in sync with external data sources.
Netbox-ssot is a tool to keep Netbox in sync with external data sources.
It is designed to be run as a cronjob, and will periodically update Netbox
with the latest data from the external sources.

Currently the supported external data sources types are:
Currently, the supported external data sources types are:

- `ovirt`
- `vmware`
- `dnac`

> :warning: **This project is under heavy development, use with caution.**
## Configuration

Example config can be found in [example section](#example-config)
Netbox-ssot is configured via a single yaml file.
The configuration file is divided into three sections:

- [`logger`](#logger): Logger configuration
- [`netbox`](#netbox): Netbox configuration
- [`source`](#source): Array of configuration for each data source

### Logger

Expand All @@ -19,7 +28,6 @@ Example config can be found in [example section](#example-config)
| `logger.level` | Log level | int | 0-3 | 1 | Yes |
| `logger.dest` | Log output filename. Default `""` representing stdout. | str | Any valid path | "" | No |


### Netbox

| Parameter | Description | Type | Possible values | Default | Required |
Expand Down Expand Up @@ -58,9 +66,6 @@ Example config can be found in [example section](#example-config)
| `source.vlanTenantRelations` | Regex relations in format `regex = tenantName`, that map each vlan that satisfies regex to tenant | []string | any | [] | no |
| `source.customFieldMappings` | Mappings of format `customFieldName = option`. Currently supported options are `contact`, `owner`, `description` | []string | any | [] | no |

#### Vcenter specific


### Example config

```yaml
Expand Down Expand Up @@ -103,7 +108,7 @@ Create k8s secret from self defined config.yaml:
kubectl create secret generic netbox-ssot-secret --from-file=config.yaml
```

Apply [cronjob](cronjob.yaml) with custom settings:
Apply [cronjob](./k8s/cronjob.yaml) with custom settings:

```yaml
kubectl apply -f cronjob.yaml
Expand Down

0 comments on commit 2b2f9d4

Please sign in to comment.