Skip to content
This repository has been archived by the owner. It is now read-only.
Puma tasks for Mina (New repo https://github.com/untitledkingdom/mina-puma)
Branch: master
Clone or download
Latest commit 387ceb8 Mar 9, 2016
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib/mina
.gitignore
Gemfile
LICENSE.txt init repo Nov 29, 2013
README.md Update README.md Mar 9, 2016
Rakefile
mina-puma.gemspec Removing puma dependency Dec 10, 2014

README.md

New maintainer here: https://github.com/untitledkingdom/mina-puma

Mina Puma

Mina tasks for handle with Puma.

This gem provides several mina tasks:

mina puma:phased_restart  # Restart puma (with zero-downtime)
mina puma:restart         # Restart puma
mina puma:start           # Start puma
mina puma:stop            # Stop puma

Installation

Add this line to your application's Gemfile:

gem 'mina-puma', :require => false

And then execute:

$ bundle

Or install it yourself as:

$ gem install mina-puma

Note: by just including this gem, does not mean your development server will be Puma, for that, you need explicitly add gem 'puma' to your Gemfile.

Usage

Add this to your config/deploy.rb file:

require 'mina/puma'

Make sure the following settings are set in your config/deploy.rb:

  • deploy_to - deployment path

Make sure the following directories exists on your server:

  • shared/tmp/sockets - directory for socket files.
  • shared/tmp/pids - directory for pid files.

OR you can set other directories by setting follow variables:

  • puma_socket - puma socket file, default is shared/tmp/sockets/puma.sock
  • puma_pid - puma pid file, default shared/tmp/pids/puma.pid
  • puma_state - puma state file, default shared/tmp/sockets/puma.state
  • pumactl_socket - pumactl socket file, default shared/tmp/sockets/pumactl.sock

Then:

$ mina puma:start

Example

require 'mina/puma'

task :setup => :environment do
  # Puma needs a place to store its pid file and socket file.
  queue! %(mkdir -p "#{deploy_to}/#{shared_path}/tmp/sockets")
  queue! %(chmod g+rx,u+rwx "#{deploy_to}/#{shared_path}/tmp/sockets")
  queue! %(mkdir -p "#{deploy_to}/#{shared_path}/tmp/pids")
  queue! %(chmod g+rx,u+rwx "#{deploy_to}/#{shared_path}/tmp/pids")

  ...

end

# Add pids and sockets directories to shared paths
set :shared_paths, ['config/database.yml', 'tmp/pids', 'tmp/sockets']

task :deploy do
  deploy do
    invoke :'git:clone'
    invoke :'deploy:link_shared_paths'
    ...

    to :launch do
      ...
      invoke :'puma:phased_restart'
    end
  end
end

Contributing

  1. Fork it
  2. Create your feature branch (git checkout -b my-new-feature)
  3. Commit your changes (git commit -am 'Add some feature')
  4. Push to the branch (git push origin my-new-feature)
  5. Create new Pull Request
You can’t perform that action at this time.