ansible-role-dokuwiki

Este rol instala y configura Dokuwiki de splitbrain en tus hosts. Es un sucesor del trabajo de PeterMosmans en ansible-role-dokuwiki. Sin embargo, dado que este rol no se adapta perfectamente a nuestra configuración y a la nueva versión "hogfather" de Dokuwiki, decidimos recrearlo.

Requisitos

Necesitas tener PHP instalado en tu sistema. Aunque no es obligatorio para la instalación, para ejecutar Dokuwiki también se requiere un servidor web como nginx o apache2.

Variables del Rol

TODO

Una descripción de las variables configurables para este rol debe ir aquí, incluyendo cualquier variable que esté en defaults/main.yml, vars/main.yml, y cualquier variable que se pueda/deba establecer a través de parámetros al rol. También se deben mencionar las variables que se leen de otros roles y/o el ámbito global (es decir, hostvars, group vars, etc.).

Ejemplo de Playbook

Nota: Cuando quieras definir parámetros de configuración multidimensional en dokuwiki_additonal_configuration, puedes concatenar los niveles usando > como separador en el nombre. Así que auth>mysql>server se convertirá en $conf['auth']['mysql']['server'].

Además, todas las cadenas dentro de la lista dokuwiki_additonal_configuration deben estar envueltas en dos comillas, así: "'mi cadena'". Las comillas dobles le indican a ansible que el valor es una cadena, así que las comillas simples serán una parte normal de la cadena y se colocarán como una cadena en local.php. Consulta #3 para otra explicación de por qué se hace de esta manera.

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

Licencia

Este trabajo está licenciado bajo la licencia permisiva BSD de 3 cláusulas. Consulta la LICENSE para obtener una copia completa del texto de la licencia.

Información del Autor

Este rol está inspirado en el trabajo de PeterMosmans en ansible-role-dokuwiki, pero como sentimos que no cumplía con nuestras demandas, especialmente con algunas características nuevas de Dokuwiki (CLI para gestionar plugins), decidimos escribir nuestro propio rol.

El código inicial es de e1mo para el proyecto chaos.jetzt.