crcn/gittyup

Gittyup is a small node.js application deployment library similar to n.

Features

Command Line Interface.
Rollback support.
Script testing before using.
Start/Stop/Restart checked out apps.
Make a slug out of your app and easily move it quickly between servers.

Command Line

gup checkout daisy --repo=https://github.com/crcn/daisy.git --branch=app-branch
gup use daisy r5 #use a particular checkout

Options

 help                                                                             
 rollback :name                                  Rollback a repositoriy           
 history :name                                   Repo history                     
 use :name :release                              Uses a repo                      
 checkout :name :repo OR checkout :name          checks out a repository

Documentation

.gittyup(rootDirectory)

root directory by default is /etc/gittyup/

var gittyup = require('gittyup')('/etc/bonsai/garden/'),
app = gittyup.app('myApp');


app.checkout('myProjectSource', function(err, result)
{

	//something went wrong in the checkout phase - most likely in linking, rollback
	if(err) return app.rollback();  
	             
	
	//test to make sure everythings good
	app.test(function(err, result)
	{
		//something went wrong in the testing phase, rollback
		if(err) return app.rollback();


		//start upp the application
		app.process(function(err, process)
		{
			process.start();
		});
	});
});

//...

.app(ops)

First argument can be either a string (app name), or object

arguments

name - The name of the application.
group - The group the application is in.
maxRecords - Maximum number of application records to keep locally.

.app().checkout(opsOrSource, callback)

opsOrSource - Options (object) or the repo source (string) for the app.
- repository - repository of the project. Can be local directory, git repo, or .slug file

From a git repository:

gittyup.app('myApp').checkout('git@github.com:spiceapps/gittyup-test.git', function(err, result)
{
	//do stuff!
});

From a generated slug:

gittyup.app('myApp').checkout('http://mydomain.com/someApp.slug', function(err, result)
{
});

From a local directory:

gittyup.app('myApp').checkout('/some/local/path', function(err, result)
{
	
});

.app().process(callback)

Returns a runnable process of the current checked out item.

gittyup.app('myApp').process(function(err, process)
{

	process.start(function(err, result)
	{
		//...
	});

	process.stop(function(err, result)
	{
		//...
	});

	process.restart(function(err, result)
	{
		//...
	});
});


```

#### .app().test(callback)

Tests the most recent checked out item. Make sure to include "scripts:test" in your package.json. Something like:

```javascript


{
    "name": "myApp",

    "scripts": {
    	"test": "./test"
    }
}

When exiting the test program, an exit code of 0 tells gittyup the test was successful, whereas 1 tells gittyup the test failed.

.app().makeSlug(callback)

Makes a slug out of the current checkout. Use this method if you need to move the application around between servers. Once a slug is made, calling "makeSlug" on the same checkout will have no effect.

gittyup.app('myApp').makeSlug(function(err, item)
{
	console.log(item.slug); // /etc/gittyup/apps/myApp/16767565434/slug/753a644f4e7aaa7fc9132be92d000002.tar.gz

});

If you're moving the slug around, install gittyup on the other end and have something ready like this:

gittyup.app('myApp').checkout('http://myServer.com/myApp.slug', function(err, result)
{
	//...do stuff with transported slug
})

.app().current(callback)

Returns Information about the current checked out item.

.app().history(callback)

Returns checkout history of the given application.

.app().use(checkoutId)

Uses a previously used checkout item without removing the current one.

.app().remove(checkoutId, callback)

Removes a checked out item.

.app().destroy(callback)

Destroys the application, and all the checked out items.

crcn / gittyup