https://github.com/gimenete/fraggle

A command line utility to deploy different versions of nodejs applications
https://github.com/gimenete/fraggle

Last synced: about 1 month ago
JSON representation

A command line utility to deploy different versions of nodejs applications

• Host: GitHub
• URL: https://github.com/gimenete/fraggle
• Owner: gimenete
• Created: 2011-08-23T11:05:40.000Z (about 13 years ago)
• Default Branch: master
• Last Pushed: 2011-08-23T15:54:06.000Z (about 13 years ago)
• Last Synced: 2024-04-14T23:06:43.795Z (7 months ago)
• Language: JavaScript
• Homepage:
• Size: 90.8 KB
• Stars: 4
• Watchers: 1
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
What is fraggle

---------------

A command line utility to deploy different versions of nodejs applications. You define a main host (i.e: www.example.dev) and you can deploy different versions of your app, each one in its own subdomain (i.e: 1.www.example.dev, 2.www.example.dev and so on). Fraggle then:

  - Downloads the source code and changes the working directory to a given version (usually a tagged commit). At this moment only git repositories are supported.

  - Changes the proxy configuration to add the new host with that version. At this moment only haproxy is supported.

Getting started

---------------

You can install fraggle with `npm``

    npm install fraggle -g

Create a new directory. For example `services`

    mkdir services

Create an empty configuration file

    echo '{}' > config.json

Create a haproxy.ejs template. You can use [this example](https://github.com/gimenete/fraggle/blob/master/haproxy.ejs). Save (and modify if you want) the template as `haproxy.ejs` in the current directory.

Usage

-----

**Adding services**

To add a service to the configuration file. Use:

    fraggle add   

For example:

    fraggle add www.example.dev [email protected]:gimenete/myserver.git server.js

The executable file will be invoked with the port number in which it should listen as the frist parameter.

At this moment nothing is running. You just added a service to the configuration file. Now you need to deploy a version.

**Deploying versions**

To deploy a new version just use:

    fraggle deploy .

For example:

    fraggle deploy 1.www.example.dev

This will download the source code of the repository in a new directory: `repos/1.www.example.dev` checking out the given tag ('1' in this case). Fraggle will run the  with an available port as first parameter, and will restar the proxy with the new configuration. It uses [forever](https://github.com/indexzero/forever) to keep it running forever :) And log files are stored inside the `logs` directory that will be created if does not exist.

At this moment you can browse http://1.www.example.dev to see the new deployed version.

**Marking a version as the default one**

Now you would want to have some version serving at http://www.example.dev You just need to use:

    fraggle default .

For example:

    fraggle default 1.www.example.dev

So you now can browse http://www.example.dev

**Deleting versions**

If you want to delete a version, you just need to do the following:

    fraggle delete .

For example:

    fraggle delete 1.www.example.dev

Fraggle will stop the service, and it also will delete the application directory and will restart the proxy with the new configuration.

**Listing active services**

You can list the active services by simply using:

    fraggle list

It will show you the configured domains, with their versions, the port where they are running, and which of them is the default version (marked as PROD in the listing).