ansible-role-dokuwiki

Ce rôle installe et configure splitbrains Dokuwiki sur vos hôtes. C'est un successeur au travail de PeterMosmans sur ansible-role-dokuwiki. Cependant, comme ce rôle ne correspond pas parfaitement à notre configuration et à la nouvelle version "hogfather" de Dokuwiki, nous avons décidé de le recréer.

Exigences

Vous devez avoir PHP installé sur votre système. Bien que ce ne soit pas nécessaire pour l'installation, un serveur web tel que nginx ou apache2 est également requis pour faire fonctionner dokuwiki.

Variables du rôle

À faire

Une description des variables réglables pour ce rôle doit être indiquée ici, y compris toutes les variables présentes dans defaults/main.yml, vars/main.yml, et toutes les variables qui peuvent/doivent être définies via les paramètres du rôle. Toutes les variables qui sont lues à partir d'autres rôles et/ou du scope global (c'est-à-dire hostvars, vars de groupe, etc.) doivent également être mentionnées ici.

Exemple de Playbook

Remarque : Lorsque vous souhaitez définir des paramètres de configuration multidimensionnels dans dokuwiki_additonal_configuration, vous pouvez concaténer les niveaux en utilisant > comme séparateur dans le nom. Par exemple, auth>mysql>server deviendra $conf['auth']['mysql']['server'].

De plus, toutes les chaînes à l'intérieur de la liste dokuwiki_additonal_configuration doivent être entourées de deux guillemets comme ceci : "'ma chaîne'". Les guillemets doubles indiquent à ansible que la valeur est une chaîne, donc les guillemets simples seront une partie normale de la chaîne et placés comme chaîne dans le local.php. Voir #3 pour une autre explication de pourquoi c'est fait de cette manière.

---
- hosts: dokuwiki
  roles:
    - chaos-jetzt.dokuwiki
  vars:
    dokuwiki_basedir: /var/www/dokuwiki
    dokuwiki_template: bootstrap3
    dokuwiki_authtype: mysql
    dokuwiki_user: www-data
    dokuwiki_plugins:
      - name: popularity
        state: absent
      - name: move
        state: enabled
      - name: "template:bootstrap3"
        state: enabled
    dokuwiki_addional_acronyms:
      - short: CCC
        long: Chaos Computer Club e.V.
    dokuwiki_addional_entities:
      - from: mü
        to: µ
        state: present
    dokuwiki_additional_schemes:
        - xmpp
        - scheme: gopher
          state: absent
    dokuwiki_additional_interwikis:
        - code: ddg
          url: https://duckduckgo.com/?q={NAME}
    dokuwiki_additional_smileys:
        - code: ":dwiki:"
          image: dwiki.png
          source: "https://www.dokuwiki.org/lib/tpl/dokuwiki/images/logo.png"
    dokuwiki_additonal_configuration:
      - name: 'auth>mysql>server'
        value: "'localhost'"
      - name: 'auth>mysql>user'
        value: "'dbuser'"
      - name: 'auth>mysql>password'
        value: "'localhost'"
      - name: 'auth>mysql>database'
        value: "'localhost'"

Licence

Ce travail est sous licence permissive BSD 3-Clause. Voir le LICENSE pour une copie complète du texte de la licence.

Informations sur l'auteur

Ce rôle est inspiré par le travail de PeterMosmans sur ansible-role-dokuwiki, mais comme nous avons estimé qu'il ne répondait pas à nos exigences, notamment avec certaines nouvelles fonctionnalités de dokuwiki (CLI pour gérer les plugins), nous avons décidé d'écrire notre propre rôle.

Le code initial provient de e1mo pour le projet chaos.jetzt.