iiab/scripts/ansible.md

Please read "What is Ansible and what version should I use?" at http://FAQ.IIAB.IO

Read https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible to learn more about how IIAB uses Ansible.

Starting in November 2019, IIAB's Ansible installer (/opt/iiab/iiab/scripts/ansible) began installing these python3-* apt packages, in support of the following Ansible modules:

1. Ansible module: pip

   IIAB installs apt packages:

   • python3-pip (for IIAB's Admin Console)
   • python3-setuptools
   • virtualenv (is Python 3 only, for roles/kalite & roles/calibre-web ?) and pulls in additional packages... (apt show virtualenv shows "Depends: python3, python3-virtualenv")
     • python3-virtualenv and pulls in additional package... (apt show python3-virtualenv shows "Depends: python-pip-whl (>= 8.1.1-2), python3, python3-distutils, python3-pkg-resources")
       • python3-distutils
   • python3-venv for Good Measure?

2. Ansible modules: mysql_db and mysql_user (for roles/mysql)

   IIAB installs apt package:

   • python3-pymysql (see sudo's password-changing failure iiab/iiab#1714 and ansible/ansible#47736)

3. Ansible modules: postgresql_db and postgresql_dbuser

   IIAB installs apt package:

   • python3-psycopg2 (for roles/moodle)

4. Ansible module: htpasswd

   IIAB installs apt package:

   • python3-passlib (for roles/munin)