Differences

This shows you the differences between two versions of the page.

--- services:nodeserve [2024/08/13 09:53] – [Helpful Hints] jas
+++ services:nodeserve [2024/08/13 11:48] (current) – [Nodeserve] jas
@@ Line 1: / Line 1: @@
-====== Nodeserve User Documentation ======
+====== Nodeserve ======
 The Nodeserve system is designed to streamline the deployment and management of Node.js applications for EECS users. This platform allows users to easily host their Node.js apps on the web, providing a seamless interface for starting, and stopping their applications. By automating much of the setup and configuration, Nodeserve enables users to focus on development and learning without worrying about the complexities of server management. This guide will walk you through everything you need to get started with Nodeserve.
@@ Line 13: / Line 13: @@
   % mkdir ~/nodejs/app1
-.  Develop your Node.js app in its respective app directory.
+.  Change into your app directory, and create a //package.json// file using the **npm init -y** command.  Using the "-y" option stops npm from asking you questions such as version, description, author, etc. and uses the defaults.
-.  For each app, create a package.json file using the **npm init -y** command.  Using the "-y" option stops npm from asking you questions and uses defaults.
+  % cd ~/nodejs/app1
+  % npm init -y
+.  Develop your app.  You can use **npm install** to install whatever packages you need.
-.  Allocate a port number for your app using the **nodeserve** command.
+.  Test your app on any EECS machine.  It's harder to debug your app when it's running on the server, so it makes sense to do most of your debugging locally.
+.  Allocate a port number for your app using the **nodeserve** command.
 Each Node.js application must be allocated a unique port number to communicate with the web server. Ports act as channels for data to flow in and out of your app. We allocate a specific port for your app to ensure it runs smoothly without conflicts with other apps. This avoids issues that can arise from choosing an arbitrary port, which might already be in use by another service or application.
@@ Line 59: / Line 64: @@
 </code>
 .  Visit your app on the web by visiting:  https://nodeserve.eecs.yorku.ca/<user>/<app> where <user> is your EECS username, and <app> is your application name.
-The web server will look up the port number allocated to your app, and set the port number in the PORT environment variable.  It will start running your app.  It will forward client requests from https://nodeserve.eecs.yorku.ca/<user>/<app> to your application running on http://localhost:port.
+The web server will look up the port number allocated to your app, and set the port number in the PORT environment variable.  It will start running your app.  It will forward client requests from https://nodeserve.eecs.yorku.ca/<user>/<app> to your application running on http://localhost:<port>.
 A few additional notes: