Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/networkop/cvp-netsim

Last synced: 11 days ago
JSON representation

Host: GitHub
URL: https://github.com/networkop/cvp-netsim
Owner: networkop
Created: 2019-03-14T09:37:41.000Z (over 5 years ago)
Default Branch: master
Last Pushed: 2022-01-15T16:48:27.000Z (almost 3 years ago)
Last Synced: 2024-10-10T23:49:15.886Z (about 1 month ago)
Language: Python
Size: 277 KB
Stars: 3
Watchers: 4
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md

Awesome Lists containing this project

README

# cvp-netsim
A script that creates [k8s-topo][k8s-topo] (and [docker-topo][docker-topo]) compliant topology and configuration files (artefacts) based on the information extracted from Arista CloudVision Portal (CVP)

![](cvp-netsim.png)

## Installation

No installation needed, just clone this repository

```bash
git clone https://github.com/networkop/cvp-netsim.git && cd cvp-netsim
```

## Usage

```
./ingest.py -h
usage: ingest.py [-h] [-d] [-i] [-f FILTER] [-v] cvp user pwd

Tool to ingest topology information from CVP

positional arguments:
cvp CVP address
user CVP username
pwd CVP password

optional arguments:
-h, --help show this help message and exit
-d, --debug Enable Debug
-i, --ignore Ignore 3rd party devices
-f FILTER, --filter FILTER
Match specified string in hostnames
-v, --veos Produce artefacts for vEOS
```

## Example 1

Create artefacts for cEOS-based topology

```
/ingest.py localhost:9443 cvpadmin cvpadmin1
```

## Example 2

Create artefacts for containerised vEOS topology only for devices that have "dc1" in their hostname

```
./ingest.py -f dc1 -v localhost:9443 cvpadmin cvpadmin1
```

## How to use with k8s-topo

> Assuming that the kubernetes cluster already has [meshnet-cni][meshnet-cni] and [k8s-topo][k8s-topo] installed

Copy the archived artefacts to the machine with k8s cluster credentials

```
scp cvp_topology.tar.gz k8s-lab-node-1:/home/core
```

From that machine, copy the artefacts into the `k8s-topo` pod

```
kubectl cp /home/core/cvp_topology.tar.gz k8s-topo:/
```

From inside the `k8s-topo` pod, extract the artefacts into a dedicated directory

```
rm -rf ./lab && mkdir -p ./lab
tar zxvf /cvp_topology.tar.gz -C lab
```

Assuming the required docker image is already [uploaded to docker registry][veos-image], update the custom image mapping to chose the correct docker image based on a common string in devices hostnames

```
grep -A 1 custom_image lab/cvp_topology.yml
custom_image:
dc1: "10.1.1.1:5000/veos:latest"
```

Otherwise, to use cEOS, set the `CEOS_IMAGE` environment variable (also assuming the image has been [pre-uploaded][ceos-image]):

```
export CEOS_IMAGE=$(kubectl get service docker-registry -o json | jq -r '.spec.clusterIP'):5000/ceos:4.21.5F
```

Create the topology with `k8s-topo`

```
./bin/k8s-topo --create lab/cvp_topology.yml
INFO:__main__:All data has been uploaded to etcd
INFO:__main__:All pods have been created successfully
```

Check that devices have been created

```
kubectl get pods
NAME
etcd0
etcd1
etcd2
internal-docker
k8s-topo
acme-dc1b2001-a
acme-dc1b2001-b
acme-dc1l3001-a
acme-dc1l3001-b
acme-dc1l3002-a
acme-dc1l3002-b
acme-dc1l3003-a
acme-dc1l3003-b
acme-dc1l3004-a
acme-dc1l3004-b
acme-dc1l3005-a
acme-dc1l3005-b
acme-dc1l3006-a
acme-dc1l3006-b
acme-dc1l3007-a
acme-dc1l3007-b
acme-dc1l3008-a
acme-dc1l3008-b
acme-dc1l3009-a
acme-dc1l3009-b
acme-dc1l3010-a
acme-dc1l3010-b
acme-dc1l3011-a
acme-dc1l3011-b
acme-dc1l3012-a
acme-dc1l3012-b
acme-dc1l3013-a
acme-dc1l3013-b
acme-dc1l3014-a
acme-dc1l3014-b
acme-dc1l3015-a
acme-dc1l3015-b
acme-dc1l3016-a
acme-dc1l3016-b
acme-dc1l3017-a
acme-dc1l3017-b
acme-dc1l3018-a
acme-dc1l3018-b
acme-dc1l3019-a
acme-dc1l3019-b
acme-dc1l3020-a
acme-dc1l3020-b
acme-dc1l3021-a
acme-dc1l3021-b
acme-dc1l3022-a
acme-dc1l3022-b
acme-dc1l3023-a
acme-dc1l3023-b
acme-dc1l3024-a
acme-dc1l3024-b
acme-dc1l3025-a
acme-dc1l3025-b
acme-dc1l3026-a
acme-dc1l3026-b
acme-dc1l3027-a
acme-dc1l3028-a
acme-dc1s1001-a
acme-dc1s1001-b
``` READY STATUS RESTARTS AGE 1/1 Running 0 2d12h 1/1 Running 0 2d12h 1/1 Running 0 2d12h -registry-7999859b-fm22v 1/1 Running 0 2d12h 1/1 Running 0 2d12h 1/1 Running 0 3m27s 1/1 Running 0 3m27s 1/1 Running 0 3m29s 1/1 Running 0 3m28s 1/1 Running 0 3m31s 1/1 Running 0 3m27s 1/1 Running 0 3m31s 1/1 Running 0 3m27s 1/1 Running 0 3m30s 1/1 Running 0 3m29s 1/1 Running 0 3m31s 1/1 Running 0 3m30s 1/1 Running 0 3m30s 1/1 Running 0 3m31s 1/1 Running 0 3m28s 1/1 Running 0 3m31s 1/1 Running 0 3m31s 1/1 Running 0 3m30s 1/1 Running 0 3m29s 1/1 Running 0 3m30s 1/1 Running 0 3m31s 1/1 Running 0 3m30s 1/1 Running 0 3m27s 1/1 Running 0 3m29s 1/1 Running 0 3m31s 1/1 Running 0 3m31s 1/1 Running 0 3m30s 1/1 Running 0 3m31s 1/1 Running 0 3m30s 1/1 Running 0 3m28s 1/1 Running 0 3m31s 1/1 Running 0 3m28s 1/1 Running 0 3m30s 1/1 Running 0 3m29s 1/1 Running 0 3m31s 1/1 Running 0 3m29s 1/1 Running 0 3m30s 1/1 Running 0 3m29s 1/1 Running 0 3m31s 1/1 Running 0 3m31s 1/1 Running 0 3m30s 1/1 Running 0 3m28s 1/1 Running 0 3m27s 1/1 Running 0 3m30s 1/1 Running 0 3m31s 1/1 Running 0 3m27s 1/1 Running 0 3m31s 1/1 Running 0 3m28s 1/1 Running 0 3m31s 1/1 Running 0 3m31s 1/1 Running 0 3m28s 1/1 Running 0 3m27s 1/1 Running 0 3m27s 1/1 Running 0 3m31s 1/1 Running 0 3m31s 1/1 Running 0 3m31s 1/1 Running 0 3m27s 1/1 Running 0 3m31s

Connect to a device:

```
kubectl exec -it acme-dc1s1001-a bash
sh-4.2# telnet localhost 23
Trying 127.0.0.1...
Connected to localhost.
Escape character is '^]'.

acme-dc1s1001-a login:
```

[meshnet-cni]: https://github.com/networkop/meshnet-cni
[k8s-topo]: https://github.com/networkop/k8s-topo
[docker-topo]: https://github.com/networkop/docker-topo
[veos-image]: https://github.com/networkop/docker-topo/tree/master/topo-extra-files/veos#uploading-to-docker-registry
[ceos-image]: https://github.com/networkop/k8s-topo#private-docker-registry-setup