from-scratch 0.3.0 → 0.5.0

data/cookbooks/runit/libraries/resource_runit_service.rb

@@ -0,0 +1,267 @@
+#
+# Cookbook Name:: runit
+# Provider:: service
+#
+# Copyright 2011, Joshua Timberman
+# Copyright 2011, Chef Software, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+require 'chef/resource'
+require 'chef/resource/service'
+
+class Chef
+  class Resource
+    # Missing top-level class documentation comment
+    class RunitService < Chef::Resource::Service
+      def initialize(name, run_context = nil)
+        super
+        runit_node = runit_attributes_from_node(run_context)
+        @resource_name = :runit_service
+        @provider = Chef::Provider::RunitService
+        @supports = { restart: true, reload: true, status: true }
+        @action = :enable
+        @allowed_actions = [:nothing, :start, :stop, :enable, :disable, :restart, :reload, :status, :once, :hup, :cont, :term, :kill, :up, :down, :usr1, :usr2, :create]
+
+        # sv_bin, sv_dir, service_dir and lsb_init_dir may have been set in the
+        # node attributes
+        @sv_bin = runit_node[:sv_bin] || '/usr/bin/sv'
+        @sv_dir = runit_node[:sv_dir] || '/etc/sv'
+        @service_dir = runit_node[:service_dir] || '/etc/service'
+        @lsb_init_dir = runit_node[:lsb_init_dir] || '/etc/init.d'
+
+        @control = []
+        @options = {}
+        @env = {}
+        @log = true
+        @cookbook = nil
+        @check = false
+        @start_down = false
+        @delete_downfile = false
+        @finish = false
+        @owner = nil
+        @group = nil
+        @enabled = false
+        @running = false
+        @default_logger = false
+        @restart_on_update = true
+        @run_template_name = @service_name
+        @log_template_name = @service_name
+        @check_script_template_name = @service_name
+        @finish_script_template_name = @service_name
+        @control_template_names = {}
+        @status_command = "#{@sv_bin} status #{@service_dir}"
+        @sv_templates = true
+        @sv_timeout = nil
+        @sv_verbose = false
+        @log_dir = ::File.join('/var/log/', @service_name)
+        @log_size = nil
+        @log_num = nil
+        @log_min = nil
+        @log_timeout = nil
+        @log_processor = nil
+        @log_socket = nil
+        @log_prefix = nil
+        @log_config_append = nil
+
+        #
+        # Backward Compat Hack
+        #
+        # This ensures a 'service' resource exists for all 'runit_service' resources.
+        # This should allow all recipes using the previous 'runit_service' definition to
+        # continue operating.
+        #
+        unless run_context.nil?
+          service_dir_name = ::File.join(@service_dir, @name)
+          @service_mirror = Chef::Resource::Service.new(name, run_context)
+          @service_mirror.provider(Chef::Provider::Service::Simple)
+          @service_mirror.supports(@supports)
+          @service_mirror.start_command("#{@sv_bin} start #{service_dir_name}")
+          @service_mirror.stop_command("#{@sv_bin} stop #{service_dir_name}")
+          @service_mirror.restart_command("#{@sv_bin} restart #{service_dir_name}")
+          @service_mirror.status_command("#{@sv_bin} status #{service_dir_name}")
+          @service_mirror.action(:nothing)
+          run_context.resource_collection.insert(@service_mirror)
+        end
+      end
+
+      def sv_bin(arg = nil)
+        set_or_return(:sv_bin, arg, kind_of: [String])
+      end
+
+      def sv_dir(arg = nil)
+        set_or_return(:sv_dir, arg, kind_of: [String, FalseClass])
+      end
+
+      def sv_timeout(arg = nil)
+        set_or_return(:sv_timeout, arg, kind_of: [Fixnum])
+      end
+
+      def sv_verbose(arg = nil)
+        set_or_return(:sv_verbose, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def service_dir(arg = nil)
+        set_or_return(:service_dir, arg, kind_of: [String])
+      end
+
+      def lsb_init_dir(arg = nil)
+        set_or_return(:lsb_init_dir, arg, kind_of: [String])
+      end
+
+      def control(arg = nil)
+        set_or_return(:control, arg, kind_of: [Array])
+      end
+
+      def options(arg = nil)
+        default_opts = @env.empty? ? @options : @options.merge(env_dir: ::File.join(@sv_dir, @service_name, 'env'))
+
+        merged_opts = arg.respond_to?(:merge) ? default_opts.merge(arg) : default_opts
+
+        set_or_return(
+          :options,
+          merged_opts,
+          kind_of: [Hash],
+          default: default_opts
+        )
+      end
+
+      def env(arg = nil)
+        set_or_return(:env, arg, kind_of: [Hash])
+      end
+
+      ## set log to current instance value if nothing is passed.
+      def log(arg = @log)
+        set_or_return(:log, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def cookbook(arg = nil)
+        set_or_return(:cookbook, arg, kind_of: [String])
+      end
+
+      def finish(arg = nil)
+        set_or_return(:finish, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def check(arg = nil)
+        set_or_return(:check, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def start_down(arg = nil)
+        set_or_return(:start_down, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def delete_downfile(arg = nil)
+        set_or_return(:delete_downfile, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def owner(arg = nil)
+        set_or_return(:owner, arg, regex: [Chef::Config[:user_valid_regex]])
+      end
+
+      def group(arg = nil)
+        set_or_return(:group, arg, regex: [Chef::Config[:group_valid_regex]])
+      end
+
+      def default_logger(arg = nil)
+        set_or_return(:default_logger, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def restart_on_update(arg = nil)
+        set_or_return(:restart_on_update, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def run_template_name(arg = nil)
+        set_or_return(:run_template_name, arg, kind_of: [String])
+      end
+      alias_method :template_name, :run_template_name
+
+      def log_template_name(arg = nil)
+        set_or_return(:log_template_name, arg, kind_of: [String])
+      end
+
+      def check_script_template_name(arg = nil)
+        set_or_return(:check_script_template_name, arg, kind_of: [String])
+      end
+
+      def finish_script_template_name(arg = nil)
+        set_or_return(:finish_script_template_name, arg, kind_of: [String])
+      end
+
+      def control_template_names(arg = nil)
+        set_or_return(
+          :control_template_names,
+          arg,
+          kind_of: [Hash],
+          default: set_control_template_names
+        )
+      end
+
+      def set_control_template_names
+        @control.each do |signal|
+          @control_template_names[signal] ||= @service_name
+        end
+        @control_template_names
+      end
+
+      def sv_templates(arg = nil)
+        set_or_return(:sv_templates, arg, kind_of: [TrueClass, FalseClass])
+      end
+
+      def log_dir(arg = nil)
+        set_or_return(:log_dir, arg, kind_of: [String])
+      end
+
+      def log_size(arg = nil)
+        set_or_return(:log_size, arg, kind_of: [Integer])
+      end
+
+      def log_num(arg = nil)
+        set_or_return(:log_num, arg, kind_of: [Integer])
+      end
+
+      def log_min(arg = nil)
+        set_or_return(:log_min, arg, kind_of: [Integer])
+      end
+
+      def log_timeout(arg = nil)
+        set_or_return(:log_timeout, arg, kind_of: [Integer])
+      end
+
+      def log_processor(arg = nil)
+        set_or_return(:log_processor, arg, kind_of: [String])
+      end
+
+      def log_socket(arg = nil)
+        set_or_return(:log_socket, arg, kind_of: [String, Hash])
+      end
+
+      def log_prefix(arg = nil)
+        set_or_return(:log_prefix, arg, kind_of: [String])
+      end
+
+      def log_config_append(arg = nil)
+        set_or_return(:log_config_append, arg, kind_of: [String])
+      end
+
+      def runit_attributes_from_node(run_context)
+        if run_context && run_context.node && run_context.node[:runit]
+          run_context.node[:runit]
+        else
+          {}
+        end
+      end
+    end
+  end
+end

data/cookbooks/runit/metadata.json

@@ -0,0 +1,50 @@
+{
+  "name": "runit",
+  "description": "Installs runit and provides runit_service definition",
+  "long_description": "runit Cookbook\n==============\nInstalls runit and provides the `runit_service` service resource for managing processes (services) under runit.\n\nThis cookbook does not use runit to replace system init, nor are ther plans to do so.\n\nFor more information about runit:\n\n- http://smarden.org/runit/\n\n#### A note regarding versions 1.7.0 and 1.7.2\n\nWith the benefit of hindsight we can say that the changes contained version 1.7.0 merited a major version number change, and that version 1.7.2 contains some still unresolved regressions compared to 1.6.0. Please be sure to test this new version for compatibility with your systems before upgrading to version 1.7.\n\nSee [issue #144](https://github.com/hw-cookbooks/runit/issues/144) for some notes on how these versions behaved unexpectedly in one user's environment.\n\nRequirements\n------------\n### Platforms\n- Debian/Ubuntu\n- Gentoo\n- RHEL\n\n### Cookbooks\n- packagecloud (for RHEL)\n\nAttributes\n----------\nSee `attributes/default.rb` for defaults generated per platform.\n\n- `node['runit']['sv_bin']` - Full path to the `sv` binary.\n- `node['runit']['chpst_bin']` - Full path to the `chpst` binary.\n- `node['runit']['service_dir']` - Full path to the default \"services\" directory where enabled services are linked.\n- `node['runit']['sv_dir']` - Full path to the directory where service lives, which gets linked to `service_dir`.\n- `node['runit']['lsb_init_dir']` - Full path to the directory where the LSB-compliant init script interface will be created.\n- `node['runit']['start']` - Command to start the runsvdir service\n- `node['runit']['stop]` - Command to stop the runsvdir service\n- `node['runit']['reload']` - Command to reload the runsvdir service\n\n### Optional Attributes for RHEL systems\n\n- `node['runit']['prefer_local_yum']` - If `true`, assumes that a `runit` package is available on an already configured local yum repository. By default, the recipe installs the `runit` package from a Package Cloud repository (see below). This is set to the value of `node['runit']['use_package_from_yum']` for backwards compatibility, but otherwise defaults to `false`.\n\nRecipes\n-------\n### default\nThe default recipe installs runit and starts `runsvdir` to supervise the services in runit's service directory (e.g., `/etc/service`).\n\nOn RHEL-family systems, it will install the runit RPM using [Ian Meyer's Package Cloud repository](https://packagecloud.io/imeyer/runit) for runit. This replaces the previous functionality where the RPM was build using his [runit RPM SPEC](https://github.com/imeyer/runit-rpm). However, if the attribute `node['runit']['prefer_local_yum']` is set to `true`, the packagecloud repository creation will be skipped and it is assumed that a `runit` package is available on an otherwise configured (outside this cookbook) local repository.\n\nOn Debian family systems, the runit packages are maintained by the runit author, Gerrit Pape, and the recipe will use that for installation.\n\nOn Gentoo, the runit ebuild package is installed.\n\nResource/Provider\n-----------------\nThis cookbook has a resource, `runit_service`, for managing services under runit. This service subclasses the Chef `service` resource.\n\n**This resource replaces the runit_service definition. See the CHANGELOG.md file in this cookbook for breaking change information and any actions you may need to take to update cookbooks using runit_service.**\n\n### Actions\n- **enable** - enables the service, creating the required run scripts and symlinks. This is the default action.\n- **start** - starts the service with `sv start`\n- **stop** - stops the service with `sv stop`\n- **disable** - stops the service with `sv down` and removes the service symlink\n- **create** - create the service directory, but don't enable the service with symlink\n- **restart** - restarts the service with `sv restart`\n- **reload** - reloads the service with `sv force-reload`\n- **once** - starts the service with `sv once`.\n- **hup** - sends the `HUP` signal to the service with `sv hup`\n- **cont** - sends the `CONT` signal to the service\n- **term** - sends the `TERM` signal to the service\n- **kill** - sends the `KILL` signal to the service\n- **up** - starts the service with `sv up`\n- **down** - downs the service with `sv down`\n- **usr1** - sends the `USR1` signal to the service with `sv 1`\n- **usr2** - sends the `USR2` signal to the service with `sv 2`\n\nService management actions are taken with runit's \"`sv`\" program.\n\nRead the `sv(8)` [man page](http://smarden.org/runit/sv.8.html) for more information on the `sv` program.\n\n### Parameter Attributes\n\nThe first three parameters, `sv_dir`, `service_dir`, and `sv_bin` will attempt to use the corresponding node attributes, and fall back to hardcoded default values that match the settings used on Debian platform systems.\n\nMany of these parameters are only used in the `:enable` action.\n\n- **sv_dir** - The base \"service directory\" for the services managed by\n   the resource. By default, this will attempt to use the\n   `node['runit']['sv_dir']` attribute, and falls back to `/etc/sv`.\n- **service_dir** - The directory where services are symlinked to be\n   supervised by `runsvdir`. By default, this will attempt to use the\n   `node['runit']['service_dir']` attribute, and falls back to\n   `/etc/service`.\n- **lsb_init_dir** - The directory where an LSB-compliant init script\n   interface will be created. By default, this will attempt to use the\n   `node['runit']['lsb_init_dir']` attribute, and falls back to\n   `/etc/init.d`.\n- **sv_bin** - The path to the `sv` program binary. This will attempt\n    to use the `node['runit']['sv_bin']` attribute, and falls back to\n    `/usr/bin/sv`.\n- **service_name** - *Name attribute*. The name of the service. This\n   will be used in the directory of the managed service in the\n   `sv_dir` and `service_dir`.\n- **sv_timeout** - Override the default `sv` timeout of 7 seconds.\n- **sv_verbose** - Whether to enable `sv` verbose mode. Default is\n   `false`.\n- **sv_templates** - If true, the `:enable` action will create the\n    service directory with the appropriate templates. Default is\n    `true`. Set this to `false` if the service has a package that\n    provides its own service directory. See __Usage__ examples.\n- **options** - Options passed as variables to templates, for\n   compatibility with legacy runit service definition. Default is an\n   empty hash.\n- **env** - A hash of environment variables with their values as content\n  used in the service's `env` directory. Default is an empty hash. When\n  this hash is non-empty, the contents of the runit service's `env`\n  directory will be managed by Chef in order to conform to the declared\n  state.\n- **log** - Whether to start the service's logger with svlogd, requires\n   a template `sv-service_name-log-run.erb` to configure the log's run\n   script. Default is true.\n- **default_logger** - Whether a default `log/run` script should be set\n   up. If true, the default content of the run script will use\n   `svlogd` to write logs to `/var/log/service_name`. Default is false.\n- **log_dir** - The directory where the `svlogd` log service will run.\n  Used when `default_logger` is `true`.  Default is `/var/log/service_name`\n- **log_size** - The maximum size a log file can grow to before it is\n  automatically rotated.  See svlogd(8) for the default value.\n- **log_num** - The maximum number of log files that will be retained\n  after rotation.  See svlogd(8) for the default value.\n- **log_min** - The minimum number of log files that will be retained\n  after rotation (if svlogd cannot create a new file and the minimum\n  has not been reached, it will block).  Default is no minimum.\n- **log_timeout** - The maximum age a log file can get to before it is\n  automatically rotated, whether it has reached `log_size` or not.\n  Default is no timeout.\n- **log_processor** - A string containing a path to a program that\n  rotated log files will be fed through.  See the **PROCESSOR** section\n  of svlogd(8) for details.  Default is no processor.\n- **log_socket** - An string containing an IP:port pair identifying a UDP\n   socket that log lines will be copied to.  Default is none.\n- **log_prefix** - A string that will be prepended to each line as it\n  is logged.  Default is no prefix.\n- **log_config_append** - A string containing optional additional lines to add\n  to the log service configuration.  See svlogd(8) for more details.\n- **cookbook** - A cookbook where templates are located instead of\n   where the resource is used. Applies for all the templates in the\n   `enable` action.\n- **check** - whether the service has a check script, requires a\n   template `sv-service_name-check.erb`\n- **finish** - whether the service has a finish script, requires a\n   template `sv-service_name-finish.erb`\n- **control** - An array of signals to customize control of the service,\n   see [runsv man page](http://smarden.org/runit/runsv.8.html) on how\n   to use this. This requires that each template be created with the\n   name `sv-service_name-signal.erb`.\n- **owner** - user that should own the templates created to enable the\n   service\n- **group** - group that should own the templates created to enable the\n   service\n- **run_template_name** - alternate filename of the run run script to\n   use replacing `service_name`.\n- **log_template_name** - alternate filename of the log run script to\n   use replacing `service_name`.\n- **check_script_template_name** - alternate filename of the check\n   script to use, replacing `service_name`.\n- **finish_script_template_name** - alternate filename of the finish\n   script to use, replacing `service_name`.\n- **control_template_names** - a hash of control signals (see *control*\n   above) and their alternate template name(s) replacing\n   `service_name`.\n- **status_command** - The command used to check the status of the\n   service to see if it is enabled/running (if it's running, it's\n   enabled). This hardcodes the location of the sv program to\n   `/usr/bin/sv` due to the aforementioned cookbook load order.\n- **restart_on_update** - Whether the service should be restarted when\n    the run script is updated. Defaults to `true`. Set to `false` if\n    the service shouldn't be restarted when the run script is updated.\n- **start_down** - Set the default state of the runit service to 'down' by creating\n    `<sv_dir>/down` file\n- **delete_downfile** - Delete previously created `<sv_dir>/down` file\n\nUnlike previous versions of the cookbook using the `runit_service` definition, the `runit_service` resource can be notified. See __Usage__ examples below.\n\n\nUsage\n-----\nTo get runit installed on supported platforms, use `recipe[runit]`. Once it is installed, use the `runit_service` resource to set up services to be managed by runit.\n\nIn order to use the `runit_service` resource in your cookbook(s), each service managed will also need to have `sv-service_name-run.erb` and `sv-service_name-log-run.erb` templates created. If the `log` parameter is false, the log run script isn't created. If the `log` parameter is true, and `default_logger` is also true, the log run\nscript will be created with the default content:\n\n```bash\n#!/bin/sh\nexec svlogd -tt /var/log/service_name\n```\n\n### Examples\nThese are example use cases of the `runit_service` resource described above. There are others in the `runit_test` cookbook that is included in the [git repository](https://github.com/hw-cookbooks/runit).\n\n**Default Example**\n\nThis example uses all the defaults in the `:enable` action to set up the service.\n\nWe'll set up `chef-client` to run as a service under runit, such as is done in the `chef-client` cookbook. This example will be more simple than in that cookbook. First, create the required run template, `chef-client/templates/default/sv-chef-client-run.erb`.\n\n```bash\n#!/bin/sh\nexec 2>&1\nexec /usr/bin/env chef-client -i 1800 -s 30\n```\n\nThen create the required log/run template, `chef-client/templates/default/sv-chef-client-log-run.erb`.\n\n```bash\n#!/bin/sh\nexec svlogd -tt ./main\n```\n\n__Note__ This will cause output of the running process to go to `/etc/sv/chef-client/log/main/current`. Some people may not like this, see the following example. This is preserved for compatibility reasons.\n\nFinally, set up the service in the recipe with:\n\n```ruby\nrunit_service \"chef-client\"\n```\n\n**Default Logger Example**\n\nTo use a default logger with svlogd which will log to `/var/log/chef-client/current`, instead, use the `default_logger` option.\n\n```ruby\nrunit_service \"chef-client\" do\n  default_logger true\nend\n```\n\n**No Log Service**\n\nIf there isn't an appendant log service, set `log` to false, and the log/run script won't be created.\n\n```ruby\nrunit_service \"no-svlog\" do\n  log false\nend\n```\n\n**Check Script**\n\nTo create a service that has a check script in its service directory, set the `check` parameter to `true`, and create a `sv-checker-check.erb` template.\n\n```ruby\nrunit_service \"checker\" do\n  check true\nend\n```\n\nThis will create `/etc/sv/checker/check`.\n\n**Finish Script**\n\nTo create a service that has a finish script in its service directory, set the `finish` parameter to `true`, and create a `sv-finisher-finish.erb` template.\n\n```ruby\nrunit_service \"finisher\" do\n  finish true\nend\n```\n\nThis will create `/etc/sv/finisher/finish`.\n\n**Alternate service directory**\n\nIf the service directory for the managed service isn't the `sv_dir` (`/etc/sv`), then specify it:\n\n```ruby\nrunit_service \"custom_service\" do\n  sv_dir \"/etc/custom_service/runit\"\nend\n```\n\n**No Service Directory**\n\nIf the service to manage has a package that provides its service directory, such as `git-daemon` on Debian systems, set `sv_templates` to false.\n\n```ruby\npackage \"git-daemon-run\"\n\nrunit_service \"git-daemon\" do\n  sv_templates false\nend\n```\n\nThis will create the service symlink in `/etc/service`, but it will not manage any templates in the service directory.\n\n**User Controlled Services**\n\nTo set up services controlled by a non-privileged user, we follow the recommended configuration in the [runit documentation](http://smarden.org/runit/faq.html#user) (Is it possible to allow a user other than root to control a service?).\n\nSuppose the user's name is floyd, and floyd wants to run floyds-app. Assuming that the floyd user and group are already managed with Chef, create a `runsvdir-floyd` runit_service.\n\n```ruby\nrunit_service \"runsvdir-floyd\"\n```\n\nCreate the `sv-runsvdir-floyd-log-run.erb` template, or add `log false`. Also create the `sv-runsvdir-floyd-run.erb` with the following content:\n\n```bash\n#!/bin/sh\nexec 2>&1\nexec chpst -ufloyd runsvdir /home/floyd/service\n```\n\nNext, create the `runit_service` resource for floyd's app:\n\n```ruby\nrunit_service \"floyds-app\" do\n  sv_dir \"/home/floyd/sv\"\n  service_dir \"/home/floyd/service\"\n  owner \"floyd\"\n  group \"floyd\"\nend\n```\n\nAnd now floyd can manage the service with sv:\n\n```text\n$ id\nuid=1000(floyd) gid=1001(floyd) groups=1001(floyd)\n$ sv stop /home/floyd/service/floyds-app/\nok: down: /home/floyd/service/floyds-app/: 0s, normally up\n$ sv start /home/floyd/service/floyds-app/\nok: run: /home/floyd/service/floyds-app/: (pid 5287) 0s\n$ sv status /home/floyd/service/floyds-app/\nrun: /home/floyd/service/floyds-app/: (pid 5287) 13s; run: log: (pid 4691) 726s\n```\n\n**Options**\n\nNext, let's set up memcached under runit with some additional options using the `options` parameter. First, the `memcached/templates/default/sv-memcached-run.erb` template:\n\n```bash\n#!/bin/sh\nexec 2>&1\nexec chpst -u <%= @options[:user] %> /usr/bin/memcached -v -m <%= @options[:memory] %> -p <%= @options[:port] %>\n```\n\nNote that the script uses `chpst` (which comes with runit) to set the user option, then starts memcached on the specified memory and port (see below).\n\nThe log/run template, `memcached/templates/default/sv-memcached-log-run.erb`:\n\n```bash\n#!/bin/sh\nexec svlogd -tt ./main\n```\n\nFinally, the `runit_service` in our recipe:\n\n```ruby\nrunit_service \"memcached\" do\n  options({\n    :memory => node[:memcached][:memory],\n    :port => node[:memcached][:port],\n    :user => node[:memcached][:user]\n  }.merge(params))\nend\n```\n\nThis is where the user, port and memory options used in the run template are used.\n\n**Notifying Runit Services**\n\nIn previous versions of this cookbook where the definition was used, it created a `service` resource that could be notified. With the `runit_service` resource, recipes need to use the full resource name.\n\nFor example:\n\n```ruby\nrunit_service \"my-service\"\n\ntemplate \"/etc/my-service.conf\" do\n  notifies :restart, \"runit_service[my-service]\"\nend\n```\n\nBecause the resource implements actions for various commands that `sv` can send to the service, any of those actions could be used for notification. For example, `chef-client` supports triggering a Chef run with a USR1 signal.\n\n```ruby\ntemplate \"/tmp/chef-notifier\" do\n  notifies :usr1, \"runit_service[chef-client]\"\nend\n```\n\nFor older implementations of services that used `runit_service` as a definition, but may support alternate service styles, use a conditional, such as based on an attribute:\n\n```ruby\nservice_to_notify = case node['nginx']['init_style']\n                    when \"runit\"\n                      \"runit_service[nginx]\"\n                    else\n                      \"service[nginx]\"\n                    end\n\ntemplate \"/etc/nginx/nginx.conf\" do\n  notifies :restart, service_to_notify\nend\n```\n\n**More Examples**\n\nFor more examples, see the `runit_test` cookbook's `service` recipe in the [git repository](https://github.com/hw-cookbooks/runit).\n\n\nLicense & Authors\n-----------------\n- Author:: Adam Jacob <adam@chef.io>\n- Author:: Joshua Timberman <joshua@chef.io>\n- Author:: Sean OMeara <sean@chef.io>\n\n```text\nCopyright:: 2008-2016, Chef Software, Inc\n\nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n\n    http://www.apache.org/licenses/LICENSE-2.0\n\nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.\n```\n",
+  "maintainer": "Heavy Water Operations, LLC.",
+  "maintainer_email": "support@hw-ops.com",
+  "license": "Apache 2.0",
+  "platforms": {
+    "ubuntu": ">= 0.0.0",
+    "debian": ">= 0.0.0",
+    "gentoo": ">= 0.0.0",
+    "centos": ">= 0.0.0",
+    "redhat": ">= 0.0.0",
+    "amazon": ">= 0.0.0",
+    "scientific": ">= 0.0.0",
+    "oracle": ">= 0.0.0",
+    "enterpriseenterprise": ">= 0.0.0"
+  },
+  "dependencies": {
+    "packagecloud": ">= 0.0.0"
+  },
+  "recommendations": {
+
+  },
+  "suggestions": {
+
+  },
+  "conflicting": {
+
+  },
+  "providing": {
+
+  },
+  "replacing": {
+
+  },
+  "attributes": {
+
+  },
+  "groupings": {
+
+  },
+  "recipes": {
+    "runit": "Installs and configures runit"
+  },
+  "version": "1.7.4",
+  "source_url": "",
+  "issues_url": "",
+  "privacy": false
+}

data/cookbooks/runit/recipes/default.rb

@@ -0,0 +1,91 @@
+#
+# Cookbook Name:: runit
+# Recipe:: default
+#
+# Copyright 2008-2010, Chef Software, Inc.
+#
+# Licensed under the Apache License, Version 2.0 (the 'License');
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#     http://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an 'AS IS' BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+service 'runit' do
+  action :nothing
+end
+
+execute 'start-runsvdir' do
+  command value_for_platform(
+    'debian' => { 'default' => 'runsvdir-start' },
+    'ubuntu' => { 'default' => 'start runsvdir' },
+    'gentoo' => { 'default' => '/etc/init.d/runit-start start' }
+  )
+  action :nothing
+end
+
+execute 'runit-hup-init' do
+  command 'telinit q'
+  only_if 'grep ^SV /etc/inittab'
+  action :nothing
+end
+
+case node['platform_family']
+when 'rhel', 'fedora'
+
+  packagecloud_repo 'imeyer/runit' unless node['runit']['prefer_local_yum']
+  package 'runit'
+
+  if node['platform_version'].to_i == 7
+    service 'runsvdir-start' do
+      action [:start, :enable]
+    end
+  end
+
+when 'debian', 'gentoo'
+
+  if platform?('gentoo')
+    template '/etc/init.d/runit-start' do
+      source 'runit-start.sh.erb'
+      mode 0755
+    end
+
+    service 'runit-start' do
+      action :nothing
+    end
+  end
+
+  package 'runit' do
+    action :install
+    response_file 'runit.seed' if platform?('ubuntu', 'debian')
+    notifies value_for_platform(
+      'debian' => { '4.0' => :run, 'default' => :nothing },
+      'ubuntu' => {
+        'default' => :nothing,
+        '9.04' => :run,
+        '8.10' => :run,
+        '8.04' => :run },
+      'gentoo' => { 'default' => :run }
+    ), 'execute[start-runsvdir]', :immediately
+    notifies value_for_platform(
+      'debian' => { 'squeeze/sid' => :run, 'default' => :nothing },
+      'default' => :nothing
+    ), 'execute[runit-hup-init]', :immediately
+    notifies :enable, 'service[runit-start]' if platform?('gentoo')
+  end
+
+  if node['platform'] =~ /ubuntu/i && node['platform_version'].to_f <= 8.04
+    cookbook_file '/etc/event.d/runsvdir' do
+      source 'runsvdir'
+      mode 0644
+      notifies :run, 'execute[start-runsvdir]', :immediately
+      only_if { ::File.directory?('/etc/event.d') }
+    end
+  end
+end

data/cookbooks/runit/templates/debian/init.d.erb

@@ -0,0 +1,66 @@
+#!/bin/sh
+### BEGIN INIT INFO
+# Provides:          <%= @name %>
+# Required-Start:
+# Required-Stop:
+# Default-Start:
+# Default-Stop:
+# Short-Description: initscript for runit-managed <%= @name %> service
+### END INIT INFO
+
+# Author: Chef Software, Inc. <cookbooks@chef.io>
+
+PATH=/sbin:/usr/sbin:/bin:/usr/bin
+DESC="runit-managed <%= @name %>"
+NAME=<%= @name %>
+RUNIT=<%= @sv_bin %>
+SCRIPTNAME=<%= @init_dir %>$NAME
+
+# Exit if runit is not installed
+[ -x $RUNIT ] || exit 0
+
+# Load the VERBOSE setting and other rcS variables
+. /lib/init/vars.sh
+
+# Define LSB log_* functions.
+# Depend on lsb-base (>= 3.0-6) to ensure that this file is present.
+. /lib/lsb/init-functions
+
+
+case "$1" in
+  start)
+        [ "$VERBOSE" != no ] && log_daemon_msg "Starting $DESC " "$NAME"
+        $RUNIT start $NAME
+        [ "$VERBOSE" != no ] && log_end_msg $?
+        ;;
+  stop)
+        [ "$VERBOSE" != no ] && log_daemon_msg "Stopping $DESC" "$NAME"
+        $RUNIT stop $NAME
+        [ "$VERBOSE" != no ] && log_end_msg $?
+        ;;
+  status)
+        $RUNIT status $NAME && exit 0 || exit $?
+        ;;
+  reload)
+        [ "$VERBOSE" != no ] && log_daemon_msg "Reloading $DESC" "$NAME"
+        $RUNIT reload $NAME
+        [ "$VERBOSE" != no ] && log_end_msg $?
+        ;;
+  force-reload)
+        [ "$VERBOSE" != no ] && log_daemon_msg "Force reloading $DESC" "$NAME"
+        $RUNIT force-reload $NAME
+        [ "$VERBOSE" != no ] && log_end_msg $?
+        ;;
+  restart)
+        [ "$VERBOSE" != no ] && log_daemon_msg "Restarting $DESC" "$NAME"
+        $RUNIT restart $NAME
+        [ "$VERBOSE" != no ] && log_end_msg $?
+        ;;
+  *)
+        echo "Usage: $SCRIPTNAME {start|stop|status|reload|force-reload|restart}" >&2
+        exit 3
+        ;;
+esac
+
+:
+