Merge pull request #208 from sean-m-sullivan/conversion_guide

add conversion guide

Author: sean-m-sullivan

README.md

@@ -39,6 +39,8 @@ collections:
     # If you need a specific version of the collection, you can specify like this:
     # version: ...
 ```
+## Conversion from Tower_configuration
+If you were using a version of redhat_cop.tower_configuration, please refer to our Conversion Guide here: [Conversion Guide](docs/CONVERSION_GUIDE.md)
 
 ## Using this collection
 The awx.awx or ansible.controller collection must be invoked in the playbook in order for ansible to pick up the correct modules to use.

docs/CONVERSION_GUIDE.md

@@ -0,0 +1,75 @@
+# Red Hat Communties of Practice Controller Configuration Collection Conversion Guide
+
+# REQUIREMENTS
+The AWX.AWX OR ANSIBLE.TOWER collections MUST be installed in order for this collection to work. It is recomended they be invoked in the playbook in the following way.
+
+## Using this collection
+The awx.awx or ansible.controller collection must be invoked in the playbook in order for ansible to pick up the correct modules to use.
+
+Otherwise it will look for the modules only in your base installation. If there are errors complaining about "couldn't resolve module/action" this is the most likely cause.
+
+```yaml
+- name: Playbook to configure ansible controller post installation
+  hosts: localhost
+  connection: local
+  vars:
+    controller_validate_certs: false
+  collections:
+    - awx.awx
+    - redhat_cop.controller_configuration
+```
+
+# Variable name changes
+
+### Major Variable names changed
+The Following Variables need to be changed:
+|Tower Variable Name|Controller Variable Name|
+|:---:|:---:|
+|`tower_ad_hoc_commands`|`controller_ad_hoc_commands`|
+|`tower_ad_hoc_commands_cancel`|`controller_ad_hoc_commands_cancel`|
+|`tower_applications`|`controller_applications`|
+|`tower_credential_input_sources`|`controller_credential_input_sources`|
+|`tower_credential_types`|`controller_credential_types`|
+|`tower_credentials`|`controller_credentials`|
+|`tower_execution_environments`|`controller_execution_environments`|
+|`tower_groups`|`controller_groups`|
+|`tower_hosts`|`controller_hosts`|
+|`tower_instance_groups`|`controller_instance_groups`|
+|`tower_inventories`|`controller_inventories`|
+|`tower_inventory_sources`|`controller_inventory_sources`|
+|`tower_launch_jobs`|`controller_launch_jobs`|
+|`tower_templates`|`controller_templates`|
+|`tower_cancel_jobs`|`controller_cancel_jobs`|
+|`tower_labels`|`controller_labels`|
+|`tower_license`|`controller_license`|
+|`tower_notifications`|`controller_notifications`|
+|`tower_organizations`|`controller_organizations`|
+|`tower_projects`|`controller_projects`|
+|`tower_rbac`|`controller_roles`|
+|`tower_schedules`|`controller_schedules`|
+|`tower_settings`|`controller_settings`|
+|`tower_teams`|`controller_teams`|
+|`tower_user_accounts`|`controller_user_accounts`|
+|`tower_workflows`|`controller_workflows`|
+|`tower_workflow_launch_jobs`|`controller_workflow_launch_jobs`|
+
+### Authentication Credentials
+|Tower Variable Name|Controller Variable Name|
+|:---:|:---:|
+|`tower_username`|`controller_username`|
+|`tower_password`|`controller_password`|
+|`tower_oauthtoken`|`controller_oauthtoken`|
+|`tower_hostname`|`controller_hostname`|
+|`tower_config_file`|`controller_config_file`|
+|`tower_validate_certs`|`controller_validate_certs`|
+
+### Specific Changes in Roles
+
+### Projects
+|Tower Variable Name|Controller Variable Name|Reason|
+|:---:|:---:|:---:|
+|`default_environment`|`custom_virtualenv`|`enviroments now refer to Execution Enviroments`|
+
+## Notes
+Making these changes should be all the ones you need to make in order to use the updated collection.
+However there have been many changes and this list is in no way final or all encompassing.

STANDARDS.md renamed to docs/STANDARDS.md

@@ -49,5 +49,5 @@
     loop_var: __workflow_loop_item
   when:
     - __workflow_loop_item.simplified_workflow_nodes is defined
-
+    - __workflow_loop_item.state == "present"
 ...