rundeck
Ansible role rundeck
Install and configure rundeck on your system.
GitHub | Version | Issues | Pull Requests | Downloads |
---|---|---|---|---|
Example Playbook
This example is taken from molecule/default/converge.yml
and is tested on each push, pull request and release.
---
- name: Converge
hosts: all
become: true
gather_facts: true
roles:
- role: buluma.rundeck
The machine needs to be prepared. In CI this is done using molecule/default/prepare.yml
:
---
- name: Prepare
hosts: all
gather_facts: false
become: true
roles:
- role: buluma.bootstrap
- role: buluma.java
- role: buluma.common
Also see a full explanation and example on how to use these roles.
Role Variables
The default values for the variables are set in defaults/main.yml
:
---
# defaults file for rundeck
# Rundeck version to install
rundeck_version: "3.4.9"
rundeck_release_date: 20211221
# Where to install rundeck.
rundeck_rdeckbase: /opt/rundeck
# The Xmx memory size in mb. (Stored in: "{{ rundeck_rdeckbase }}/etc/profile".)
rundeck_xmx: 4096
rundeck_xms: 256
rundeck_maxmetaspacesize: 128
# The URL where Rundeck will be served on:
rundeck_port: 4440
rundeck_address: "{{ ansible_all_ipv4_addresses[0] | default('127.0.0.1') }}"
# You can change the context to for example: "/rundeck". An empty value means
# that false specific context is added.
rundeck_server_web_context: ""
rundeck_config:
- parameter: server.address
value: "{{ rundeck_address }}"
- parameter: grails.serverURL
value: "{{ rundeck_url }}"
- parameter: dataSource.url
value: "jdbc:h2:file:/opt/rundeck/server/data/grailsdb;MVCC=true"
# To connect to MySQL, use these settings. (Database has to be prepared.)
# - parameter: dataSource.url
# value: "jdbc:mysql://myserver/rundeck?autoReconnect=true&useSSL=false"
# - parameter: dataSource.username
# value: rundeck
# - parameter: dataSource.password
# value: rundeck
# - parameter: dataSource.driverClassName
# value: com.mysql.jdbc.Driver
# The settings for Rundeck. (Stored in: "{{ rundeck_rdeckbase }}/etc/framework.properties".)
rundeck_framework:
- parameter: framework.server.hostname
value: "{{ ansible_fqdn }}"
- parameter: framework.server.name
value: "{{ ansible_hostname }}"
- parameter: framework.projects.dir
value: "{{ rundeck_rdeckbase }}/projects"
- parameter: framework.var.dir
value: "{{ rundeck_rdeckbase }}/var"
- parameter: framework.logs.dir
value: "{{ rundeck_rdeckbase }}/var/logs"
# - parameter: "framework.server.username"
# value: unset
# - parameter: "framework.server.password"
# value: unset
- parameter: framework.rundeck.url
value: "{{ rundeck_url }}"
# - parameter: "framework.ssh.keypath"
# value: unset
# - parameter: "framework.ssh.user"
# value: unset
- parameter: framework.ssh-connect-timeout
value: 0
- parameter: framework.ssh-command-timeout
value: 0
# - parameter: "framework.log.dispatch.console.format"
# value: unset
- parameter: framework.rundeck.execution.script.tokenexpansion.enabled
value: true
# default users stored in {{ rundeck_rdeckbase }}/server/config/realm.properties
rundeck_users:
- username: "admin"
password: "admin"
roles: "user,admin"
- username: "user"
password: "user"
roles: "user"
# Rundeck plugins to install
rundeck_plugins: []
# - "https://github.com/Batix/rundeck-ansible-plugin/releases/download/3.1.1/ansible-plugin-3.1.1.jar"
Requirements
- pip packages listed in requirements.txt.
State of used roles
The following roles are used to prepare a system. You can prepare your system in another way.
Requirement | GitHub | Version |
---|---|---|
buluma.bootstrap | ||
buluma.common | ||
buluma.core_dependencies | ||
buluma.java | ||
buluma.service |
Context
This role is a part of many compatible roles. Have a look at the documentation of these roles for further information.
Here is an overview of related roles:
Compatibility
This role has been tested on these container images:
container | tags |
---|---|
EL | 8 |
Debian | all |
Fedora | all |
opensuse | all |
Ubuntu | all |
The minimum version of Ansible required is 2.12, tests have been done to:
- The previous version.
- The current version.
- The development version.
If you find issues, please register them in GitHub
Changelog
License
Author Information
ansible-galaxy install buluma/ansible-role-rundeck