Skip to content

nodejitsu/solenoid

master
Switch branches/tags
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
bin
 
 
 
 
 
 
 
 
 
 
 
 

solenoid

Jump start an application. solenoid is a binary script that does the following:

  • Start an app: solenoid start -p PIDFILE -u USERNAME -a APP_NAME -v APP_VERSION
  • Stop an app: solenoid stop -p PIDFILE
  • Restart an app: solenoid restart -p PIDFILE

Solenoid Start logic

When solenoid starts an application it performs the following operation:

  1. Creates the run direction options.runDir
  2. Creates the solenoid user
  3. Fetches the application snapshot to RUN_DIR/snapshot.tgz
  4. Unpacks the snapshot to RUN_DIR/snapshot/package
  5. Removes the packed snapshot at RUN_DIR/snapshot.tgz
  6. Reads the package.json at RUN_DIR/snapshot/package/package.json
  7. Determines the node engine. Defaults to options.engines.node.default || 0.6.x.
  8. Reads the ENVVARS from -e|--app-env (if any).
  9. Restricts the filesystem to the solenoid user
  10. Gets the uid and gid of the solenoid user
  11. Starts the application using aeternum and forza.

CLI Arguments

  -u, --app-user     Username of the owner of the application.
  -a, --app-name     Name of the application.
  -v, --app-version  Version of the application.
  -e, --app-env      Environment vars as serialized JSON.
  -p, --pidfile      Location of the pidfile on disk of the aeternum process.

Configuration

solenoid expects a configuration file $HOME/.solenoidconf with the following options:

{
  "storage": {
    //
    // Valid pkgcloud storage provider configuration
    //
    "provider":  "rackspace",
    "username":  "rackspace-username",
    "apiKey":    "rackspace-apiKey",
    "container": "rackspace-container",
    "region":    "ord"
  },
  "instruments": [
    //
    // Instruments provider to send metrics and events to.
    //
    {
      "host": "127.0.0.1",
      "port": 8556
    }
  ],
  //
  // Directory to run applications within.
  //
  "runDir": "/opt/run"
  "engines": {
    "node": {
      "default": "0.6.x",
      "path": "/opt/engines/node"
    }
  }
}
LICENSE: MIT
Authors: Jarrett Cruger, Charlie Robbins

About

Jump start an application

Resources

License

Stars

Watchers

Forks

Packages

No packages published