Sha256: 14577924f27db4caffaea543c6f2e53b9ac752f77092d73135150e74b197824c

Contents?: true

Size: 1.71 KB

Versions: 53

Compression:

Stored size: 1.71 KB

Contents

# Puma daemon service

Init script to manage multiple Puma servers on the same box using start-stop-daemon.

## Installation 

    # Copy the init script to services directory 
    sudo cp puma /etc/init.d
    sudo chmod +x /etc/init.d/puma
    
    # Make it start at boot time. 
    sudo update-rc.d -f puma defaults

    # Copy the Puma runner to an accessible location
    sudo cp run-puma /usr/local/bin
    sudo chmod +x /usr/local/bin/run-puma

    # Create an empty configuration file
    sudo touch /etc/puma.conf

## Managing the jungle 

Puma apps are held in /etc/puma.conf by default. It's mainly a CSV file and every line represents one app. Here's the syntax:

    app-path,user,config-file-path,log-file-path

You can add an instance by editing the file or running the following command:

    sudo /etc/init.d/puma add /path/to/app user /path/to/app/config/puma.rb /path/to/app/config/log/puma.log

The config and log paths are optional parameters and default to:

* config: /path/to/app/*config/puma.rb*
* log: /path/to/app/*config/puma.log*

To remove an app, simply delete the line from the config file or run:

    sudo /etc/init.d/puma remove /path/to/app

The command will make sure the Puma instance stops before removing it from the jungle.

## Assumptions 

* The script expects a temporary folder named /path/to/app/*tmp/puma* to exist. Create it if it's not there by default.
The pid and state files should live there and must be called: *tmp/puma/pid* and *tmp/puma/state*.
You can change those if you want but you'll have to adapt the script for it to work.

* Here's what a minimal app's config file should have:

```
pidfile "/path/to/app/tmp/puma/pid"
state_path "/path/to/app/tmp/puma/state"
activate_control_app
```

Version data entries

53 entries across 53 versions & 2 rubygems

Version Path
puma-2.8.1-java tools/jungle/init.d/README.md
puma-2.8.1 tools/jungle/init.d/README.md
puma-2.8.0-java tools/jungle/init.d/README.md
puma-2.8.0 tools/jungle/init.d/README.md
mango-0.8.0 vendor/bundler/ruby/2.1.0/gems/puma-2.7.1/tools/jungle/init.d/README.md
mango-0.7.1 vendor/bundler/ruby/2.0.0/gems/puma-2.6.0/tools/jungle/init.d/README.md
puma-2.7.1-java tools/jungle/init.d/README.md
puma-2.7.1 tools/jungle/init.d/README.md
puma-2.7.0-java tools/jungle/init.d/README.md
puma-2.7.0 tools/jungle/init.d/README.md
mango-0.7.0 vendor/bundler/ruby/2.0.0/gems/puma-2.6.0/tools/jungle/init.d/README.md
puma-2.6.0-java tools/jungle/init.d/README.md
puma-2.6.0 tools/jungle/init.d/README.md
puma-2.5.1-java tools/jungle/init.d/README.md
puma-2.5.1 tools/jungle/init.d/README.md
puma-2.5.0-java tools/jungle/init.d/README.md
puma-2.5.0 tools/jungle/init.d/README.md
puma-2.4.1-java tools/jungle/init.d/README.md
puma-2.4.1 tools/jungle/init.d/README.md
puma-2.4.0-java tools/jungle/init.d/README.md