aaronpederson / ansible-upstart

Ansible (meta-) Role for generating upstart scripts

ansible-upstart

Upstart is an event-based replacement for the /sbin/init daemon which handles starting of tasks and services during boot, stopping them during shutdown and supervising them while the system is running.

Tunables

• upstart_runtime_root (string) - Directory for runtime data
• upstart_pidfile_path (string) - Path for pidfile
• upstart_user (string) - User to run as
• upstart_group (string) - Group to run as
• upstart_name (string) - Name of the process
• upstart_description (string) - Description of the process
• upstart_start_on (list) - Events to start on
• upstart_stop_on (list): - Events to stop on
• upstart_file_descriptor_limit (integer) - File descriptor limit for the process
• upstart_environment (list) - Environment data
• upstart_environment_global (boolean) - Should env vars be global to all upstart scripts?
• upstart_pre_start (list) - Commands to run prior to starting
• upstart_pre_stop (list) - Commands to run before stopping (useful for docker)
• upstart_post_stop (list) - Commands to run after stopping
• upstart_script (list) - Script to run
• upstart_respawn (boolean) - Should you respawn process on accidental shutdown?
• upstart_respawn_limit (boolean) - Limit respawning the process up to $count times within an $interval second interval?
• upstart_respawn_limit_count (integer) - upstart_respawn_limit $count mentioned above
• upstart_respawn_limit_interval (integer) - upstart_respawn_limit $interval mentioned above
• upstart_exec_path (string) - A single command to execute
• upstart_exec_flags (list) - Parameters to be passed to the command
• upstart_log_root (string) - Directory for logs
• upstart_log_path (string) - Path for log file
• upstart_capture_errors (boolean) - Redirect STDERR to STDOUT?
• upstart_state (present|absent) - Install or remove init script
• upstart_use_logrotate (boolean) - Depend on telusdigital.logrotate

Dependencies

• telusdigital.logrotate (optional, see upstart_use_logrotate)

Example Playbook

- hosts: servers
  roles:
     - role: telusdigital.upstart
       upstart_name: nginx
       upstart_description: "Upstart for Nginx HTTP Server"

Contributors

• Chris Olstrom | e-mail | Twitter
• Aaron Pederson
• Justin Scott
• Steven Harradine
• Ryan Mills