iiab/roles/kolibri/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 "kolibri_install is sameas true" (boolean not string etc)
  assert:
    that: kolibri_install is sameas true
    fail_msg: "PLEASE SET 'kolibri_install: True' e.g. IN: /etc/iiab/local_vars.yml"
    quiet: yes

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


- block:

  #- name: "Set 'kolibri_provision: False' for a more lightweight (re)install"
  #  set_fact:
  #    kolibri_provision: False
  #  when: ???

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


  - include_tasks: enable-or-disable.yml


  - name: Add 'kolibri' variable values to {{ iiab_ini_file }}    # /etc/iiab/iiab.ini
    ini_file:
      path: "{{ iiab_ini_file }}"    # /etc/iiab/iiab.ini
      section: kolibri
      option: "{{ item.option }}"
      value: "{{ item.value | string }}"
    with_items:
      - option: name
        value: Kolibri
      - option: description
        value: '"Kolibri is an open-source educational platform specially designed to provide offline access to a wide range of quality, openly licensed educational contents in low-resource contexts like rural schools, refugee camps, orphanages, and also in non-formal school programs."'
      - option: kolibri_install
        value: "{{ kolibri_install }}"
      - option: kolibri_enabled
        value: "{{ kolibri_enabled }}"
      - option: kolibri_url
        value: "{{ kolibri_url }}"
      - option: kolibri_path
        value: "{{ kolibri_exec_path }}"
      - option: kolibri_port
        value: "{{ kolibri_http_port }}"

  rescue:

  - name: 'SEE ERROR ABOVE (skip_role_on_error: {{ skip_role_on_error }})'
    fail:
      msg: ""
    when: not skip_role_on_error