nwoetzel.eclipse
Ansible Role Eclipse
This Ansible role for Eclipse is based on the work of Alban Andrieu. It has been improved to make it easier to install and configure Eclipse, including plugins and various distributions.
Description
This Ansible role installs an Eclipse distribution and optional plugins.
Dependencies
- Ansible version 2.4 or higher
- geerlingguy.java
- GROG.package
Role Variables
You can find all default variables in the defaults file.
| Variable | Required | Default | Description |
|---|---|---|---|
| eclipse_distro | Yes | - | Eclipse distribution, e.g. mars, neon |
| eclipse_package | Yes | - | Package (default plugins), e.g. java, php, cpp ... |
| eclipse_os | No | - | Operating system (linux, win, macosx) - derived from ansible_system |
| eclipse_arch | No | - | System architecture (x86, x86_64) - derived from ansible_architecture |
| eclipse_tar_file | No | - | The actual tar file downloaded - may need to be changed for specific URLs |
| eclipse_mirror_id | No | - | Optional mirror ID for downloading the package, if automatic selection doesn't work |
| eclipse_plugins_custom | No | {} | Custom plugin declarations (to add to or override defaults) |
| eclipse_plugins_install | No | [] | List of plugin names to install, defined in vars or with eclipse_plugins_custom |
| package_list_eclipse | No | [] | Additional package names to install |
| eclipse_download_folder_remote | No | - | If set, the file is downloaded to the installation host |
| eclipse_service_release | No | Set by this role (vars/main.yml) | Uses the latest known release if not set |
| eclipse_ini_overwrite | No | false | Modify eclipse.ini file |
| eclipse_ini_flags_next_line | No | {} | INI flags for Eclipse, e.g. '"-vm": /opt/bin/java' |
| eclipse_ini_flags_vmargs | No | {} | VM arguments for Java, e.g. '"-XX:MaxPermSize=": "1024m"' |
| eclipse_ui_id_prefs_settings | No | { SHOW_WORKSPACE_SELECTION_DIALOG: "false", RECENT_WORKSPACES: ""} | Key-value pairs for the org.eclipse.ui.ide.prefs file |
Facts
| Variable | Description |
|---|---|
| eclipse_install_dir | The directory where Eclipse is installed |
Features
This role can install almost any Eclipse package from any distribution. Currently, it doesn't support incubation packages or classic distributions. Many plugins come preconfigured and can be installed by their name.
Limitations
Eclipse packages with incubation or classic components aren't supported yet (you can use eclipse_tar_file to work around this). Plugins need to be configured in the role before you can install them by their name or repository URL. Adjustments for these limitations can be easily made.
Additional Dependencies
This role requires geerlingguy.java to install the JDK and set the '-vm' argument in eclipse.ini. You can remove this dependency if you ensure Java is available in the PATH or set as JAVA_HOME. It also depends on GROG.package for minor dependencies.
License
Installer for eclipse of different distro-package combination and with selected plugins.
ansible-galaxy install nwoetzel.eclipse