Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

application deployment library for node.js

branch: master

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 examples
Octocat-spinner-32 lib
Octocat-spinner-32 .cupboard
Octocat-spinner-32 .gitignore
Octocat-spinner-32 .travis.yml
Octocat-spinner-32 README.md
Octocat-spinner-32 package.json
Octocat-spinner-32 project.sublime-project
Octocat-spinner-32 project.sublime-workspace
Octocat-spinner-32 project.tmproj
README.md

build status 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:


{
    "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.

Something went wrong with that request. Please try again.