Join GitHub today
GitHub is home to over 20 million developers working together to host and review code, manage projects, and build software together.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
|Failed to load latest commit information.|
NodeFu (http://nodefu.com) = Node.js Hosting Platform This is an *experimental* service for managing hosted nodejs apps. It consists of an API that allows developers to create and manage nodejs apps. Node apps are assigned subdomains that proxy to ports with an assigned address. Instances (dynos) are launched using Forever so that they run until you stop them or using Nodemon where they run until a file changes from a git update. Dependencies: Node.js and the following NPM modules: http-proxy, express, node-base64, couch-client, nodemon (https://github.com/substack/node-base64) CouchDB instance or CouchOne account Git Get Started: ruby launchnodefu.rb This small Ruby script launches proxy.js to start services and it will launch app.js - proxy.js launches proxy server redirecting port 8080 traffic to appropriate node app - proxy launches app.js on port 4000 for creating and managing node apps API Documentation: COUPON /coupon - creates coupon request for early access (pass in email) - <b>Note: This resource does not use base api url curl -X POST -d "firstname.lastname@example.org" http://localhost:8080/coupon STATUS /status - returns status of the platform and number of nodejs apps running // curl http://api.localhost:8080/status USER /user - creates user account (pass in user and password and email) - Note: This resource does not use the api subdomain curl -X POST -d "email@example.com" http://localhost:8080/user /user - delete user account (requires basic auth) curl -X DELETE -u "testuser:123" http://api.localhost:8080/user APP /app - create nodejs app for hosting (requires basic auth and returns the port address required for use along with a git repo to push to) curl -X POST -u "testuser:123" -d "appname=a&start=hello.js" http://api.localhost:8080/app /app - update nodejs app for hosting (requires basic auth, appname, and starting page and returns the port address required for use along with a git repo to push to) curl -X PUT -u "testuser:123" -d "appname=a&start=hello1.js" http://api.localhost:8080/app /app - delete nodejs app (requires basic auth and appname) curl -X DELETE -u "testuser:123" -d "appname=test" http://api.localhost:8080/app Testing: Subdomains can be tested by editing /etc/hosts like this: 127.0.0.1 localhost a.localhost b.localhost c.localhost save etc/hosts and flush DNS like this: sudo dscacheutil -flushcache http://localhost:8080 = Homepage http://a.localhost:8080 = Runs app associated with subdomain a on couch-configured port http://b.localhost:8080 = Runs app associated with subdomain b on couch-configured port http://chris:firstname.lastname@example.org:8080/status = API to list status of all node apps http://chris:email@example.com:8080/list/2.json = API TBD Maintenance: Run "ruby installmodules.rb" periodically to install and update all NPM modules on system. Todos: - add rsa keys for private repos (gitolite or gitosis?) - add ability to control number of instances - Add Command Line Interface - Add SSL support - Add better error handling Considerations: - 64k port limitation per IP address on Linux - how do we scale horizontally? - sandbox node instances? - Push apps to local git repos git remote add nodefu /usr/local/src/nodefu/apps/7-46e95eaa00d2785e6c73e5a4fc25d88c.git git push nodefu master Contribute: If this project inspires you, please feel free to help out by forking this project and sending me pull requests. License: Apache 2 - Have fun! :)