nda-installer
v0.7.1
Published
An application to deploy NodeJS projects from an internet browser
Downloads
83
Maintainers
Keywords
Readme
Node Deployment Assistant @ NDA
Now deploy node projects from an internet browser
Installation
Install NDA as a global package.
npm i nda-installer -g
Tested Operating Systems
- Windows 11, Mac Monterey, RHEL 7.9, Ubuntu 20.04, Cent OS 7, Fedora 35
Prerequisite
Please complete the following prerequisite before installing the NDA
Install an internet browser.
Install NodeJS version >= 7.10.1.
About
NDA helps you to deploy your NodeJS projects in an easier way. Once you configure your project with NDA, then you are only one click away from starting or restarting it.
Once a project is started using NDA, it will collects the project's logs & also monitors the CPU usage & status of the project.
Since the projects will be started in a keep alive mode, closing the browser window or the terminal (from where the NDA is launched) won't stop your NodeJs projects started by NDA.
How it works
When you start NDA, it will run a web application in the machine where it's installed.
By accessing that web application, you can handle the deployments of your NodeJS projects.
Demo
Please click here for a detailed explanation video.
Feature: Dashboard
This is the launching page of the NDA.
It provides the options to,
- Add / Edit / Delete / Clone a project.
- Run / Stop / Restart a project.
- See the project logs.
- Stop all projects (when more than one projects are running).
It has the functionality to,
- Monitor status of the projects started by NDA & display a popup if a running project is crashed.
- Update the CPU usage of the running projects periodically.
Feature: Configuration
This page will have the configuration options available for the NDA application.
Start-on-boot
If this is enabled, NDA application will be started during the system startup
Launch-on-boot
This will be available, only if the Start-on-boot
option is enabled.
Once this option is enabled, NDA application will be opened in the default internet browser during the system startup.
Bind SSL Certificate
Using this option, a SSL certificate can be added to the NDA application.
Once enabled, NDA will be launched with https protocol.
Feature: Add Project
To start deploying your NodeJS projects, goto to the Add Project page by clicking on the (+) button in the dashboard.
In the Add Project page, provide your project's - name, folder path, start file path, port, environment variables & cron jobs.
Please check the information provided in the info icon against each inputs in the Add Project page to configure your project without successfully.
Feature: Logs
NDA stores the logs of running projects in a daily basis. To see all the logs available for a project, click the Logs icon under the Actions column against the corresponding project in the dashboard. It will navigate you to the logs list page.
The logs list page displays the list of log files created on a daily basis.
It provides the information like date, size & last modified time of the log files.
It also provides the options to delete or view the logs of a particular day.
To view the logs, click on the date against each log file. It will navigate you to the logs page.
Logs page displays the log contents based on the date.
To avoid overload, logs page is implemented with pagination & lazy load.
It displays the logs based on the line count selected in the dropdown near the Fetch button and it will fetch the next set of records when scrolled.
To fetch logs after a certain line, provide the line count in the text box near the Fetch button & then click on Fetch.
Available CLI Commands
- To start NDA in 8055 (NDA's default port)
nda run
- To start NDA in specific port
nda run <port>
Example: nda run 9000
- To stop NDA
nda sleep
- To get running status of NDA
nda status
- To restart NDA & all the services started by it
nda respawn
Receiving Updates
- To get the latest version
npm update nda-installer -g
- To apply the latest changes
nda respawn
CHANGELOG
Copyright
License
NDA is licensed under GNU AGPL-3.0
For any queries or support, reach us at (mailto:[email protected])