more screenshots

Strider is an Open Source Continuous Deployment / Continuous Integration platform. It is written in Node.JS / JavaScript and uses MongoDB as a backing store. It is published under the BSD license.

For more details, including features and more, check out the introductory chapter of the Strider Book.

• Docker quickstart
• Running on Infrastructure
  • Configuring
  • Adding Users
  • Starting Strider
• Require()'ing Strider
• Extension & plugin guide
• Support & Help
• Getting Started with Strider Guide
  • Node.js: Continuous Integration
  • Node.js: Continuous Deployment to Heroku (+ MongoLab/MongoDB)
  • strider-custom.json configuration
• Roadmap / Changelog

There's a walkthrough of setting it up on our blog.

Make sure you have MongoDB installed on your system. You can get the latest version at http://www.mongodb.org/downloads

Next you will need Node.JS. You can get binary packages for most platforms at http://nodejs.org

Once you have Node.JS on your system, you can fetch & install all the dependencies for your Strider clone by executing the following command in the project root:

npm install

• DB_URI : MongoDB DB URI if not localhost (you can safely use MongoLab free plan - works great)

• SERVER_NAME : Address at which server will be accessible on the Internet. E.g. https://strider.example.com (note: no trailing slash)

• PLUGIN_GITHUB_APP_ID, PLUGIN_GITHUB_SECRET: Github app ID & secret (assuming not running on localhost:3000) - you can register a new one at https://github.com/settings/applications/new - the Main URL should be the same as server name above, and the callback URL should be server name with the path /auth/github/callback. E.g. https://strider.example.com/auth/github/callback

• If you want email notifications, configure an SMTP server (we recommend Mailgun for SMTP if you need a server - free account gives 200 emails / day):

  • SMTP_HOST: SMTP server hostname e.g. smtp.example.com
  • SMTP_PORT: SMTP server port e.g. 587 (default)
  • SMTP_USER: SMTP auth username e.g. "myuser"
  • SMTP_PASS: SMTP auth password e.g. "supersecret"
  • SMTP_FROM: Default FROM address e.g. "Strider [email protected]" (default)

node bin/strider addUser

$ node bin/strider addUser
Enter email []: [email protected]
Is admin? (y/n) [n]: y
Enter password []: *******

Email:		[email protected]
Password:	****
isAdmin:	true
OK? (y/n) [y]:
22 Oct 21:21:01 - info: Connecting to MongoDB URL: mongodb://localhost/strider-foss
22 Oct 21:21:01 - info: User added successfully! Enjoy.

node bin/strider

var strider = require('strider')

var instance = strider("/path/to/extensions/dir", config, function(err, initialized, appInstance) {
    console.log("Strider is now running")
})

For documentation on extending Strider, see strider-extension-loader's README.

Strider is maintained and supported by FrozenRidge, LLC. For commercial support, customization, integration & hosting enquiries please email [email protected].

If you would like Strider to deploy to Heroku automatically when tests pass (AKA deploy-on-green), click 'continue to deployment configuration'. You will then need to enter your Heroku API key. You can find your API key about halfway down the 'My Account' page on Heroku. Then select from an existing Heroku app or enter the name for a new app.

The final step is to modify your project so that it will work properly with Strider. This won't take long but is specific to your language and framework, so please click on the appropriate link below.

• Node.js: Continuous Integration

• Node.js: Continuous Deployment to Heroku (+ MongoLab/MongoDB)

Strider will run 'npm install' to install all of your packages as specified in package.json and npm-shrinkwrap.json (if present).

Once all of the modules are installed, Strider will run the command 'npm test' to execute your node.js automated tests. npm will look for a scripts key in packages.json that should look something like this:

"scripts": {
  "test": "node_modules/mocha/bin/mocha -R tap"
}

We are using Mocha in this example but any test framework will work as long as it can be called from the command line.

When your tests run, Strider exports a number of UNIX environment variables which you can use to connect to the test database. Strider supports setting environment variables per-project. Simply browse to the "Environment" tab on the project config page to set these:

Specify the url with the environment variable DB_URI

If you aren't sure how to create a database connection from a database URI, have a look at one of our sample apps:

• BeyondFog/strider-nodejs-mongodb-test - very simple app that connects to MongoDB in the test script
• BeyondFog/Poang - sample node.js app built with MongoDB using Express web framework, Mongoose ODM and Everyauth authentication/account plugin.

If you aren't sure how to create a database connection from a database URI, have a look at the sample app:

• BeyondFog/strider-nodejs-postgresql-test - very simple app that connects to PostgreSQL in the test script

If you aren't sure how to create a database connection from a database URI, have a look at this sample app:

• BeyondFog/strider-nodejs-redis-test - very simple app that connects to Redis in the test script

Once you have finished setting up your node.js app for continuous integration with Strider, you are only a few steps away from continuous deployment to Heroku.

Heroku requires that you have a Procfile with the command to start your web app. It should look like this:

web: node app.js

If you would like to use the (free) MongoLab addon with your app, you will need to use the Heroku Toolbelt from your command line to add it to your project. After the Heroku app has been created (either by Strider or via the command line), run the following command:

heroku addons:add mongolab:starter --app [your_app_name]

Once you have added a Procfile and confirmed that you are using the Heroku environment variables, your app should be ready to go for continuous deployment to Heroku. By default, Strider will deploy to Heroku on green, ie if all of the tests pass.

If you would prefer to only deploy to Heroku on demand, you can turn off 'deploy on green' in the project configuration settings.

Once you turn off 'deploy on green', Strider will deploy the project to Heroku ONLY when you manually trigger a 'test and deploy' job from the Strider interface.

For more information on how to configure a node.js app to work on Heroku, see Getting Started with Node.js on Heroku/Cedar.

Example:

{
  "prepare": "echo executed prepare statement!",
  "test": "echo executed deploy statement!",
  "deploy": "echo deploy && git push heroku master --force"
}