iiab/scripts/ansible.md

Please read "What is Ansible and what version should I use?" at [http://FAQ.IIAB.IO](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](https://github.com/iiab/iiab/blob/master/scripts/ansible)) began installing these python3-* apt packages, in support of the following Ansible modules:

1. Ansible module: [pip](https://docs.ansible.com/ansible/latest/modules/pip_module.html)

   IIAB installs apt packages:
   - **python3-pip** (for `pip3 install ansible-core` & IIAB's [Admin Console](https://github.com/iiab/iiab-admin-console))
   - **python3-setuptools**
   - **virtualenv** (is Python 3 only, for [roles/kalite](https://github.com/iiab/iiab/tree/master/roles/kalite) & [roles/calibre-web](https://github.com/iiab/iiab/tree/master/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](https://docs.ansible.com/ansible/latest/modules/mysql_db_module.html) and [mysql_user](https://docs.ansible.com/ansible/latest/modules/mysql_user_module.html) (for [roles/mysql](https://github.com/iiab/iiab/tree/master/roles/mysql))

   IIAB installs apt package:
   - **python3-pymysql** (see sudo's password-changing failure [iiab/iiab#1714](https://github.com/iiab/iiab/issues/1714) and [ansible/ansible#47736](https://github.com/ansible/ansible/issues/47736))

3. Ansible modules: [postgresql_db](https://docs.ansible.com/ansible/latest/modules/postgresql_db_module.html) and [postgresql_dbuser](https://docs.ansible.com/ansible/latest/modules/postgresql_user_module.html)

   IIAB installs apt package:
   - **python3-psycopg2** (for [roles/moodle](https://github.com/iiab/iiab/tree/master/roles/moodle))

4. Ansible module: [htpasswd](https://docs.ansible.com/ansible/latest/modules/htpasswd_module.html)

   IIAB installs apt package:
   - **python3-passlib** (for [roles/munin](https://github.com/iiab/iiab/tree/master/roles/munin))
Update ansible.md 2019-11-03 16:26:59 +00:00			`Please read "What is Ansible and what version should I use?" at [http://FAQ.IIAB.IO](http://FAQ.IIAB.IO)`

Update ansible.md 2019-11-04 00:33:21 +00:00			`Read https://github.com/iiab/iiab/wiki/IIAB-Contributors-Guide#ansible to learn more about how IIAB uses Ansible.`

Update ansible.md 2019-11-03 15:42:43 +00:00			`Starting in November 2019, IIAB's Ansible installer ([/opt/iiab/iiab/scripts/ansible](https://github.com/iiab/iiab/blob/master/scripts/ansible)) began installing these python3-* apt packages, in support of the following Ansible modules:`
ansible notes 2019-11-02 10:38:08 +00:00
Update ansible.md 2019-11-03 15:42:43 +00:00			`1. Ansible module: [pip](https://docs.ansible.com/ansible/latest/modules/pip_module.html)`
ansible notes 2019-11-02 10:38:08 +00:00
Update ansible.md 2019-11-03 15:42:43 +00:00			`IIAB installs apt packages:`
Update ansible.md 2021-05-25 03:50:17 +00:00			- python3-pip (for `pip3 install ansible-core` & IIAB's [Admin Console](https://github.com/iiab/iiab-admin-console))
Update ansible.md 2019-11-03 15:42:43 +00:00			`- python3-setuptools`
			- virtualenv (is Python 3 only, for [roles/kalite](https://github.com/iiab/iiab/tree/master/roles/kalite) & [roles/calibre-web](https://github.com/iiab/iiab/tree/master/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`
Transition to ansible-base 2.10+ 2020-09-15 02:02:34 +00:00			`- python3-venv for Good Measure?`
ansible notes 2019-11-02 10:38:08 +00:00
Update ansible.md 2019-11-03 15:42:43 +00:00			`2. Ansible modules: [mysql_db](https://docs.ansible.com/ansible/latest/modules/mysql_db_module.html) and [mysql_user](https://docs.ansible.com/ansible/latest/modules/mysql_user_module.html) (for [roles/mysql](https://github.com/iiab/iiab/tree/master/roles/mysql))`
ansible notes 2019-11-02 10:38:08 +00:00
Update ansible.md 2019-11-03 16:22:15 +00:00			`IIAB installs apt package:`
Update ansible.md 2019-11-03 16:26:59 +00:00			`- python3-pymysql (see sudo's password-changing failure [iiab/iiab#1714](https://github.com/iiab/iiab/issues/1714) and [ansible/ansible#47736](https://github.com/ansible/ansible/issues/47736))`
ansible notes 2019-11-02 10:38:08 +00:00
Update ansible.md 2019-11-03 16:26:59 +00:00			`3. Ansible modules: [postgresql_db](https://docs.ansible.com/ansible/latest/modules/postgresql_db_module.html) and [postgresql_dbuser](https://docs.ansible.com/ansible/latest/modules/postgresql_user_module.html)`
ansible notes 2019-11-02 10:38:08 +00:00
Update ansible.md 2019-11-03 15:42:43 +00:00			`IIAB installs apt package:`
ansible.md: clarify python3-psycopg2 is for Moodle 2019-11-04 17:27:08 +00:00			`- python3-psycopg2 (for [roles/moodle](https://github.com/iiab/iiab/tree/master/roles/moodle))`
Update ansible.md 2019-11-03 15:42:43 +00:00
Update ansible.md 2019-11-03 16:26:59 +00:00			`4. Ansible module: [htpasswd](https://docs.ansible.com/ansible/latest/modules/htpasswd_module.html)`
Update ansible.md 2019-11-03 15:42:43 +00:00
			`IIAB installs apt package:`
			`- python3-passlib (for [roles/munin](https://github.com/iiab/iiab/tree/master/roles/munin))`