ansible-role-dokuwiki

Dieses Role installiert und konfiguriert splitbrains Dokuwiki auf deinen Hosts. Es ist ein Nachfolger von PeterMosmans Arbeit an ansible-role-dokuwiki. Da dieses Role jedoch nicht perfekt zu unserer Einrichtung und der neuen "hogfather" Dokuwiki-Version passt, haben wir uns entschieden, es neu zu erstellen.

Anforderungen

Du musst PHP auf deinem System installiert haben. Während es für die Installation nicht erforderlich ist, wird ein Webserver wie nginx oder apache2 benötigt, um dokuwiki auszuführen.

Rollenvariablen

TODO

Hier sollte eine Beschreibung der einstellbaren Variablen für diese Rolle stehen, einschließlich aller Variablen, die in defaults/main.yml, vars/main.yml und allen Variablen, die über Parameter an die Rolle übergeben werden können/sollten. Alle Variablen, die von anderen Rollen und/oder dem globalen Scope (z.B. hostvars, group vars usw.) gelesen werden, sollten ebenfalls hier erwähnt werden.

Beispiel Playbook

Hinweis: Wenn du mehrdimensionale Konfigurationsparameter in dokuwiki_additonal_configuration definieren möchtest, kannst du die Ebenen mit > im Namen als Separator verketten. Also würde auth>mysql>server zu $conf['auth']['mysql']['server'].

Außerdem müssen alle Strings in der Liste dokuwiki_additonal_configuration in zwei Anführungszeichen eingeschlossen sein: "'mein String'". Die doppelten Anführungszeichen sagen Ansible, dass der Wert ein String ist, und die einfachen Anführungszeichen werden Teil des Strings und in die local.php eingefügt. Siehe #3 für eine weitere Erklärung, warum es so gemacht wird.

---
- 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'"

Lizenz

Dieses Werk ist unter der permissiven BSD 3-Clause Lizenz lizenziert. Siehe die LICENSE für eine vollständige Kopie des Lizenztextes.

Autoreninformation

Dieses Role ist inspiriert von PeterMosmans Arbeit an ansible-role-dokuwiki, aber da wir fühlten, dass es unseren Anforderungen, insbesondere mit einigen neuen Funktionen von dokuwiki (CLI zur Verwaltung von Plugins), nicht gerecht wurde, haben wir beschlossen, unsere eigene Rolle zu schreiben.

Der ursprüngliche Code stammt von e1mo für das Projekt chaos.jetzt.