|
@@ -9,73 +9,43 @@
|
|
|
|
|
|
|
|
|
|
|
|
-
|
|
|
It will work with a single VyoS server or to multiple VyOS servers, so datacenters which do not want share same firewall to different customers will not need to install several VyControl to each customer. That's why the name VyControl.
|
|
|
|
|
|
-## community
|
|
|
+# community, help and development
|
|
|
* Slack Channel https://vycontrol.slack.com/archives/C012ZRMB8VB
|
|
|
-* Forum Post https://forum.vyos.io/t/vycenter-alpha-stage-announcement-vyos-web-interface/5221/4
|
|
|
-
|
|
|
-## features
|
|
|
-* in alpha stage we're going to provide just essential device config, interfaces and firewall, as proof of concencept, as well config module basic cruds (users, groups and vyOS Servers)
|
|
|
-* basic authentication - use django admin to create superuser than http://127.0.0.1:8000/admin/login/?next=/admin/ to create a new user, after that you can use VyControl
|
|
|
-
|
|
|
-### auth module
|
|
|
-* login - **done**
|
|
|
-* logout - **done**
|
|
|
-* lost password - *todo*
|
|
|
-* create users - admin only *todo*
|
|
|
-* associate users to groups - admin only **done**
|
|
|
-* associate groups to vyos servers - admin only *todo*
|
|
|
-* allow commum users to add vyos servers?
|
|
|
-* start page to create initial superadmin user on new installations - **done**
|
|
|
-
|
|
|
-### interfaces module
|
|
|
-* list interfaces - alpha
|
|
|
-* show interface - alpha
|
|
|
-* unset/set firewall interface - *todo*
|
|
|
-* change interface parameters - *todo*
|
|
|
-
|
|
|
-### firewall module
|
|
|
-* basic firewall rules creation proof of concept - **done**
|
|
|
-* basic list firewall rules - **done**
|
|
|
-* basic add firewall rules - **done**
|
|
|
-* basic edit firewall rules - **done**
|
|
|
-* basic firewall create - **done**
|
|
|
-* change firewall rules order - *todo*
|
|
|
-* delete firewall rules - *todo*
|
|
|
-
|
|
|
-## other modules - *todo*
|
|
|
-* ospf
|
|
|
-* bgp
|
|
|
-* ipsec
|
|
|
-* openvpn
|
|
|
-* reports (maybe collecting using snmp)
|
|
|
-* ssh management
|
|
|
-* system login managament
|
|
|
-* nat
|
|
|
-* dhcp servers
|
|
|
-* static routes
|
|
|
-
|
|
|
-### config module
|
|
|
-* VyControl users crud - *todo*
|
|
|
-* vyos instance using database - **done**
|
|
|
-* full vyos instances crud - *todo*
|
|
|
-* add new VyoS instances test connection while adding - *todo*
|
|
|
-* add new VyoS instances test connection all servers crontab - *todo*
|
|
|
-* associate groups to VyOS instances
|
|
|
-
|
|
|
-### known issues
|
|
|
-* cannot edit firewall rules number using current API
|
|
|
-
|
|
|
-
|
|
|
-# dockerhub
|
|
|
+* VyControl discussion at VyOS forum https://forum.vyos.io/t/vycenter-alpha-stage-announcement-vyos-web-interface/5221/4
|
|
|
+* Feature requests, bugs please add at https://github.com/vycontrol/vycontrol/issues
|
|
|
+* Forks and pull requests are welcome!
|
|
|
+
|
|
|
+# roadmap
|
|
|
+
|
|
|
+## active develpment version
|
|
|
+* 20.05.01 - version created to start project framework, organize permission systems and concept test with some firewall and interface functions and statics routes - software work as a proof of concept **almost done**
|
|
|
+
|
|
|
+## future versions
|
|
|
+* 20.05.02 - working firewall without zones bases firewall - software work for whom want firewall without zones
|
|
|
+* 20.05.03 - zone based firewall
|
|
|
+* 20.05.04 - IPSEC features
|
|
|
+* 20.05.05 - better html css - someone help please :-)
|
|
|
+* 20.06.01 - save/commit/load features and ssh / logins
|
|
|
+* 20.06.02 - vlans / interfaces deep configuration
|
|
|
+* 20.06.03 - improve permissions to allow users inside same group to have different roles
|
|
|
+* **20.06.04-LTS** - OSPF features
|
|
|
+
|
|
|
+## lifecycle
|
|
|
+* initially LTS (Long Term Support) versions will be supported by 6 months just to bugfixes
|
|
|
+* in the future we will extend the time span of LTS versions
|
|
|
+
|
|
|
+
|
|
|
+# installation
|
|
|
+
|
|
|
+## by dockerhub
|
|
|
latest VyControl is being autobuilt at dockerhub https://hub.docker.com/r/robertoberto/vycontrol
|
|
|
```
|
|
|
docker pull robertoberto/vycontrol
|
|
|
```
|
|
|
|
|
|
-# docker composer
|
|
|
+## by docker composer
|
|
|
|
|
|
Right now we are using db.sqlite3, but I used composer so we can change to mySQL if needed.
|
|
|
|
|
@@ -84,22 +54,22 @@ docker-compose build
|
|
|
docker-compose up
|
|
|
```
|
|
|
|
|
|
-# manual install instructions
|
|
|
+## manual install instructions
|
|
|
|
|
|
-## setup virtual env and pip requirements
|
|
|
+### setup virtual env and pip requirements
|
|
|
```
|
|
|
virtualenv env
|
|
|
source env/bin/activate
|
|
|
pip3 install -r requirements.txt
|
|
|
```
|
|
|
|
|
|
-## setup initial database
|
|
|
+### setup initial database
|
|
|
```
|
|
|
cd vycenter
|
|
|
python3 manage.py migrate
|
|
|
```
|
|
|
|
|
|
-## run webserver
|
|
|
+### run webserver
|
|
|
```
|
|
|
python3 manage.py runserver
|
|
|
```
|
|
@@ -114,29 +84,39 @@ http://127.0.0.1:8000/
|
|
|
* click on *List Instances*
|
|
|
* click on *Test Connection*
|
|
|
|
|
|
+
|
|
|
# references
|
|
|
* https://docs.vyos.io/en/latest/appendix/http-api.html
|
|
|
* https://forum.vyos.io/t/http-api-for-show/3922
|
|
|
* https://blog.vyos.io/vyos-rolling-release-has-got-an-http-api
|
|
|
|
|
|
+
|
|
|
# screenshoots (keep in mind we're in early alpha stages)
|
|
|
|
|
|
+## Install VyControl
|
|
|
+
|
|
|
+
|
|
|
+## List Users
|
|
|
+
|
|
|
+
|
|
|
## List VyOS Instances
|
|
|
-
|
|
|
+
|
|
|
|
|
|
## Add VyOS Instances
|
|
|
-
|
|
|
-
|
|
|
+
|
|
|
+
|
|
|
## List Interfaces
|
|
|
-
|
|
|
+
|
|
|
|
|
|
-## Firewall Dashboard
|
|
|
-
|
|
|
+## List Firewall
|
|
|
+
|
|
|
|
|
|
## Add Firewall Rule
|
|
|
-
|
|
|
+
|
|
|
|
|
|
+## List Static Routes
|
|
|
+
|
|
|
|
|
|
|
|
|
# Sponsoring
|
|
|
-* VyControl is being tested at [Under](https://under.com.br) a brazilian provider of Cloud Computing and Datacenters.
|
|
|
+* VyControl is being tested at [Under](https://under.com.br) a Brazilian provider of Cloud Computing and Datacenters.
|