GuillaumeSmaha.gluu-customization

概要バージョン洞察

Ansible Gluu: カスタマイズロール

gluu-customizationは、XHTMLページ、画像、スタイルリソースをコピーしたり、WARファイルを編集して翻訳を更新することで、Gluuサーバー上のファイルを簡単にカスタマイズするためのAnsibleロールです。

要件
インストール
更新
ロール変数
デプロイメント
例のプレイブック
サンプルプロジェクト

履歴

Gluuのオープンソース認証およびAPIアクセス管理サーバーは、組織がシングルサインオンや強力な認証を提供し、集中管理を行えるようにします。

要件

デプロイするためには、次のものが必要です：

デプロイ機のAnsible

インストール

gluu-customizationは、Ansible Galaxyを使用してグローバルに配布されるAnsibleロールです。gluu-customizationロールをインストールするには、次のコマンドを使用します。

$ ansible-galaxy install GuillaumeSmaha.gluu-customization

更新

ロールを更新したい場合は、インストール時に**--force**パラメーターを指定する必要があります。次のコマンドを確認してください：

$ ansible-galaxy install --force GuillaumeSmaha.gluu-customization

ロール変数

vars:

  # インストールするパッケージのカスタムバージョンを定義します。
  # 利用可能なパッケージバージョンのリストについては、https://gluu.org/docs/ce/を訪問してください。
  gluu_version: 3.1.4

  # Gluuコンテナ内の/etc/gluu/confにコピーするファイルのリスト
  # Jinjaテンプレートを使用できます
  # 例：
  # gluu_copy_configuration_files:
  #   - 'template/configuration/auth_multi_ldap.json'
  gluu_copy_configuration_files:

  # /etc/gluu/jetty/{{ module }}/custom/pagesディレクトリにコピーするXHTMLページのリスト
  # オプションの'dest'パラメーターが利用可能です
  # Jinjaテンプレートを使用できます。したがって、'templates'ディレクトリから相対パスを使用できます。
  # 例：
  # gluu_copy_pages:
  #   oxauth:
  #     - path: 'template/pages/login.xhtml'
  #     - path: 'template/pages/login_template.xhtml'
  #       dest: 'WEB-INF/incl/layout/login-template.xhtml'
  gluu_copy_pages:

  # /etc/gluu/jetty/{{ module }}/custom/staticディレクトリにコピーするページのリソースのリスト
  # Jinjaテンプレートは使用できません。絶対パスを指定する必要があります。
  # 例：
  # gluu_copy_resources:
  #   oxauth:
  #     - path: '{{ playbook_dir }}/templates/custom/oxauth/static/logo.svg'
  #       dest: 'img/logo.svg'
  #     - path: '{{ playbook_dir }}/templates/custom/oxauth/static/error.png'
  #       dest: 'img/error.png'
  gluu_copy_resources:

  # WARファイルにコピーするファイルのリスト
  # WARファイルは解凍され、ファイルがコピーされ、アーカイブが再作成されます。
  # Jinjaテンプレートを使用できます。したがって、'templates'ディレクトリから相対パスを使用できます。
  # 利用可能な言語と翻訳をカスタマイズする例：
  # gluu_customize_wars:
  #   oxauth:
  #     - path: 'wars/oxauth/messages_fr.properties'
  #       dest: 'WEB-INF/classes/messages_fr.properties'
  #     - path: 'wars/oxauth/messages_en.properties'
  #       dest: 'WEB-INF/classes/messages_en.properties'
  #     - path: 'wars/oxauth/faces-config.xml'
  #       dest: 'WEB-INF/faces-config.xml'
  gluu_customize_wars:

デプロイメント

デプロイするには、いくつかの手順を実行する必要があります：

新しいhostsファイルを作成します。必要に応じて、ansible inventory documentationを確認してください。
アプリケーションをデプロイするための新しいプレイブック、例えばdeploy.ymlを作成します。
ロール変数を設定します（ロール変数を参照）。
プレイの一部としてGuillaumeSmaha.gluu-customizationロールを含めます。
デプロイメントプレイブックを実行します。

ansible-playbook -i hosts deploy.yml

すべてが正しく設定されていれば、このコマンドはホストにGluu Cluster Managerをインストールします。

例のプレイブック

exampleフォルダには、どのようにデプロイするかを示す例のプロジェクトがあります。

これを実行するには、Vagrantとロールがインストールされている必要があります。Vagrantの詳細については、https://www.vagrantup.comを参照してください。

$ cd example
$ vagrant plugin install vagrant-lxc
$ vagrant plugin install vagrant-hostmanager
$ vagrant up --provider=lxc
$ ansible-galaxy install GuillaumeSmaha.gluu-setup GuillaumeSmaha.gluu-customization
$ ansible-playbook -i env/ubuntu deploy.yml
$ ansible-playbook -i env/centos deploy.yml