Skip to content

Latest commit

 

History

History
81 lines (65 loc) · 3.04 KB

CONVERSION_GUIDE.md

File metadata and controls

81 lines (65 loc) · 3.04 KB

Red Hat Communties of Practice Controller Configuration Collection Conversion Guide

REQUIREMENTS

The AWX.AWX OR ANSIBLE.CONTROLLER collections MUST be installed in order for this collection to work. It is recommended 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.

- 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 environments now refer to Execution Environments

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.