# Custom Settings

Jobly comes bundled with Sting, which provides you with a settings helper that lets you use custom YAML files for configuring your jobs.

1. Place settings.yml in the config folder.
2. Optionally, place additional settings.<environment>.yml (for example settings.production.yml) files for each of your environments. These files will be loaded based on the JOBLY_ENVIRONMENT configuration.

Before the YAML files are loaded, they are evaluated with ERB, so you can use Ruby code in them (for example, to load environment variables):

host: localhost
port: <%= ENV['PORT'] || 3000 %>

Your settings*.yml files can use the extends key to load and merge additional YAML files:

extends: some-other-file.yml
host: localhost

• The .yml extension is optional.
• You may extend either a single file or an array of files.

This functionality is provided by ExtendedYAML.

Your jobs will have access to a settings object:

class Push < Jobly::Job
  def execute
    puts settings.host
  end
end

To have the settings object available to other (non Jobly::Job) classes, include the Jobly::Settings module (or the more inclusive Jobly::Helpers module).

class Docker
  include Jobly::Settings
  
  def pull
    puts settings.docker_registry
  end
end

See the Settings Example for mode details: