https://github.com/deveryware/ansible-role-icescrum
Installation/configuration of https://www.icescrum.com/
https://github.com/deveryware/ansible-role-icescrum
Last synced: 3 months ago
JSON representation
Installation/configuration of https://www.icescrum.com/
- Host: GitHub
- URL: https://github.com/deveryware/ansible-role-icescrum
- Owner: Deveryware
- License: mit
- Created: 2022-12-02T16:01:33.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2020-12-07T17:07:04.000Z (over 5 years ago)
- Last Synced: 2025-11-06T08:31:21.614Z (7 months ago)
- Size: 48.8 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Ansible Role Icescrum
This Ansible role installs and configures Icescrum (Official website: https://www.icescrum.com/).
By default this role installs the version V7 with a _jar_ setup. But you can choose a _war_ and tomcat setup.
## Table of contents
* [Prerequisites](#prerequisites)
* [Usage](#usage)
* [Example Playbook](#example-playbook)
* [Main variables](#main-variables)
* [Mandatory](#mandatory)
* [Recommended](#recommended)
* [Optionnal](#optionnal)
* [Java options](#java-options)
* [Mail variables](#mail-variables)
* [LDAP variables](#ldap-variables)
* [Project variables](#project-variables)
* [Users variables](#users-variables)
* [Alerts variables](#alerts-variables)
* [War setup](#war-setup)
* [Tomcat version](#tomcat-version)
* [Tomcat proxy server](#tomcat-proxy-server)
## Prerequisites
* java 8
* Mysql
* tomcat8 (Only for a war installation)
## Usage
http://:/
http://localhost:8080/icescrum
Initial credentials are `admin / adminadmin!` . Do not forget to change it!
## Example Playbook
- hosts: servers
roles:
- role: ansible-role-icescrum
icescrum_appID: '726bafab-bcde-f1f2-abcd-f5e4d5c4b2a19'
icescrum_scheme: 'https'
icescrum_host: 'icescrum.company.com'
icescrum_db_password: 'oloc4ever'
## Main variables
### Mandatory
icescrum_appID: Add server ID file named _appID.txt_
icescrum_license_key: Add iceScrum Pro Key.
icescrum_host: Complete _grails.serverURL_ with the _\_ name to set a specific site location.
### Recommended
icescrum_db_password: 'ic3scrum'
### Optionnal
icescrum_scheme: 'http' or 'https'
icescrum_port: '8080'
icescrum_context: 'icescrum'
icescrum_work_dir: '/tmp' It is where the embedded Tomcat webapps and work directory are created.
icescrum_create_default_admin: 'true' or 'false'. False provide a setup wizard.
icescrum_db_user: 'icescrum'
icescrum_version: 'v7' [or the previous 'v6'].
## Java options
_For jar arguments or Catalina options._
icescrum_xmx: 1024m
icescrum_xms: 512m (optionnal)
icescrum_maxpermsize: 256m (optionnal)
icescrum_timezone: 'UTC' (optionnal)
icescrum_java_extra_args: '-Dfoo=bar' (optionnal)
## Mail variables
To enable mail settings, turn `icescrum_mail_enable` into `True` and override with your own settings:
icescrum_mail_enable: True
icescrum_mail_host: "smtp.company.com"
icescrum_mail_port: 465
icescrum_mail_username: "username@company.com"
icescrum_mail_password: "mypassword"
icescrum_mail_auth: ''
**icescrum_mail_auth**: '', 'TLS', or 'SSL'
## LDAP variables
To enable LDAP configuration, put your own settings:
icescrum_ldap_enable: True
icescrum_ldap_server: 'ldaps://ldap.company.com:636'
icescrum_ldap_manager_dn: 'cn=admin,dc=company,dc=com'
icescrum_ldap_manager_password: 'ThouShallNotPass'
You can override the default settings below:
icescrum_ldap_search_base: ''
icescrum_ldap_search_filter: '(uid={0})'
icescrum_ldap_search_subtree: 'true'
icescrum_ldap_attribute_first_name: 'givenName'
icescrum_ldap_attribute_last_name: 'sn'
icescrum_ldap_attribute_mail: 'mail'
icescrum_ldap_ignore_result_exception: 'false'
icescrum_anonymous_no_connection: 'false'
## Project variables
You can override the default settings below:
icescrum_project_creation_enable: 'true'
icescrum_project_export_enable: 'true'
icescrum_project_import_enable: 'true'
icescrum_project_private_default: 'false'
icescrum_project_private_enable: 'true'
## Users variables
You can override the default settings below:
icescrum_gravatar_enable: 'false'
icescrum_registration_enable: 'true'
icescrum_invitation_enable: 'false'
icescrum_login_retrieve_enable: 'true'
icescrum_sessionTimeoutSeconds: 1800
## Alerts variables
You can override the default settings below:
icescrum_alerts_enable: 'true'
icescrum_alerts_errors_to: "dev@icescrum.org"
icescrum_alerts_subject_prefix: "[icescrum]"
icescrum_alerts_default_from: "webmaster@icescrum.org"
## SystemD variables
You can add Environment variables to the systemd daemon like this:
icescrum_env_vars:
- key: 'HTTP_PROXY'
value: 'http://company.com:3128'
- key: 'NO_PROXY'
value: 'localhost'
You can add some additionnal ExecStartPre commands :
icescrum_extra_start_pre:
- '/bin/rm -rf /opt/oloc/tmp'
You can add some additionnal ExecStopPost commands :
icescrum_extra_stop_post:
- '/bin/rm -rf /opt/oloc/tmp'
## Extra Settings
You can add some custom extra settings with the `icescrum_extra_settings` variable:
icescrum_extra_settings:
- datasource.foo.bar: True
- grails.oloc: "Genius"
- icescrum.what.you.want: 0
## War setup
### Tomcat version
There are some differences between tomcat `server.xml` version 7 and 8. You need to setup this parameter to configure the right listener.
icescrum_tomcat_version: '8' [or the previous '7']
### Tomcat proxy server
To enable proxy settings, turn `icescrum_tomcat_proxy_active` int `True` and override with your own settings:
icescrum_tomcat_proxy_server: icescrum.company.com
icescrum_tomcat_proxy_port: 443
## License
MIT
## Author Information
This role was created in 2016 by Olivier Locard on the behalf of Deveryware.