jesse-sge/mina

Really fast deployer and server automation tool.

Mina

Really fast deployer and server automation tool.

Mina works really fast because it's a deploy Bash script generator. It generates an entire procedure as a Bash script and runs it remotely in the server.

Compare this to the likes of Vlad or Capistrano, where each command is ran separately on their own SSH sessions. Mina only creates one SSH session per deploy, minimizing the SSH connection overhead.

$ gem install mina
$ mina

Documentation

Please consult the project documentation for full details.

Problems or suggestions? File issues at the issue tracker (github.com). You may also look at the Trello board (trello.com) we use for development.

Documentation sources

See nadarei/mina-docs for the sources of the documentation site. Please ensure that docs there are in sync with the features here.

Development & testing

To test out stuff in development:

# Run specs
$ rspec
$ rspec -t ssh     # Run SSH tests (read test_env/config/deploy.rb first)
$ rake=0.9 rspec
$ rake=0.8 rspec

# Alias your 'mina' to use it everywhere
$ alias mina="`pwd -LP`/bin/mina"

Doing test deploys

Try out the test environment:

$ cd test_env
$ mina deploy --simulate
$ mina deploy

# There's an rspec task for it too
$ rspec -t ssh

Gem management

# To release the gem:
# Install the Git changelog helper: https://gist.github.com/2880525
# Then:

$ vim lib/mina/version.rb
$ git clog -w
$ vim HISTORY.md
$ git commit -m "Release v0.8.4."
$ rake release

# Please don't forget to tag the release in github.com/nadarei/mina-docs too!

$ rake build      # Builds the gem file
$ rake install    # Installs the gem locally

Acknowledgements

© 2012, Nadarei. Released under the MIT License.

Mina is authored and maintained by Rico Sta. Cruz and Michael Galero with help from its contributors. It is sponsored by our startup, Nadarei.

• Nadarei (nadarei.co)
• Github (@nadarei)

Rico:

• My website (ricostacruz.com)
• Github (@rstacruz)
• Twitter (@rstacruz)

Michael:

• My website (michaelgalero.com)
• Github (@mikong)