Description

Installs rundeck and configure as needed

Requirements

Platform:

• Chef >= 12.1.0
• Centos

Cookbooks:

• yum
• java
• rundeck-bridge (Suggested but not required)
• rundeck-node (Suggested but not required)

Attributes

Recipes

• rundeck-server::install
• rundeck-server::config
• rundeck-server::install_cli - Installs the Rundeck CLI - Only use for Rundeck 2.7.x and above
• rundeck-server::default

rundeck-server::default

This recipe call config recipe and setup rundeck-server service It also install rundeck gem to allow to configure rundeck via ruby

Resources

• rundeck-server_job
• rundeck-server_project

rundeck-server_job

Manage rundeck jobs through rundeck api

Actions

• create: Create and update rundeck job Default action.
• delete: Delete the job

Attribute Parameters

• name: Name of the job, will be used to identify the job when interacting with rundeck.
• project: Project in which the job will be defined
• config: Job configuration, it is a hash version of yaml output from rundeck api Defaults to <code>{}</code>.
• endpoint: Defaults to <code>"https://localhost"</code>.
• api_token: Token used to interact with the api. See rundeck documentation to generate a token.

Examples

rundeck_server_job 'uname_job' do
  project 'linux_servers'
  config({
    description: 'A simple job running uname on all servers',
    sequence: {
      keepgoing: false,
      strategy: 'node-first',
      commands: [
        { exec: 'uname -a', description: 'Display uname command output' }
      ],
    },
    nodefilters: { dispatch: { threadcount: 10 } },
    filter: '.*'
  })
end

rundeck-server_project

project provider configures a rundeck project

Actions

• create: Create a rundeck project. Default action.
• delete: Delete a rundeck project.

Attribute Parameters

• name: Name of the project
• executor: Executor name + configuration. Could be a plain string (ssh) or complex hash configuration. Defaults to <code>:ssh</code>.
• sources: List of node sources
• properties: Hash of properties
• cookbook: Defaults to <code>"rundeck-server"</code>.

Examples

 # winrm example
 rundeck_server_project 'windows_servers' do
   executor({
     provider: 'overthere-winrm',
     config: {
      'winrm-auth-type'      => 'certificate',
      'winrm-protocol'       => 'https',
      'winrm-cert-trust'     => 'all',
      'winrm-hostname-trust' => 'all',
      'winrm-cert'           =>  [PKCS#12 key for Java]
     }
   })
   sources([{
    'type'            => 'url',
    'config.url'      => "http://url,
    'config.timeout'  => 30,
    'config.cache'    => true,
   }])
   properties({
    'project.plugin.notification.PluginFoo.team' => 'bar',
   })
 end

 # ssh example
 rundeck_server_project 'linux_servers' do
   executor 'ssh'
   sources([{
    'type'            => 'url',
    'config.url'      => "http://chef-bridge/linux,
    'config.timeout'  => 30,
    'config.cache'    => true,
  }])
 end

Mysql conf example

If you need to connect rundeck to a mysql example, you simply have to put:

• default['rundeck_server']['rundeck-config.properties']['dataSource.url'] = 'jdbc:mysql://localhost/rundeckdb?autoReconnect=true'
• default['rundeck_server']['rundeck-config.properties']['dataSource.username'] = 'rundeck'
• default['rundeck_server']['rundeck-config.properties']['dataSource.password'] = 'secret'

See rundeck doc for more information.

License and Maintainer

Maintainer:: Robert Veznaver (r.veznaver@criteo.com)

License:: Apache License 2.0