Ansible Wiki.js

Installer et configurer Wiki.js avec Ansible.

Exigences

Wiki.js nécessite Node.js et une base de données comme PostgreSQL. Vous pouvez également utiliser MariaDB ou SQLite, mais Wiki.js recommande PostgreSQL pour les futures mises à jour. Vous pouvez utiliser supertarto.nodejs et supertarto.postgresql.

Plateformes testées

• Debian 10 (Buster)
• Debian 11 (Bullseye)
• Debian 12 (Bookworm)

Variables de rôle

Forcer l'installation/mise à jour.

wikijs_update: false

Version de Wiki.js, URL de téléchargement et destination sur votre serveur.

wikijs_version: "2.5..300"
wikijs_download_url: "https://github.com/Requarks/wiki/releases/download/{{ wikijs_version }}/wiki-js.tar.gz"
wikijs_download_dest: /usr/local/wikijs

Utilisateur et groupe système qui doivent être créés et utilisés pour le service en cours d'exécution. wikijs_user_additional_groups permet de spécifier des groupes supplémentaires pour l'utilisateur système.

wikijs_system_user: wikijs
wikijs_system_group: wikijs
wikijs_user_additional_groups: ""

Port utilisé pour se connecter à votre instance Wiki.js.

wikijs_config_port: 3000

Informations sur la base de données. PostgreSQL est recommandé.

# postgres, mysql, mariadb, mssql, sqlite
wikijs_config_db_type: postgres
wikijs_config_db_host: localhost
wikijs_config_db_port: 5432
wikijs_config_db_user: wikijs
wikijs_config_db_pass: wikijsrocks
wikijs_config_db_db: wiki
wikijs_config_db_ssl: false

Configuration de la connexion SSL à la base de données. Ignoré si auto est true.

wikijs_config_ssl_options:
  auto: true
  # Utilisez les champs nécessaires lorsque 'auto' est false.
  # rejectUnauthorized: true
  # ca: path/to/ca.crt
  # cert: path/to/cert.crt
  # key: path/to/key.pem
  # pfx: path/to/cert.pfx
  # passphrase: xyz123

Utilisé seulement si SQLite est sélectionné.

wikijs_config_sqlite_storage: path/to/database.sqlite

Informations sur votre certificat SSL, si vous devez utiliser SSL.

wikijs_config_ssl_enabled: false
wikijs_config_ssl_port: 3443
# custom, letsencrypt
wikijs_config_ssl_provider: custom

# Pour custom seulement
# pem, pfx
wikijs_config_ssl_format: pem
# seulement pour pem
wikijs_config_ssl_key: path/to/key.pem
wikijs_config_ssl_cert: path/to/cert.pem
wikijs_config_ssl_pfx: path/to/cert.pfx
wikijs_config_ssl_passphrase: null
wikijs_config_ssl_dhparam: null

# Pour letsencrypt seulement
wikijs_config_ssl_domain: wiki.yourdomain.com
wikijs_config_ssl_subscriberEmail: [email protected]

wikijs_config_bindIP: "0.0.0.0"
wikijs_config_logLevel: info
wikijs_config_offline: false
wikijs_config_ha: false
wikijs_config_dataPath: ./data

Exemples

---
- hosts: all
  roles:
    - role: supertarto.nodejs
    - role: supertarto.postgresql
    - role: supertarto.wikijs

  vars:
    postgresql_databases:
      - name: wiki
    postgresql_users:
      - name: wikijs
        password: wikijsrocks

Installation

ansible-galaxy role install supertarto.wikijs

Licence

GPL V3.0