William-Yeh.oracle_java
williamyeh.oracle-java for Ansible Galaxy
概要
Ansible Galaxy のロール名: williamyeh.oracle-java
この Ansible ロールには、Oracle JDKに関する以下の機能があります:
- JDK 7または8のバージョンをインストールします。
- オプションのJava暗号化拡張(JCE)をインストールします。
- CentOS、Debian/Ubuntu、SUSE、Mac OS Xファミリーに対応しています。
OpenJDKを好む場合は、geerlingguy.javaやsmola.javaなどの代替を試してください。
ロール変数
必須変数
なし。
オプション変数
ユーザー設定可能なデフォルト:
# どのバージョン?
java_version: 8
# どのサブバージョン?
java_subversion: 112
# ダウンロードファイルを保存するディレクトリは?
java_download_path: /tmp
# rpm/tar.gzファイルの場所:
# - true: Oracleから直接ダウンロード;
# - false: コントロールマシンの `{{ playbook_dir }}/files` からコピー。
java_download_from_oracle: true
# 一時的にダウンロードしたファイルを削除しますか?
java_remove_download: true
# $JAVA_HOMEを設定しますか?
java_set_javahome: false
# JCEをインストールしますか?
java_install_jce: false
他の設定可能な内部変数については tasks/set-role-variables.yml
ファイルを参照してください。例えば、サポートされている java_version
/java_subversion
の組み合わせなど。
デフォルトでサポートされていないJavaリリースをインストールしたい場合は、java_version
と java_subversion
に加えて、java_build
変数で対応するJavaビルド番号を指定する必要があります。例えば:
---
- hosts: all
roles:
- williamyeh.oracle-java
vars:
java_version: 8
java_subversion: 91
java_build: 14
必要に応じたカスタマイズ変数
もし、tasks/set-role-variables.yml
によってファイル名をうまく推測できない事前ダウンロード済みの jdk_tarball_file
がある場合は、それを明示的に指定できます:
# 推測できない場合の事前ダウンロードファイル名を指定します(.tar.gzや.rpmや.dmgを含めずに);
# `java_download_from_oracle: false` と併用します。
jdk_tarball_file
# 例えば、ローカルに `files/jdk-7u79-linux-x64.tar.gz` があるが、
# `tasks/set-role-variables.yml` でファイル名を正しく推測できない場合、
# プレイブックに次の変数を指定できます:
#
# java_version: 7
# java_subversion: 79
# java_download_from_oracle: false
# jdk_tarball_file: jdk-7u79-linux-x64
#
使用方法
ステップ 1: ロールを追加
プレイブックファイルにロール名 williamyeh.oracle-java
を追加します。
ステップ 2: 変数を追加
プレイブックファイルに変数を設定します。
簡単な例:
---
# ファイル: simple-playbook.yml
- hosts: all
roles:
- williamyeh.oracle-java
vars:
java_version: 8
(オプションで).rpm と .tar.gz ファイルを事前に取得
何らかの理由で、このロールを実行する前に .rpm と .tar.gz ファイルを事前に取得したい場合は、Oracleからのダウンロードではなく、あらかじめファイルを {{ playbook_dir }}/files
ディレクトリに置き、java_download_from_oracle
変数を false
に設定します:
---
# ファイル: prefetch-playbook.yml
- hosts: all
roles:
- williamyeh.oracle-java
vars:
java_version: 8
java_download_from_oracle: false
依存関係
ライセンス
Apache License V2.0の下でライセンスされています。詳細は LICENSEファイル を参照してください。
歴史
私のプレーギャラクシー版から書き直しました: server-config-template。
ansible-galaxy install William-Yeh.oracle_java