WebUI implementation for GNS3
Go to file
2023-06-30 17:56:15 +10:00
.circleci New attempt to fix CircleCI build 2021-02-27 16:24:47 +10:30
.github/workflows Merge branch 'master' into master-3.0 2023-02-04 16:10:30 +08:00
.vscode I have resolved image progress bar and undefined event issue 2022-06-06 13:43:39 +05:30
e2e Rename user management server ref to controller 2022-07-22 21:44:41 +02:00
scripts Upgrade requests module. Fixes 2023-06-21 18:38:42 +09:30
src Support for UEFI boot mode option for Qemu VMs 2023-06-21 18:10:00 +09:30
.appveyor.yml Fix typo in .appveyor.yml 2021-04-08 00:38:37 +09:30
.editorconfig Debugging configruation and merge with latest angular 2018-11-27 11:26:23 +01:00
.gitignore Updates from main branch () 2021-12-28 14:39:15 +01:00
.prettierrc Implement prettier in package.json, Fixes: 2018-12-10 13:44:49 +01:00
.sentryclirc Added .sentryclirc 2019-03-27 10:49:33 +01:00
.snyk fix: package.json, yarn.lock & .snyk to reduce vulnerabilities 2020-07-10 04:13:48 +00:00
.travis.yml Codecov disabled 2021-04-16 12:10:33 +02:00
.whitesource Scan master-3.0 branch with Mend 2022-12-27 13:21:53 +08:00
.yarnclean Remove .md from yarnclean 2018-11-06 10:31:09 +01:00
angular.json Merge remote-tracking branch 'origin/master' into master-3.0 2023-02-01 10:32:12 +08:00
console-executor.js Basic PuTTY support, Ref. 2019-04-12 12:16:46 +02:00
debug.log Stabilize unit tests 2020-11-09 01:27:37 +01:00
Dockerfile Update Dockerfile 2020-10-11 15:30:47 +08:00
electron-builder.yml Finish to rename server to controller 2022-07-22 18:49:36 +02:00
installed-software.js Install SolarPuTTY when available 2019-02-04 11:32:01 +01:00
karma.conf.js Use 'ChromeHeadless' in karma.conf.js 2023-02-01 10:57:59 +08:00
LICENSE Initial commit 2017-09-25 11:27:22 +02:00
local-controller.js Finish to rename server to controller 2022-07-22 18:49:36 +02:00
main.js Support of stderr CRITICAL issues forwarded to app 2019-02-20 11:32:54 +01:00
package.json Development on 3.0.0.dev7 2023-06-30 17:56:15 +10:00
protractor.conf.js Draft of WebUI 2017-09-25 13:07:52 +02:00
README.md Update README.md 2021-04-19 12:17:50 +02:00
renderer.js Adding templates of IOS routers 2019-02-05 01:26:35 -08:00
SECURITY.md Create SECURITY.md 2022-12-20 21:34:44 +08:00
sentry.js Fix white screen on electron app, Ref: 2019-01-04 12:57:58 +01:00
set-variables-in-env.js Update prod env only when variables are defined 2019-01-29 09:54:26 +01:00
tsconfig.base.json Updating angular to 12, removing indexed db 2021-05-27 22:17:22 +02:00
tsconfig.json Set --tsconfig "./src/tsconfig.app.json" in package.json 2022-07-15 00:11:28 +02:00
tslint.json Add role management 2022-02-28 13:50:11 +01:00
yarn.lock Bump ua-parser-js from 0.7.31 to 0.7.33 2023-01-27 08:44:32 +00:00

gns3-web-ui

Build Dependency Packages versions Packages

Demo

Please use GNS3 WebUI bundled in gns3server and gns3.

Development

Branches policy

On branch master you can find the latest codebase including under development features. If you are looking for stable version with features promoted to be included in the current/next release please switch to stable branch.

Installation

We're using yarn for packages installation:

yarn install

JavaScript heap out of memory

Increase the memory allocated to Node if you get JavaScript heap out of memory errors.

export NODE_OPTIONS=--max-old-space-size=8192

Run GNS3 server

Visit gns3-server for guide how to run GNS3 server.

Run WebUI

yarn ng serve

Application is accessible on http://127.0.0.1:4200/. The app will automatically reload if you change any of the source files.

Docker container

For development you can also run the GNS3 Web UI in a container

bash scripts/docker_dev_webui.sh

How to upgrade package.json?

yarn upgrade --latest

gns3server bundled in WebUI - electron based

In special cases it's possible to build gns3server for GNS3 WebUI. This version is included in electronjs dist application.

python3 scripts/build.py build -b dist

Code scaffolding

Run yarn ng generate component component-name to generate a new component. You can also use yarn ng generate directive|pipe|service|class|module.

Build

Run yarn ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.

Running unit tests

Run yarn ng test to execute the unit tests via Karma.

Releasing

Release naming convention

Releases are named by the year and quarter when release is happening, e.g. January 2020 release is named 2020.1.X.

Bumping releases

We're using version-bump-prompt for increasing version.

Install version-bump-prompt via:

    npm install -g version-bump-prompt

If you would like to bump prepatch just type:

    bump --prepatch --tag --push

Distribute release

We have got configured CircleCI, TravisCI and AppVeyor for distributing application for particular platform. In order to release you need to tag&push your changes from master.

First of all please remove dev from version in package.json (for instance 2019.2.0-alpha.4dev to 2019.2.0-alpha.4). Commit & push changes with message Release 2019.2.0-alpha.4 . Next step is to tag repository and push to origin:

    git tag v2019.2.0-alpha.4
    git push origin v2019.2.0-alpha.4

When artifacts are made you can see draft release here: gns3-web-ui releases which is waiting to be published. After release please change current version in package.json to 2019.2.0-alpha.5dev'. Otherwise artifacts will be overwritten during the next commit. Don't forget to commit & push changes.

Updating gns3server

Checkout the latest master of gns3server. Run command ./scripts/update-bundled-web-ui.sh --tag=v2019.2.0-alpha.5. Commit & push changes with message Release 2019.2.0-alpha.4.

Staging release

In case you would like to create a new staging release. Please create draft release on github, like 0.0.1-dev1. After successful build you can find artifacts there.

Updating signing certificate for Windows

Please follow this guide: code-signing, use certmgr.msc exporting tool to limit the size of certificate.

Further help

If you want to contribute to GNS3 Web UI feel free to reach us at developers@gns3.net.