iiab/roles/lokole/tasks/main.yml

# "How do i fail a task in Ansible if the variable contains a boolean value?
# I want to perform input validation for Ansible playbooks"
# https://stackoverflow.com/questions/46664127/how-do-i-fail-a-task-in-ansible-if-the-variable-contains-a-boolean-value-i-want/46667499#46667499

# We assume 0-init/tasks/validate_vars.yml has DEFINITELY been run, so no need
# to re-check whether vars are defined here.  As Ansible vars cannot be unset:
# https://serverfault.com/questions/856729/how-to-destroy-delete-unset-a-variable-value-in-ansible

- name: Assert that "lokole_install is sameas true" (boolean not string etc)
  assert:
    that: lokole_install is sameas true
    fail_msg: "PLEASE SET 'lokole_install: True' e.g. IN: /etc/iiab/local_vars.yml"
    quiet: yes

- name: Assert that "lokole_enabled | type_debug == 'bool'" (boolean not string etc)
  assert:
    that: lokole_enabled | type_debug == 'bool'
    fail_msg: "PLEASE GIVE VARIABLE 'lokole_enabled' A PROPER (UNQUOTED) ANSIBLE BOOLEAN VALUE e.g. IN: /etc/iiab/local_vars.yml"
    quiet: yes


- name: Install Lokole if lokole_installed is not defined, e.g. in {{ iiab_state_file }}    # /etc/iiab/iiab_state.yml
  include_tasks: install.yml
  when: lokole_installed is undefined


- name: Do a 'systemctl daemon-reload'
  systemd:
    daemon_reload: yes
  when: lokole_enabled

- name: Enable & Restart supervisor systemd service, if lokole_enabled
  systemd:
    name: supervisor
    enabled: yes
    state: restarted
  when: lokole_enabled

- name: Disable & Stop supervisor systemd service, if not lokole_enabled
  systemd:
    name: supervisor
    enabled: no
    state: stopped
  when: not lokole_enabled

- name: Enable/Disable/Restart NGINX
  include_tasks: nginx.yml


- name: Add 'lokole' variable values to {{ iiab_ini_file }}
  ini_file:
    path: "{{ iiab_ini_file }}"    # /etc/iiab/iiab_state.yml
    section: lokole
    option: "{{ item.option }}"
    value: "{{ item.value | string }}"
  with_items:
    - option: name
      value: Lokole
    - option: description
      value: '"Lokole is an email service that works offline, for rural communities.  With a 3G/4G modem, you can arrange to batch-upload / batch-download emails once per night -- for almost no cost at all -- depending on mobile data plans in your country."'
      #value: '"Lokole is an email service that works offline, for rural communities.  In some cases, emails can also be transmitted to/from the Internet, taking advantage of discounted mobile data rates."'
    - option: lokole_install
      value: "{{ lokole_install }}"
    - option: lokole_enabled
      value: "{{ lokole_enabled }}"
    - option: lokole_settings
      value: "{{ lokole_settings }}"
    - option: lokole_url
      value: "{{ lokole_url }}"
    - option: lokole_full_url
      value: "{{ lokole_full_url }}"