mina 0.3.8 → 1.0.0.beta1

data/Makefile

@@ -1,32 +0,0 @@
-Readme.md: \
-	support/Readme-header.md \
-	support/guide.md \
-	support/helpers.md \
-	support/modules.md \
-	support/third_party_modules.md \
-	support/Readme-footer.md
-	cat $^ > $@
-
-support/modules.md: \
-	lib/mina/bundler.rb \
-	lib/mina/default.rb \
-	lib/mina/deploy.rb \
-	lib/mina/foreman.rb \
-	lib/mina/git.rb \
-	lib/mina/rails.rb \
-	lib/mina/rbenv.rb \
-	lib/mina/rvm.rb \
-	lib/mina/npm.rb \
-	lib/mina/tools.rb \
-	lib/mina/whenever.rb
-	cat $^ | ruby support/to_md.rb > $@
-
-support/helpers.md: \
-	lib/mina/helpers.rb \
-	lib/mina/deploy_helpers.rb
-	cat $^ | ruby support/to_md.rb > $@
-
-clean:
-	rm Readme.md support/modules.md support/helpers.md
-
-.PHONY: clean

data/Notes.md

@@ -1,70 +0,0 @@
-Readme
-------
-
-The readme file is auto-generated using make.
-
-    $ make Readme.md
-
-Documentation
--------------
-
-Please consult the [project documentation](http://mina-deploy.github.io/mina) for full
-details.
-
-Problems or suggestions? File issues at the [issue tracker][issues].
-
-Documentation sources
----------------------
-
-See [mina-deploy/mina-docs](https://github.com/mina-deploy/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:
-
-``` sh
-# Run specs
-$ rspec
-$ rspec -t ssh     # Run SSH tests (read test_env/config/deploy.rb first)
-$ rake=10 rspec
-$ 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:
-
-``` sh
-$ cd test_env
-$ mina deploy --simulate
-$ mina deploy
-
-# There's an rspec task for it too
-$ rspec -t ssh
-```
-
-### Gem management
-
-``` sh
-# 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
-```

data/lib/mina/bundler.rb

@@ -1,49 +0,0 @@
-# # Modules: Bundler
-# Adds settings and tasks for managing Ruby Bundler.
-#
-#     require 'mina/bundler'
-
-# ## Settings
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### bundle_bin
-# Sets the bundle path.
-
-set_default :bundle_bin, 'bundle'
-
-# ### bundle_path
-# Sets the path to where the gems are expected to be.
-#
-# This path will be symlinked to `./shared/bundle` so that the gems cache will
-# be shared between all releases.
-
-set_default :bundle_path, './vendor/bundle'
-
-# ### bundle_withouts
-# Sets the colon-separated list of groups to be skipped from installation.
-
-set_default :bundle_withouts, 'development:test'
-
-# ### bundle_options
-# Sets the options for installing gems via Bundler.
-
-set_default :bundle_options, lambda { %{--without #{bundle_withouts} --path "#{bundle_path}" --deployment} }
-
-# ## Deploy tasks
-# These tasks are meant to be invoked inside deploy scripts, not invoked on
-# their own.
-
-namespace :bundle do
-  # ### bundle:install
-  # Installs gems.
-  desc "Install gem dependencies using Bundler."
-  task :install do
-    queue %{
-      echo "-----> Installing gem dependencies using Bundler"
-      #{echo_cmd %[mkdir -p "#{deploy_to}/#{shared_path}/bundle"]}
-      #{echo_cmd %[mkdir -p "#{File.dirname bundle_path}"]}
-      #{echo_cmd %[ln -s "#{deploy_to}/#{shared_path}/bundle" "#{bundle_path}"]}
-      #{echo_cmd %[#{bundle_bin} install #{bundle_options}]}
-    }
-  end
-end

data/lib/mina/chruby.rb

@@ -1,49 +0,0 @@
-# # Modules: chruby
-# Adds settings and tasks for managing [chruby] installations.
-#
-# [chruby]: https://github.com/postmodern/chruby
-#
-#     require 'mina/chruby'
-#
-# ## Common usage
-#
-#     task :environment do
-#       invoke :'chruby[ruby-1.9.3-p392]'
-#     end
-#
-#     task :deploy => :environment do
-#       ...
-#     end
-
-# ## Settings
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### chruby_path
-# Path where *chruby* init scripts are installed.
-#
-set_default :chruby_path, "/etc/profile.d/chruby.sh"
-
-# ## Tasks
-
-# ### chruby[version]
-# Switch to given Ruby version
-
-task :chruby, :env do |t, args|
-  unless args[:env]
-    print_error "Task 'chruby' needs a Ruby version as an argument."
-    print_error "Example: invoke :'chruby[ruby-1.9.3-p392]'"
-    die
-  end
-
-  queue %{
-    echo "-----> chruby to version: '#{args[:env]}'"
-
-    if [[ ! -s "#{chruby_path}" ]]; then
-      echo "! chruby.sh init file not found"
-      exit 1
-    fi
-
-    source #{chruby_path}
-    #{echo_cmd %{chruby "#{args[:env]}"}} || exit 1
-  }
-end

data/lib/mina/default.rb

@@ -1,158 +0,0 @@
-# # Modules: Default
-# This module is loaded when invoking `mina` with or without a project.
-
-# ## Settings
-# Here are some of the common settings. All settings are optional unless
-# otherwise noted.
-#
-# ### deploy_to
-# (Required) Path to deploy to.
-#
-# ### domain
-# (Required) Host name to deploy to.
-#
-# ### port
-# SSH port number.
-#
-# ### forward_agent
-# If set to `true`, enables SSH agent forwarding.
-#
-# ### identity_file
-# The local path to the SSH private key file.
-#
-# ### ssh_options
-# Switches to be passed to the `ssh` command.
-
-# ### env_vars
-# Environment variables to be passed to `ssh` command. (e.g. "foo=bar baz=1")
-
-# ## Tasks
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### environment
-# Make the `:environment` task exist by default. This is meant to be overridden
-# by users.
-
-task :environment do
-end
-
-# ### init
-# Initializes a new Mina project.
-#
-#     $ mina init
-
-desc "Creates a sample config file."
-task :init => :environment do
-  name = Rake.application.name
-  config_file = Rake.application.rakefile
-
-  unless config_file.to_s.empty?
-    print_str "! You already have #{config_file}."
-    exit 8
-  end
-
-  outfile = './config/deploy.rb'
-  require 'fileutils'
-  FileUtils.mkdir_p './config'
-  FileUtils.cp Mina.root_path('data/deploy.rb'), outfile
-
-  print_str "-----> Created #{outfile}"
-  print_str "Edit this file, then run `#{name} setup` after."
-end
-
-task :default => :help
-
-module HelpHelpers
-  def get_tasks(&blk)
-    Rake.application.tasks.select &blk
-  end
-
-  def print_tasks(tasks, width=nil)
-    name = Rake.application.name
-
-    width ||= tasks.map { |t| t.name_with_args.length }.max || 10
-    tasks.each do |t|
-      if t.comment
-        puts "  #{name} %-#{width}s   # %s" % [ t.name_with_args, t.comment ]
-      else
-        puts "  #{name} %s" % [ t.name_with_args ]
-      end
-    end
-  end
-
-  SYSTEM_TASKS = %w[help tasks init]
-  def system_tasks() get_tasks { |t| SYSTEM_TASKS.include? t.name }; end
-  def top_tasks()    get_tasks { |t| ! t.name.include?(':') && t.comment && !system_tasks.include?(t) }; end
-  def sub_tasks()    get_tasks { |t| t.name.include?(':') }; end
-
-  def show_task_help(options={})
-    puts "Basic usage:"
-    print_tasks system_tasks
-
-    if top_tasks.any?
-      puts "\nServer tasks:"
-      print_tasks top_tasks
-    end
-
-    if sub_tasks.any? && options[:full]
-      puts "\nMore tasks:"
-      print_tasks sub_tasks
-    end
-  end
-end
-
-extend HelpHelpers
-
-# ### help
-# Shows the help screen.
-
-desc "Show help."
-task :help do
-  name = Rake.application.name
-
-  puts "#{name} - Really fast server deployment and automation tool\n\n"
-  puts "Options:"
-
-  opts = [
-    [ "-h, --help", "Show help" ],
-    [ "-V, --version", "Show program version" ],
-    [ "-v, --verbose", "Show commands as they happen" ],
-    [ "-S, --simulate", "Run in simulation mode" ],
-    [ "-t, --trace", "Show backtraces when errors occur" ],
-    [ "-f FILE", "Use FILE as the deploy configuration" ]
-  ]
-  opts.each { |args| puts "  %-17s %s" % args }
-  puts ""
-
-  show_task_help
-
-  unless Rake.application.have_rakefile
-    puts ""
-    puts "Run this command in a project with a 'config/deploy.rb' file to see more options."
-  end
-
-  puts ""
-  puts "All of Rake's options are also available as '#{name}' options. See 'rake --help'"
-  puts "for more information."
-  exit
-end
-
-# ### tasks
-# Display all tasks in a nice table.
-#
-#     $ mina tasks
-
-desc "Show all tasks."
-task :tasks do
-  show_task_help :full => true
-end
-
-# ### ssh
-# Connects to the server via ssh and cd to deploy_to folder
-#
-#     $ mina ssh
-
-desc "Open an ssh session to the server and cd to deploy_to folder"
-task :ssh do
-  exec ssh_command + " 'cd #{deploy_to} && exec \$SHELL'"
-end

data/lib/mina/deploy.rb

@@ -1,160 +0,0 @@
-# # Modules: Deployment
-# This module is automatically loaded for all Mina projects.
-
-# ## Settings
-# Any and all of these settings can be overriden in your `deploy.rb`.
-
-# ### releases_path
-# (default: 'releases')
-set_default :releases_path, "releases"
-
-# ### shared_path
-# (default: 'shared')
-set_default :shared_path, "shared"
-
-# ### current_path
-# (default: 'current_path')
-set_default :current_path, "current"
-
-# ### lock_file
-# Name of the file to generate while a deploy is currently ongoing.
-# (default: 'deploy.lock')
-set_default :lock_file, "deploy.lock"
-
-# ### keep_releases
-# Number of releases to keep when doing the `deploy:cleanup` task.
-# (default: 5)
-set_default :keep_releases, 5
-
-namespace :deploy do
-  # ## Tasks
-
-  # ### deploy:force_unlock
-  # Forces a deploy unlock by deleting the lock file.
-  #
-  #     $ mina deploy:force_unlock
-  #
-  # You can also combine that task with `deploy`:
-  #
-  #     $ mina deploy:force_unlock deploy
-
-  desc "Forces a deploy unlock."
-  task :force_unlock do
-    queue %{echo "-----> Unlocking"}
-    queue echo_cmd %{rm -f "#{deploy_to}/#{lock_file}"}
-  end
-
-  # ### deploy:link_shared_paths
-  # Links the shared paths in the `shared_paths` setting.
-
-  desc "Links paths set in :shared_paths."
-  task :link_shared_paths do
-    dirs = settings.shared_paths!.map { |file| File.dirname("./#{file}") }.uniq
-
-    cmds = dirs.map do |dir|
-      echo_cmd %{mkdir -p "#{dir}"}
-    end
-
-    cmds += shared_paths.map do |file|
-      [
-        echo_cmd(%{rm -rf "./#{file}"}),
-        echo_cmd(%{ln -s "#{deploy_to}/#{shared_path}/#{file}" "./#{file}"})
-      ]
-    end
-
-    queue %{
-      echo "-----> Symlinking shared paths"
-      #{cmds.flatten.join(" &&\n")}
-    }
-  end
-
-  # ### deploy:cleanup
-  # Cleans up old releases.
-  #
-  # By default, the last 5 releases are kept on each server (though you can
-  # change this with the keep_releases setting).  All other deployed revisions
-  # are removed from the servers."
-
-  desc "Clean up old releases."
-  task :cleanup do
-    queue %{
-      echo "-----> Cleaning up old releases (keeping #{keep_releases!})"
-      #{echo_cmd %{cd "#{deploy_to!}/#{releases_path!}" || exit 15}}
-      #{echo_cmd %{count=`ls -1d [0-9]* | sort -rn | wc -l`}}
-      #{echo_cmd %{remove=$((count > #{keep_releases} ? count - #{keep_releases} : 0))}}
-      #{echo_cmd %{ls -1d [0-9]* | sort -rn | tail -n $remove | xargs rm -rf {}}}
-    }
-  end
-
-  # ### deploy:rollback
-  # Rollbacks the latest release.
-  #
-  # Changes the current link to previous release, and deletes the newest deploy release
-  # Does NOT rollback the database, use
-  #
-  #     mina "rake[db:rollback]"
-  desc "Rollbacks the latest release"
-  task :rollback => :environment do
-    queue %[echo "-----> Rolling back to previous release for instance: #{domain}"]
-
-    # Delete existing sym link and create a new symlink pointing to the previous release
-    queue %[echo -n "-----> Creating new symlink from the previous release: "]
-    queue %[ls -Art "#{deploy_to}/releases" | sort | tail -n 2 | head -n 1]
-    queue! %[ls -Art "#{deploy_to}/releases" | sort | tail -n 2 | head -n 1 | xargs -I active ln -nfs "#{deploy_to}/releases/active" "#{deploy_to}/current"]
-
-    # Remove latest release folder (current release)
-    queue %[echo -n "-----> Deleting current release: "]
-    queue %[ls -Art "#{deploy_to}/releases" | sort | tail -n 1]
-    queue! %[ls -Art "#{deploy_to}/releases" | sort | tail -n 1 | xargs -I active rm -rf "#{deploy_to}/releases/active"]
-  end
-end
-
-# ### setup
-# Sets up a site's directory structure.
-
-desc "Sets up a site."
-task :setup do
-  set_default :term_mode, :pretty
-
-  settings.deploy_to!
-
-  user = settings.user? ? "#{settings.user}" : "username"
-
-  queue %{
-    echo "-----> Setting up #{deploy_to}" && (
-      #{echo_cmd %{mkdir -p "#{deploy_to}"}} &&
-      #{echo_cmd %{chown -R `whoami` "#{deploy_to}"}} &&
-      #{echo_cmd %{chmod g+rx,u+rwx "#{deploy_to}"}} &&
-      #{echo_cmd %{cd "#{deploy_to}"}} &&
-      #{echo_cmd %{mkdir -p "#{releases_path}"}} &&
-      #{echo_cmd %{chmod g+rx,u+rwx "#{releases_path}"}} &&
-      #{echo_cmd %{mkdir -p "#{shared_path}"}} &&
-      #{echo_cmd %{chmod g+rx,u+rwx "#{shared_path}"}} &&
-      echo "" &&
-      #{echo_cmd %{ls -la "#{deploy_to}"}} &&
-      echo "" &&
-      echo "-----> Done."
-    ) || (
-      echo "! ERROR: Setup failed."
-      echo "! Ensure that the path '#{deploy_to}' is accessible to the SSH user."
-      echo "! Try doing:"
-      echo "!    sudo mkdir -p \\"#{deploy_to}\\" && sudo chown -R #{user} \\"#{deploy_to}\\""
-    )
-  }
-end
-
-# ### run[]
-# Runs a command on a server.
-#
-#     $ mina "run[tail -f logs.txt]"
-
-desc "Runs a command in the server."
-task :run, [:command] => [:environment] do |t, args|
-  command = args[:command]
-  unless command
-    puts %[You need to provide a command. Try: mina "run[ls -la]"]
-    exit 1
-  end
-
-  queue %[cd #{deploy_to!} && #{command}]
-end