Documentation Update

README.md

@@ -1,14 +1,102 @@
 # Ansible GLPI
 [![Build Status](https://travis-ci.org/supertarto/ansible-glpi.svg?branch=master)](https://travis-ci.org/supertarto/ansible-glpi)
+An Ansible Role to install and configure GLPI. You must have a Web Server, php and MariaDB on your server. This role is tested only with Apache.
+
+## Requirements
+A web server, php and MariaDB. You can use supertarto.apache, supertarto.mariadb and supertarto.php
 
 ## Tested plateform
-* Debian 9 (Stretch)
 * Debian 10 (Buster)
 
 ## Role variables
+The GLPI version and the package name. 
+```yml
+glpi_version: 9.4.5
+glpi_version_package: glpi-9.4.5.tgz
+```
+Set glpi_update to "true" if you want to force an reinstallation. The URL use the glpi_version an the package name.
+```yml
+glpi_update: false
+glpi_download_url: "https://github.com/glpi-project/glpi/releases/download/{{ glpi_version }}/{{ glpi_version_package }}"
+```
+GLPI web owner, group and installation path.
+```yml
+glpi_web_owner: "www-data"
+glpi_web_group: "www-data"
+glpi_install_path: /var/www
+```
+List of plugin adress to download, and list of file to unarchive.
+```yml
+glpi_plugins_dl_addr:
+  - "https://github.com/fusioninventory/fusioninventory-for-glpi/releases/download/glpi9.4%2B2.3/fusioninventory-9.4+2.3.tar.bz2"
 
+glpi_plugins_tar_name:
+  - fusioninventory-9.4+2.3.tar.bz2
+```
+Information about the GLPI database.
+```yml
+glpi_db_host: "localhost"
+glpi_db_port: "3306"
+glpi_db_name: "glpi"
+glpi_db_user: "glpi"
+glpi_db_password: "changeit!"
+```
 
 ## Examples
+```yml
+- hosts: all
+  roles:
+    - role: supertarto.apache
+    - role: supertarto.mariadb
+    - role: supertarto.php
+    - role: supertarto.glpi
+  vars:
+    php_packages:
+      - php7.3
+      - php7.3-gd
+      - php7.3-mysql
+      - php7.3-curl
+      - php7.3-imap
+      - php7.3-json
+      - php7.3-ldap
+      - php7.3-mbstring
+      - php7.3-xml
+      - php7.3-cli
+      - php7.3-xmlrpc
+    glpi_db_host: "localhost"
+    glpi_db_port: "3306"
+    glpi_db_name: "glpi"
+    glpi_db_user: "glpi"
+    glpi_db_password: "changeit!"
+    apache_create_vhosts: true
+    apache_vhosts_filename: "glpi.conf"
+    apache_vhost_config:
+      - listen_ip: "*"
+        listen_port: 80
+        server_name: host1
+        documentroot: "/var/www/glpi"
+        serveradmin: admin@localhost
+        custom_param: |
+          ErrorLog ${APACHE_LOG_DIR}/error.log
+          CustomLog ${APACHE_LOG_DIR}/access.log combined
+          LogLevel warn
+        directory:
+          - path: "/var/www/glpi"
+            config: |
+              AllowOverride All
+              Order deny,allow
+              allow from all
+
+    mariadb_use_dump_script: false
+    mariadb_databases:
+      - name: "{{ glpi_db_name }}"
+
+    mariadb_users:
+      - name: "{{ glpi_db_user }}"
+        host: "{{ glpi_db_host }}"
+        password: "{{ glpi_db_password }}"
+        priv: "{{ glpi_db_name }}.*:SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,CREATE TEMPORARY TABLES,LOCK TABLES"
+```
 ## Installation
 ```
 ansible-galaxy install supertarto.glpi

defaults/main.yml

@@ -20,4 +20,3 @@ glpi_db_port: "3306"
 glpi_db_name: "glpi"
 glpi_db_user: "glpi"
 glpi_db_password: "changeit!"
-glpi_lang: "fr_FR"

molecule/default/debian10-playbook.yml

@@ -33,7 +33,6 @@
     glpi_db_name: "glpi"
     glpi_db_user: "glpi"
     glpi_db_password: "changeit!"
-    glpi_lang: "fr_FR"
     apache_create_vhosts: true
     apache_vhosts_filename: "glpi.conf"
     apache_vhost_config: