GuillaumeSmaha.gluu-customization

Ansible Gluu: Anpassungsrolle

gluu-customization ist eine Ansible-Rolle, die es einfach macht, Dateien auf einem Gluu-Server anzupassen, indem XHTML-Seiten, Bilder, Stilressourcen kopiert oder die WAR-Datei bearbeitet wird, um Übersetzungen zu aktualisieren, zum Beispiel.

Voraussetzungen
Installation
Aktualisierung
Rollenvariablen
Bereitstellung
Beispiel-Playbook
Beispielprojekte

Geschichte

Der Open-Source-Authentifizierungs- und API-Zugriffsmanagement-Server von Gluu ermöglicht es Organisationen, eine zentrale Anmeldemöglichkeit, starke Authentifizierung und Zentralisierung anzubieten.

Voraussetzungen

Um bereitzustellen, benötigen Sie:

Ansible auf Ihrem Bereitstellungsrechner

Installation

gluu-customization ist eine Ansible-Rolle, die global über Ansible Galaxy verteilt wird. Um die Rolle gluu-customization zu installieren, können Sie den folgenden Befehl verwenden.

$ ansible-galaxy install GuillaumeSmaha.gluu-customization

Aktualisierung

Wenn Sie die Rolle aktualisieren möchten, müssen Sie beim Installieren den Parameter --force übergeben. Bitte überprüfen Sie den folgenden Befehl:

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

Rollenvariablen

vars:

  # Definieren Sie eine benutzerdefinierte Version des zu installierenden Pakets.
  # Um eine Liste der verfügbaren Paketversionen zu erhalten, besuchen Sie: https://gluu.org/docs/ce/
  gluu_version: 3.1.4

  # Liste von Dateien, die in /etc/gluu/conf im Gluu-Container kopiert werden sollen
  # Kann Jinja-Template verwenden
  # Beispiel:
  # gluu_copy_configuration_files:
  #   - 'template/configuration/auth_multi_ldap.json'
  gluu_copy_configuration_files:

  # Liste von XHTML-Seiten, die in das Verzeichnis /etc/gluu/jetty/{{ module }}/custom/pages kopiert werden sollen
  # Ein optionales 'dest'-Parameter ist verfügbar
  # Kann Jinja-Template verwenden; daher ist es möglich, relative Pfade aus dem Verzeichnis 'templates' zu verwenden
  # Beispiel:
  # 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:

  # Liste von Ressourcen für die Seite, die in das Verzeichnis /etc/gluu/jetty/{{ module }}/custom/static kopiert werden sollen
  # Kann KEIN Jinja-Template verwenden. Sie müssen also einen absoluten Pfad angeben.
  # Beispiel:
  # 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:


  # Liste von Dateien, die in die WAR-Datei kopiert werden sollen.
  # Die WAR-Datei wird entpackt, die Dateien werden kopiert und das Archiv wird wieder erstellt.
  # Kann Jinja-Template verwenden; daher ist es möglich, relative Pfade aus dem Verzeichnis 'templates' zu verwenden
  # Beispiel zur Anpassung verfügbarer Sprachen und Übersetzungen:
  # 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:

Bereitstellung

Um bereitzustellen, müssen Sie einige Schritte ausführen:

Erstellen Sie eine neue hosts-Datei. Überprüfen Sie die Ansible-Inventardokumentation, wenn Sie Hilfe benötigen.
Erstellen Sie ein neues Playbook für die Bereitstellung Ihrer App, zum Beispiel deploy.yml
Richten Sie die Rollenvariablen ein (siehe Rollenvariablen)
Fügen Sie die Rolle GuillaumeSmaha.gluu-customization als Teil eines Plays hinzu
Führen Sie das Bereitstellungs-Playbook aus

ansible-playbook -i hosts deploy.yml

Wenn alles richtig eingerichtet ist, installiert dieser Befehl den Gluu Cluster Manager auf dem Host.

Beispiel-Playbook

Im Beispielordner können Sie ein Beispielprojekt überprüfen, das zeigt, wie man bereitstellt.

Um es auszuführen, müssen Sie Vagrant und die Rolle installiert haben. Bitte überprüfen Sie https://www.vagrantup.com für mehr Informationen zu Vagrant und unserem Installationsabschnitt.

$ 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