Ansible Bookstack

使用 Ansible 安装和配置 Bookstack。

测试平台

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

角色变量

将此变量设置为 true 强制应用程序更新或重新安装。

bookstack_force_update: false

如果需要更新 .env 文件，则将此变量设置为 true。默认值设置为 false 以保持幂等性。

bookstack_force_env_update: false

您服务器上本地 git 目录的信息。我们使用一个单独的 git 目录。您还可以定义要克隆的远程 git 仓库和分支。

bookstack_separate_git_dir: /usr/local/bookstack-git
bookstack_content_dest: /var/www/Bookstack
bookstack_git_branch_version: release
bookstack_git_url: https://github.com/BookStackApp/BookStack.git

您的数据库信息，用于您的 .env 文件。

bookstack_host: localhost
bookstack_db_name: bookstackdb
bookstack_db_user: bookstackuser
bookstack_db_password: bookstackpassword

SMTP 和邮件信息。

bookstack_mail_driver: smtp
bookstack_mail_from_name: BookStack
bookstack_mail_from: [email protected]

bookstack_smtp_host: localhost
bookstack_smtp_port: "1025"
bookstack_smtp_username: "null"
bookstack_smtp_password: "null"
bookstack_smtp_encryption: "null"

有关您 LDAP 的信息。

bookstack_use_ldap_auth: false
bookstack_ldap_server: "ldaps://example.com:636"
bookstack_ldap_base_dn: "People,dc=example,dc=com"
bookstack_ldap_bind_dn: "false"
bookstack_ldap_bind_pw: "false"
bookstack_ldap_user_filter: "(&(uid=${user}))"
bookstack_ldap_version: "3"
bookstack_ldap_id_attribute: "uid"
bookstack_ldap_mail_attribute: "mail"
bookstack_ldap_dn_attribute: "cn"
bookstack_ldap_tls_force: "false"

默认语言环境

bookstack_lang: en

示例

- hosts: all
  roles:
    - role: supertarto.apache
    - role: supertarto.php
    - role: supertarto.mariadb
    - role: supertarto.bookstack

  pre_tasks:
    - name: 更新 apt 缓存。
      apt:
        update_cache: true
        cache_valid_time: 600
      when: ansible_os_family == 'Debian'
      changed_when: false
  vars:
    php_packages:
      - php7.3
      - php7.3-mysql
      - php7.3-curl
      - php7.3-pdo
      - php7.3-xml
      - php7.3-mbstring
      - php7.3-gd
      - php-tokenizer
      - php7.3-tidy

    bookstack_host: localhost
    bookstack_db_name: bookstackdb
    bookstack_db_user: bookstackuser
    bookstack_db_password: bookstackpassword

    apache_create_vhosts: true
    apache_mods_enabled:
      - rewrite

    apache_vhosts_filename: "bookstack.conf"
    apache_vhost_config:
      - listen_ip: "*"
        listen_port: 80
        server_name: host1
        documentroot: "/var/www/Bookstack/public"
        serveradmin: admin@localhost
        custom_param: |
          ErrorLog ${APACHE_LOG_DIR}/error.log
          CustomLog ${APACHE_LOG_DIR}/access.log combined
          LogLevel warn
        directory:
          - path: "/var/www/Bookstack/public"
            config: |
              AllowOverride All
              Order deny,allow
              allow from all
              Options +FollowSymLinks
              RewriteEngine On
              RewriteCond %{REQUEST_FILENAME} !-d
              RewriteCond %{REQUEST_FILENAME} !-f
              RewriteRule ^ index.php [L]

    mariadb_use_dump_script: false
    mariadb_databases:
      - name: "{{ bookstack_db_name }}"

    mariadb_users:
      - name: "{{ bookstack_db_user }}"
        host: "{{ bookstack_host }}"
        password: "{{ bookstack_db_password }}"
        priv: "{{ bookstack_db_name }}.*:SELECT,INSERT,UPDATE,DELETE,CREATE,DROP,ALTER,CREATE TEMPORARY TABLES,LOCK TABLES"

安装

ansible-galaxy install supertarto.bookstack

许可证

GPL V3.0