Incompatible changes in modules upstreamed into Ansible

[cben]

This is tracking / announce issue. This repo is becoming unmaintained, we're in process of upstreaming these modules into Ansible itself. But the new modules have interface and sometimes behavior changes.

Anybody using any modules from this repo, subscribe to this issue to hear what's changing; better yet tell us where your playbooks are and we'll help transition :-)

cc @yaacov @theute @twiest @blrm @itewk @zgalor @JaryN @pavelzag @dtschan @ldomb. (some of you found by github search)
https://github.com/ManageIQ/integration_tests/tree/master/utils/ansible_conf
https://github.com/openshift/openshift-tools/blob/prod/ansible/playbooks/adhoc/manageiq/miq-setup.yml
https://github.com/appuio/ansible-role-openshift-zabbix-monitoring/blob/master/vendor/openshift-tools/ansible/playbooks/adhoc/manageiq/miq-setup.yml
https://github.com/ldomb/rhsummit2017/blob/master/roles/buildcfme/tasks/main.yml
https://github.com/strategicdesignteam/cfme-ansible/blob/master/cfme-ose-provider/tasks/main.yml

Mixed usage?

• Untested: can one use new modules from Ansible together with unported ones from this repo?

Upstreamed modules

New code: in https://github.com/ansible/ansible/search?q=manageiq

• manageiq_provider.py [released in Ansible 2.4]
  https://docs.ansible.com/ansible/devel/manageiq_provider_module.html
  • Removed auth validation and queueing of first refresh (pending better MIQ API).
  • Changed endpoint params (hostname etc)
• manageiq_user.py [released in Ansible 2.4]
  https://docs.ansible.com/ansible/devel/manageiq_user_module.html
  • name param became userid, fullname became name.
• manageiq_policy_assignment.py
  https://docs.ansible.com/ansible/devel/manageiq_policies_module.html
  • module renamed manageiq_policies
  • resource param renamed resource_type
  • as of this writing, only supports assignment of policy profiles to resources (e.g. a provider)
  • added state: list support
• manageiq_tag_assignment.py
  https://docs.ansible.com/ansible/devel/manageiq_tags_module.html
  • module renamed manageiq_tags
  • resource param renamed resource_type
  • added state: list support
• manageiq_alert.py — Significantly changed, split into 2 modules:
  https://docs.ansible.com/ansible/devel/module_docs/manageiq_alerts_module.html,
  https://docs.ansible.com/ansible/devel/module_docs/manageiq_alert_profiles_module.html
• manageiq_custom_attributes.py
  Not sure if planned, please write here if you want this.

All new modules specify how to connect to manageiq (api url, user etc) differently.

Handling of sensitive fields (user or provider password/token) changed — now always attempting update, always reporting changed: True.

[cben]

cc @mberube9