Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/comcast/ansible-sdkman
An Ansible role that installs, configures, and manages SDKMAN
https://github.com/comcast/ansible-sdkman
ansible ci development gradle groovy java maven sbt scala sdkman
Last synced: about 2 months ago
JSON representation
An Ansible role that installs, configures, and manages SDKMAN
- Host: GitHub
- URL: https://github.com/comcast/ansible-sdkman
- Owner: Comcast
- License: apache-2.0
- Created: 2017-04-27T15:24:04.000Z (over 7 years ago)
- Default Branch: master
- Last Pushed: 2024-01-02T18:10:10.000Z (about 1 year ago)
- Last Synced: 2024-04-30T09:03:51.515Z (9 months ago)
- Topics: ansible, ci, development, gradle, groovy, java, maven, sbt, scala, sdkman
- Language: Python
- Homepage: https://galaxy.ansible.com/Comcast/sdkman/
- Size: 126 KB
- Stars: 56
- Watchers: 16
- Forks: 30
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
Ansible Role: Comcast.sdkman
============================
[![Galaxy Role][badge-role]][link-galaxy]
[![Downloads][badge-downloads]][link-galaxy]
[![Apache 2.0 licensed][badge-license]][link-license]
[![Build Status][badge-travis]][link-travis]
An Ansible role that performs the following functions:
* Install [SDKMAN](http://sdkman.io/)
* Install/uninstall SDKMAN-managed software [candidates](http://sdkman.io/sdks)
* Set SDK version defaults
* Manage the SDKMAN configuration file: `/path/to/sdkman/etc/config`
* Flush the SDKMAN caches
> **Warning**: Oracle has made it increasingly difficult to install their JDKs,
> which has impeded the ability to install them via SDKMAN. Consider using the
> OpenJDK instead or installing/managing the Oracle JDK by other means.
Requirements
------------
None.
Role Variables
--------------
See the [defaults](defaults/main.yml) for a description of each overrideable
variable.
Dependencies
------------
None.
Example Playbook
----------------
Here's an example!
```yaml
- hosts: servers
roles:
- role: Comcast.sdkman
sdkman_user: vagrant
sdkman_group: vagrant
sdkman_auto_answer: true
sdkman_update: true
sdkman_uninstall_packages:
- { candidate: groovy, version: 1.8.9 }
sdkman_install_packages:
- { candidate: java, version: 8.0.202-zulu }
- { candidate: gradle, version: '3.5' }
- { candidate: gradle, version: 2.14.1 }
- { candidate: maven, version: 3.5.0 }
- { candidate: maven, version: 3.3.9 }
# Use this syntax if you want SDKMAN to be aware of packages installed *without* SDKMAN, e.g. Oracle JDKs
- { candidate: java, version: 1.8.0-oracle, localpath: /Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk }
sdkman_defaults:
gradle: '3.5'
maven: 3.3.9
java: 8.0.202-zulu
sdkman_flush_caches_before:
- temp
sdkman_flush_caches_after:
- archives
- broadcast
- candidates
- temp
sdkman_offline_mode: false
sdkman_update_alternatives:
- candidate: java
name: java
link: /usr/bin/java
- candidate: java
name: javac
link: /usr/bin/javac
```
Additional Notes
----------------
If you want to skip any steps that require privilege escalation (i.e. `sudo`
commands), this role has tagged those tasks with the `sdkman_privilege` tag.
Pass the `--skip-tags` flag on the command-line with this tag in order to
bypass any steps that may have already been completed by your system
administrator (e.g. installing system packages).
Testing this role with Alpine Linux has been an uphill battle. The more
recent JDK builds (>-11) available through SDKMAN are not compatible with
Alpine. Instead, it is recommended to install a JDK/JRE through the `apk`
package repository. This all being said, I'm currently unsure how well
SDKMAN packages run on Alpine. Your mileage may vary. _You have been warned_.
License
-------
[Apache 2.0](LICENSE)
Author Information
------------------
* [Elliot Weiser](https://github.com/elliotweiser) @ [Comcast](https://github.com/Comcast)
[badge-downloads]: https://img.shields.io/ansible/role/d/20938.svg?style=flat-square
[badge-license]: https://img.shields.io/github/license/Comcast/ansible-sdkman.svg?style=flat-square
[badge-role]: https://img.shields.io/ansible/role/20938.svg?style=flat-square
[badge-travis]: https://img.shields.io/travis/Comcast/ansible-sdkman/master.svg?style=flat-square
[link-galaxy]: https://galaxy.ansible.com/Comcast/sdkman/
[link-license]: https://raw.githubusercontent.com/Comcast/ansible-sdkman/master/LICENSE
[link-travis]: https://travis-ci.org/Comcast/ansible-sdkman