https://github.com/ruffrey/paastor

open source deployment platform for node.js, mongo and redis formerly paastor.com
https://github.com/ruffrey/paastor

Last synced: about 1 year ago
JSON representation

open source deployment platform for node.js, mongo and redis formerly paastor.com

• Host: GitHub
• URL: https://github.com/ruffrey/paastor
• Owner: ruffrey
• License: mit
• Created: 2015-07-22T21:27:42.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2015-07-23T01:43:48.000Z (almost 11 years ago)
• Last Synced: 2025-04-04T16:41:46.809Z (about 1 year ago)
• Language: JavaScript
• Homepage:
• Size: 434 KB
• Stars: 17
• Watchers: 1
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# **paastor**

*A hostable gui for deployment management of Node.js, MongoDB, and Redis apps on Ubuntu servers.*

**Formerly paastor.com**, this project was open sourced and the website

was shutdown because I do not have time to maintain it. Apologies to

the users.

# **sheep**

*A proxy and api for running node apps on a slave VPS.*

## How it works

![diagram of paastor setup](https://raw.githubusercontent.com/paastor/paastor/master/paastor-server/public/diagram.png)

### Managing servers via gui

![screenshot of paastor gui](https://raw.githubusercontent.com/paastor/paastor/master/paastor-server/public/dash.png)

### Deploy with the command line tool

```

pstr push my-server myapp

```

## Development and Running Locally

requirements:

* node.js

* mongodb

* gulp

installing:

    git clone https://github.com/ruffrey/paastor

    cd paastor && npm install

    cd sheep && npm install

sheep is an express app inside the paastor directory, hence the double npm install.

running:

    npm start

or

    npm run debug-start

Also

    gulp

will watch and perform tasks like recompiling jade and client JS.

## Default Server Locations

* *paastor* is at `localhost:2999`

* *sheep proxy* is at `localhost:3001` in development and `localhost:80` in production

* *sheep api* is at `localhost:3000`

## Default Services

Install mongodb and redis via gui.

## Security

* header `Paastor-Secret` is sent during paastor --> sheep api communications.

    * secret is stored **hashed and salted** on sheep, by sheep, inside `system.json`.

    * secret is stored in paastor database under the `Vps.secret` property

    * YOU set the secret when creating a Vps

    * To tell **sheep** to reset and hash the secret, start the instance with an environment variable `HASH_RESET=` and your new secret. `cd /path/to/sheep && HASH_RESET=asdfpassword npm start`

## System Settings

* `email` Login email address.

* `name` System informational name.

* `password` Hashed login password.

* `sshkey` Generated from the paastor gui. System public ssh key - add this to your git repos.

## Tests

First add a vps for testing at `spec/vps-credentials.json` and set up paastor (http://localhost:2999/), then add paastor credentials at `spec/paastor-credentials.json`.

An example file is at `spec/vps-credentials.json.example`.

##### Running the Tests

    npm test

If you have problems, try

    npm run debug-test

for more verbose output.

If tests fail, you might end up with node processes that have gone rogue. Find them and stop them:

    ps -l | grep node

    kill [pid goes here]

![find-and-kill](http://i.imgur.com/ZawnSMg.png)

## Deploying sheep to the static site

From the root directory of `paastor`:

    ./pack

will do it.

# License

MIT - see LICENSE file in this repository

Copyright 2015 Jeff H. Parrish