{"id":23082495,"url":"https://github.com/hovancik/mina-supervisord","last_synced_at":"2026-04-30T10:33:11.741Z","repository":{"id":56883774,"uuid":"94433689","full_name":"hovancik/mina-supervisord","owner":"hovancik","description":"Supervisor wrapper for mina","archived":false,"fork":false,"pushed_at":"2020-04-28T07:01:25.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-05-02T00:56:59.709Z","etag":null,"topics":["deployment","mina","rails","ruby","supervisord"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hovancik.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null},"funding":{"github":"hovancik","patreon":"hovancik","custom":"https://www.paypal.me/janhovancik"}},"created_at":"2017-06-15T11:40:53.000Z","updated_at":"2020-04-28T07:01:27.000Z","dependencies_parsed_at":"2022-08-21T00:20:21.610Z","dependency_job_id":null,"html_url":"https://github.com/hovancik/mina-supervisord","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hovancik%2Fmina-supervisord","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hovancik%2Fmina-supervisord/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hovancik%2Fmina-supervisord/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hovancik%2Fmina-supervisord/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hovancik","download_url":"https://codeload.github.com/hovancik/mina-supervisord/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247015125,"owners_count":20869499,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["deployment","mina","rails","ruby","supervisord"],"created_at":"2024-12-16T14:53:46.260Z","updated_at":"2026-04-30T10:33:10.985Z","avatar_url":"https://github.com/hovancik.png","language":"Ruby","funding_links":["https://github.com/sponsors/hovancik","https://patreon.com/hovancik","https://www.paypal.me/janhovancik"],"categories":[],"sub_categories":[],"readme":"# Mina::Supervisord\n\nThis is a [Supervisor](http://supervisord.org/) (process control system) wrapper for [mina](https://github.com/mina-deploy/mina).\n\n## Installation\n\nAdd this line to your application's Gemfile:\n\n```ruby\ngem 'mina-supervisord', require: false\n```\n\nAnd then execute:\n\n    $ bundle\n\nOr install it yourself as:\n\n    $ gem install mina-supervisord\n\n## Usage\n\nTo restart your app during deploy you might add this to `deloy.rb`:\n\n```ruby\nrequire 'mina/supervisord'\n\ntask deploy: :environment do\n  deploy do\n    ...\n    on :launch do\n      invoke :'supervisord:restart', 'puma'\n    end\n  end\nend\n```\nTo call it as mina task, eg. to start your puma, you would run this from command line:\n\n```ruby\nbundle exec mina supervisord:start['puma']\n\n```\n\n`puma` is a supervisord [program](http://supervisord.org/running.html#adding-a-program).\n\n### Supported tasks\n- `supervisord:restart`- to restart a program (eg. `bundle exec mina supervisord:restart['program']`)\n- `supervisord:start`- to start a program (eg. `bundle exec mina supervisord:start['program']`)\n- `supervisord:stop`- to stop a program (eg. `bundle exec mina supervisord:stop['program']`)\n- `supervisord:status`- to get status of a program (eg. `bundle exec mina supervisord:status['program']`)\n- `supervisord:signal`- to send a signal to a program (eg. `bundle exec mina supervisord:signal['program,signal']`)\n#### Extra tasks\n- `supervisord:signal:or_start`- to send a signal to a program, or start it if not running (eg. `bundle exec mina supervisord:signal:or_start['program,signal']`)\n- `supervisord:restart:or_start`- to restart a program, or start it if not running (eg. `bundle exec mina supervisord:restart:or_start['program']`)\n\nYou might find these extra tasks useful when you are not sure whether your program is running.\n\nEg. when we do our deploy, we want our `puma` server to be restarted or started if not running already. To do that, we have following in our `deploy.rb`:\n\n```ruby\ndesc \"Phased restart of the application\"\ntask :phased_restart =\u003e :environment do\n  invoke :'supervisord:signal:or_start', fetch(:application_supervisor_file), \"SIGUSR1\"\nend\n```\n\n## Development\n\nAfter checking out the repo, run `bin/setup` to install dependencies. You can also run `bin/console` for an interactive prompt that will allow you to experiment.\n\nTo install this gem onto your local machine, run `bundle exec rake install`. To release a new version, update the version number in `version.rb`, and then run `bundle exec rake release`, which will create a git tag for the version, push git commits and tags, and push the `.gem` file to [rubygems.org](https://rubygems.org).\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at https://github.com/hovancik/mina-supervisord. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the [Contributor Covenant](http://contributor-covenant.org) code of conduct.\n\nDevelopment of this gem is sponsored by [Mix.it](http://mix.it).\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](http://opensource.org/licenses/MIT).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhovancik%2Fmina-supervisord","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhovancik%2Fmina-supervisord","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhovancik%2Fmina-supervisord/lists"}