External-Mirrors/awx
2
0
Fork 0
mirror of https://github.com/ansible/awx.git synced 2026-03-18 01:17:35 -02:30
Code Issues Packages Projects Releases Wiki Activity

mostly includes renaming non-syntax references to tower

Browse Source
This commit is contained in:
Seth Foster
2021-05-03 17:20:24 -04:00
parent 9f4172ce7b
commit 82c5803e59
92 changed files with 410 additions and 408 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
awx_collection/plugins/modules/ad_hoc_command.py
View File

@@ -17,9 +17,9 @@ DOCUMENTATION = '''
module: ad_hoc_command
author: "John Westcott IV (@john-westcott-iv)"
version_added: "4.0"
short_description: create, update, or destroy Automation Controller ad hoc commands.
short_description: create, update, or destroy Automation Platform Controller ad hoc commands.
description:
- Create, update, or destroy Automation Controller ad hoc commands. See
- Create, update, or destroy Automation Platform Controller ad hoc commands. See
U(https://www.ansible.com/tower) for an overview.
options:
job_type:
@@ -84,7 +84,7 @@ options:
type: bool
interval:
description:
- The interval to request an update from Tower.
- The interval to request an update from the controller.
default: 1
type: float
timeout:

8
awx_collection/plugins/modules/ad_hoc_command_cancel.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: ad_hoc_command_cancel
author: "John Westcott IV (@john-westcott-iv)"
short_description: Cancel an Automation Controller Ad Hoc Command.
short_description: Cancel an Ad Hoc Command.
description:
- Cancel Automation Controller ad hoc command. See
- Cancel ad hoc command. See
U(https://www.ansible.com/tower) for an overview.
options:
command_id:
@@ -33,14 +33,14 @@ options:
type: bool
interval:
description:
- The interval in seconds, to request an update from Tower.
- The interval in seconds, to request an update from .
required: False
default: 1
type: float
timeout:
description:
- Maximum time in seconds to wait for a job to finish.
- Not specifying means the task will wait until Tower cancels the command.
- Not specifying means the task will wait until the controller cancels the command.
type: int
extends_documentation_fragment: awx.awx.auth
'''

8
awx_collection/plugins/modules/ad_hoc_command_wait.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: ad_hoc_command_wait
author: "John Westcott IV (@john-westcott-iv)"
short_description: Wait for Automation Controller Ad Hoc Command to finish.
short_description: Wait for Automation Platform Controller Ad Hoc Command to finish.
description:
- Wait for Automation Controller ad hoc command to finish and report success or failure. See
- Wait for Automation Platform Controller ad hoc command to finish and report success or failure. See
U(https://www.ansible.com/tower) for an overview.
options:
command_id:
@@ -28,7 +28,7 @@ options:
type: int
interval:
description:
- The interval in sections, to request an update from Tower.
- The interval in sections, to request an update from the controller.
required: False
default: 1
type: float
@@ -112,7 +112,7 @@ def main():
)
if command is None:
module.fail_json(msg='Unable to wait on ad hoc command {0}; that ID does not exist in Tower.'.format(command_id))
module.fail_json(msg='Unable to wait on ad hoc command {0}; that ID does not exist.'.format(command_id))
# Invoke wait function
module.wait_on_url(url=command['url'], object_name=command_id, object_type='ad hoc command', timeout=timeout, interval=interval)

4
awx_collection/plugins/modules/application.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: application
author: "Geoffrey Bacheot (@jffz)"
short_description: create, update, or destroy Automation Controller applications
short_description: create, update, or destroy Automation Platform Controller applications
description:
- Create, update, or destroy Automation Controller applications. See
- Create, update, or destroy Automation Platform Controller applications. See
U(https://www.ansible.com/tower) for an overview.
options:
name:

20
awx_collection/plugins/modules/credential.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: credential
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller credential.
short_description: create, update, or destroy Automation Platform Controller credential.
description:
- Create, update, or destroy Automation Controller credentials. See
- Create, update, or destroy Automation Platform Controller credentials. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -56,7 +56,7 @@ options:
description:
- >-
Credential inputs where the keys are var names used in templating.
Refer to the Automation Controller documentation for example syntax.
Refer to the Automation Platform Controller documentation for example syntax.
- Any fields in this dict will take prescedence over any fields mentioned below (i.e. host, username, etc)
type: dict
update_secrets:
@@ -96,7 +96,7 @@ options:
password:
description:
- Password for this credential. ``secret_key`` for AWS. ``api_key`` for RAX.
- Use "ASK" and launch in Tower to be prompted.
- Use "ASK" and launch job to be prompted.
- Deprecated, please use inputs
type: str
project:
@@ -112,7 +112,7 @@ options:
ssh_key_unlock:
description:
- Unlock password for ssh_key.
- Use "ASK" and launch in Tower to be prompted.
- Use "ASK" and launch job to be prompted.
- Deprecated, please use inputs
type: str
authorize:
@@ -166,19 +166,19 @@ options:
become_username:
description:
- Become username.
- Use "ASK" and launch in Tower to be prompted.
- Use "ASK" and launch job to be prompted.
- Deprecated, please use inputs
type: str
become_password:
description:
- Become password.
- Use "ASK" and launch in Tower to be prompted.
- Use "ASK" and launch job to be prompted.
- Deprecated, please use inputs
type: str
vault_password:
description:
- Vault password.
- Use "ASK" and launch in Tower to be prompted.
- Use "ASK" and launch job to be prompted.
- Deprecated, please use inputs
type: str
vault_id:
@@ -203,7 +203,7 @@ notes:
EXAMPLES = '''
- name: Add tower machine credential
- name: Add machine credential
credential:
name: Team Name
description: Team Description
@@ -229,7 +229,7 @@ EXAMPLES = '''
src: '$HOME/.ssh/aws-private.pem'
register: aws_ssh_key
- name: Add Credential Into Tower
- name: Add Credential
credential:
name: Workshop Credential
credential_type: Machine

4
awx_collection/plugins/modules/credential_input_source.py
View File

@@ -17,9 +17,9 @@ DOCUMENTATION = '''
module: credential_input_source
author: "Tom Page (@Tompage1994)"
version_added: "2.3"
short_description: create, update, or destroy Automation Controller credential input sources.
short_description: create, update, or destroy Automation Platform Controller credential input sources.
description:
- Create, update, or destroy Automation Controller credential input sources. See
- Create, update, or destroy Automation Platform Controller credential input sources. See
U(https://www.ansible.com/tower) for an overview.
options:
description:

10
awx_collection/plugins/modules/credential_type.py
View File

@@ -17,9 +17,9 @@ DOCUMENTATION = '''
---
module: credential_type
author: "Adrien Fleury (@fleu42)"
short_description: Create, update, or destroy custom Automation Controller credential type.
short_description: Create, update, or destroy custom Automation Platform Controller credential type.
description:
- Create, update, or destroy Automation Controller credential type. See
- Create, update, or destroy Automation Platform Controller credential type. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -42,14 +42,14 @@ options:
inputs:
description:
- >-
Enter inputs using either JSON or YAML syntax. Refer to the Ansible
Tower documentation for example syntax.
Enter inputs using either JSON or YAML syntax. Refer to the
Automation Platform Controler documentation for example syntax.
type: dict
injectors:
description:
- >-
Enter injectors using either JSON or YAML syntax. Refer to the
Automation Controller documentation for example syntax.
Automation Platform Controller documentation for example syntax.
type: dict
state:
description:

6
awx_collection/plugins/modules/execution_environment.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: execution_environment
author: "Shane McDonald (@shanemcd)"
short_description: create, update, or destroy Execution Environments in Automation Controller.
short_description: create, update, or destroy Execution Environments in Automation Platform Controller.
description:
- Create, update, or destroy Execution Environments in Automation Controller. See
- Create, update, or destroy Execution Environments in Automation Platform Controller. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -60,7 +60,7 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Add EE to Tower
- name: Add EE to the controller instance
execution_environment:
name: "My EE"
image: quay.io/ansible/awx-ee

8
awx_collection/plugins/modules/export.py
View File

@@ -17,9 +17,9 @@ DOCUMENTATION = '''
module: export
author: "John Westcott IV (@john-westcott-iv)"
version_added: "3.7"
short_description: export resources from Automation Controller.
short_description: export resources from Automation Platform Controller.
description:
- Export assets from Automation Controller.
- Export assets from Automation Platform Controller.
options:
all:
description:
@@ -82,7 +82,7 @@ extends_documentation_fragment: awx.awx.auth
'''
EXAMPLES = '''
- name: Export all tower assets
- name: Export all assets
export:
all: True
@@ -124,7 +124,7 @@ def main():
if not HAS_EXPORTABLE_RESOURCES:
module.fail_json(msg="Your version of awxkit does not have import/export")
# The export process will never change a Tower system
# The export process will never change the AWX system
module.json_output['changed'] = False
# The exporter code currently works like the following:

12
awx_collection/plugins/modules/group.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: group
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller group.
short_description: create, update, or destroy Automation Platform Controller group.
description:
- Create, update, or destroy Automation Controller groups. See
- Create, update, or destroy Automation Platform Controller groups. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -53,12 +53,12 @@ options:
- groups
preserve_existing_hosts:
description:
- Provide option (False by default) to preserves existing hosts in an existing group in tower.
- Provide option (False by default) to preserves existing hosts in an existing group.
default: False
type: bool
preserve_existing_children:
description:
- Provide option (False by default) to preserves existing children in an existing group in tower.
- Provide option (False by default) to preserves existing children in an existing group.
default: False
type: bool
aliases:
@@ -78,7 +78,7 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Add tower group
- name: Add group
group:
name: localhost
description: "Local Host Group"
@@ -86,7 +86,7 @@ EXAMPLES = '''
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add tower group
- name: Add group
group:
name: Cities
description: "Local Host Group"

6
awx_collection/plugins/modules/host.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: host
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller host.
short_description: create, update, or destroy Automation Platform Controller host.
description:
- Create, update, or destroy Automation Controller hosts. See
- Create, update, or destroy Automation Platform Controller hosts. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -59,7 +59,7 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Add tower host
- name: Add host
host:
name: localhost
description: "Local Host Group"

8
awx_collection/plugins/modules/import.py
View File

@@ -17,15 +17,15 @@ DOCUMENTATION = '''
module: import
author: "John Westcott (@john-westcott-iv)"
version_added: "3.7"
short_description: import resources into Automation Controller.
short_description: import resources into Automation Platform Controller.
description:
- Import assets into Automation Controller. See
- Import assets into Automation Platform Controller. See
U(https://www.ansible.com/tower) for an overview.
options:
assets:
description:
- The assets to import.
- This can be the output of tower_export or loaded from a file
- This can be the output of the export module or loaded from a file
required: True
type: dict
requirements:
@@ -39,7 +39,7 @@ EXAMPLES = '''
all: True
register: export_output
- name: Import all tower assets from our export
- name: Import all assets from our export
import:
assets: "{{ export_output.assets }}"

4
awx_collection/plugins/modules/instance_group.py
View File

@@ -17,9 +17,9 @@ DOCUMENTATION = '''
module: instance_group
author: "John Westcott IV (@john-westcott-iv)"
version_added: "4.0"
short_description: create, update, or destroy Automation Controller instance groups.
short_description: create, update, or destroy Automation Platform Controller instance groups.
description:
- Create, update, or destroy Automation Controller instance groups. See
- Create, update, or destroy Automation Platform Controller instance groups. See
U(https://www.ansible.com/tower) for an overview.
options:
name:

8
awx_collection/plugins/modules/inventory.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: inventory
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller inventory.
short_description: create, update, or destroy Automation Platform Controller inventory.
description:
- Create, update, or destroy Automation Controller inventories. See
- Create, update, or destroy Automation Platform Controller inventories. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -77,7 +77,7 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Add tower inventory
- name: Add inventory
inventory:
name: "Foo Inventory"
description: "Our Foo Cloud Servers"
@@ -85,7 +85,7 @@ EXAMPLES = '''
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Copy tower inventory
- name: Copy inventory
inventory:
name: Copy Foo Inventory
copy_from: Default Inventory

6
awx_collection/plugins/modules/inventory_source.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: inventory_source
author: "Adrien Fleury (@fleu42)"
short_description: create, update, or destroy Automation Controller inventory source.
short_description: create, update, or destroy Automation Platform Controller inventory source.
description:
- Create, update, or destroy Automation Controller inventory source. See
- Create, update, or destroy Automation Platform Controller inventory source. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -162,7 +162,7 @@ def main():
description=dict(),
inventory=dict(required=True),
#
# How do we handle manual and file? Tower does not seem to be able to activate them
# How do we handle manual and file? The controller does not seem to be able to activate them
#
source=dict(choices=["scm", "ec2", "gce", "azure_rm", "vmware", "satellite6", "openstack", "rhv", "tower"]),
source_path=dict(),

4
awx_collection/plugins/modules/inventory_source_update.py
View File

@@ -18,7 +18,7 @@ module: inventory_source_update
author: "Bianca Henderson (@beeankha)"
short_description: Update inventory source(s).
description:
- Update Automation Controller inventory source(s). See
- Update Automation Platform Controller inventory source(s). See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -44,7 +44,7 @@ options:
type: bool
interval:
description:
- The interval to request an update from Tower.
- The interval to request an update from the controller.
required: False
default: 1
type: float

6
awx_collection/plugins/modules/job_cancel.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: job_cancel
author: "Wayne Witzel III (@wwitzel3)"
short_description: Cancel an Automation Controller Job.
short_description: Cancel an Automation Platform Controller Job.
description:
- Cancel Automation Controller jobs. See
- Cancel Automation Platform Controller jobs. See
U(https://www.ansible.com/tower) for an overview.
options:
job_id:
@@ -81,7 +81,7 @@ def main():
cancel_page = module.get_endpoint(job['related']['cancel'])
if 'json' not in cancel_page or 'can_cancel' not in cancel_page['json']:
module.fail_json(msg="Failed to cancel job, got unexpected response from tower", **{'response': cancel_page})
module.fail_json(msg="Failed to cancel job, got unexpected response from the controller", **{'response': cancel_page})
if not cancel_page['json']['can_cancel']:
if fail_if_not_running:

8
awx_collection/plugins/modules/job_launch.py
View File

@@ -18,7 +18,7 @@ module: job_launch
author: "Wayne Witzel III (@wwitzel3)"
short_description: Launch an Ansible Job.
description:
- Launch an Automation Controller jobs. See
- Launch an Automation Platform Controller jobs. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -51,7 +51,7 @@ options:
extra_vars:
description:
- extra_vars to use for the Job Template.
- ask_extra_vars needs to be set to True via tower_job_template module
- ask_extra_vars needs to be set to True via job_template module
when creating the Job Template.
type: dict
limit:
@@ -93,7 +93,7 @@ options:
type: bool
interval:
description:
- The interval to request an update from Tower.
- The interval to request an update from the controller.
required: False
default: 1
type: float
@@ -111,7 +111,7 @@ EXAMPLES = '''
job_template: "My Job Template"
register: job
- name: Launch a job template with extra_vars on remote Tower instance
- name: Launch a job template with extra_vars on remote controller instance
job_launch:
job_template: "My Job Template"
extra_vars:

4
awx_collection/plugins/modules/job_list.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: job_list
author: "Wayne Witzel III (@wwitzel3)"
short_description: List Automation Controller jobs.
short_description: List Automation Platform Controller jobs.
description:
- List Automation Controller jobs. See
- List Automation Platform Controller jobs. See
U(https://www.ansible.com/tower) for an overview.
options:
status:

12
awx_collection/plugins/modules/job_template.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: job_template
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller job templates.
short_description: create, update, or destroy Automation Platform Controller job templates.
description:
- Create, update, or destroy Automation Controller job templates. See
- Create, update, or destroy Automation Platform Controller job templates. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -57,7 +57,7 @@ options:
- Used to help lookup the object, cannot be modified using this module.
- The Organization is inferred from the associated project
- If not provided, will lookup by name only, which does not work with duplicates.
- Requires Tower Version 3.7.0 or AWX 10.0.0 IS NOT backwards compatible with earlier versions.
- Requires Automation Platform Version 3.7.0 or AWX 10.0.0 IS NOT backwards compatible with earlier versions.
type: str
project:
description:
@@ -297,14 +297,14 @@ options:
extends_documentation_fragment: awx.awx.auth
notes:
- JSON for survey_spec can be found in Tower API Documentation. See
- JSON for survey_spec can be found in the API Documentation. See
U(https://docs.ansible.com/ansible-tower/latest/html/towerapi/api_ref.html#/Job_Templates/Job_Templates_job_templates_survey_spec_create)
for POST operation payload example.
'''
EXAMPLES = '''
- name: Create Tower Ping job template
- name: Create Ping job template
job_template:
name: "Ping"
job_type: "run"
@@ -534,7 +534,7 @@ def main():
}
)
if project_data is None:
module.fail_json(msg="The project {0} in organization {1} was not found on the Tower server".format(project, organization))
module.fail_json(msg="The project {0} in organization {1} was not found on the controller instance server".format(project, organization))
new_fields['project'] = project_data['id']
else:
new_fields['project'] = module.resolve_name_to_id('projects', project)

12
awx_collection/plugins/modules/job_wait.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: job_wait
author: "Wayne Witzel III (@wwitzel3)"
short_description: Wait for Automation Controller job to finish.
short_description: Wait for Automation Platform Controller job to finish.
description:
- Wait for Automation Controller job to finish and report success or failure. See
- Wait for Automation Platform Controller job to finish and report success or failure. See
U(https://www.ansible.com/tower) for an overview.
options:
job_id:
@@ -28,19 +28,19 @@ options:
type: int
interval:
description:
- The interval in sections, to request an update from Tower.
- The interval in sections, to request an update from the controller.
- For backwards compatibility if unset this will be set to the average of min and max intervals
required: False
default: 1
type: float
min_interval:
description:
- Minimum interval in seconds, to request an update from Tower.
- Minimum interval in seconds, to request an update from the controller.
- deprecated, use interval instead
type: float
max_interval:
description:
- Maximum interval in seconds, to request an update from Tower.
- Maximum interval in seconds, to request an update from the controller.
- deprecated, use interval instead
type: float
timeout:
@@ -147,7 +147,7 @@ def main():
)
if job is None:
module.fail_json(msg='Unable to wait on ' + job_type.rstrip("s") + ' {0}; that ID does not exist in Tower.'.format(job_id))
module.fail_json(msg='Unable to wait on ' + job_type.rstrip("s") + ' {0}; that ID does not exist.'.format(job_id))
# Invoke wait function
result = module.wait_on_url(url=job['url'], object_name=job_id, object_type='legacy_job_wait', timeout=timeout, interval=interval)

8
awx_collection/plugins/modules/label.py
View File

@@ -16,11 +16,11 @@ DOCUMENTATION = '''
---
module: label
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller labels.
short_description: create, update, or destroy Automation Platform Controller labels.
description:
- Create, update, or destroy Automation Controller labels. See
- Create, update, or destroy Automation Platform Controller labels. See
U(https://www.ansible.com/tower) for an overview.
- Note, labels can only be created via the Tower API, they can not be deleted.
- Note, labels can only be created via the API, they can not be deleted.
Once they are fully disassociated the API will clean them up on its own.
options:
name:
@@ -47,7 +47,7 @@ extends_documentation_fragment: awx.awx.auth
'''
EXAMPLES = '''
- name: Add label to tower organization
- name: Add label to organization
label:
name: Custom Label
organization: My Organization

4
awx_collection/plugins/modules/license.py
View File

@@ -15,9 +15,9 @@ DOCUMENTATION = '''
---
module: license
author: "John Westcott IV (@john-westcott-iv)"
short_description: Set the license for Automation Controller
short_description: Set the license for Automation Platform Controller
description:
- Get or Set Automation Controller license. See
- Get or Set Automation Platform Controller license. See
U(https://www.ansible.com/tower) for an overview.
options:
manifest:

4
awx_collection/plugins/modules/notification_template.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: notification_template
author: "Samuel Carpentier (@samcarpentier)"
short_description: create, update, or destroy Automation Controller notification.
short_description: create, update, or destroy Automation Platform Controller notification.
description:
- Create, update, or destroy Automation Controller notifications. See
- Create, update, or destroy Automation Platform Controller notifications. See
U(https://www.ansible.com/tower) for an overview.
options:
name:

10
awx_collection/plugins/modules/organization.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: organization
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller organizations
short_description: create, update, or destroy Automation Platform Controller organizations
description:
- Create, update, or destroy Automation Controller organizations. See
- Create, update, or destroy Automation Platform Controller organizations. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -86,21 +86,21 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Create tower organization
- name: Create organization
organization:
name: "Foo"
description: "Foo bar organization"
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Create tower organization using 'foo-venv' as default Python virtualenv
- name: Create organization using 'foo-venv' as default Python virtualenv
organization:
name: "Foo"
description: "Foo bar organization using foo-venv"
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Create tower organization that pulls content from galaxy.ansible.com
- name: Create organization that pulls content from galaxy.ansible.com
organization:
name: "Foo"
state: present

12
awx_collection/plugins/modules/project.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: project
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller projects
short_description: create, update, or destroy Automation Platform Controller projects
description:
- Create, update, or destroy Automation Controller projects. See
- Create, update, or destroy Automation Platform Controller projects. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -160,7 +160,7 @@ options:
type: bool
interval:
description:
- The interval to request an update from Tower.
- The interval to request an update from the controller.
- Requires wait.
required: False
default: 1
@@ -170,7 +170,7 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Add tower project
- name: Add project
project:
name: "Foo"
description: "Foo bar project"
@@ -178,7 +178,7 @@ EXAMPLES = '''
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add Tower Project with cache timeout
- name: Add Project with cache timeout
project:
name: "Foo"
description: "Foo bar project"
@@ -188,7 +188,7 @@ EXAMPLES = '''
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Copy tower project
- name: Copy project
project:
name: copy
copy_from: test

6
awx_collection/plugins/modules/project_update.py
View File

@@ -13,9 +13,9 @@ DOCUMENTATION = '''
---
module: project_update
author: "Sean Sullivan (@sean-m-sullivan)"
short_description: Update a Project in Automation Controller
short_description: Update a Project in Automation Platform Controller
description:
- Update a Automation Controller Project. See
- Update a Automation Platform Controller Project. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -39,7 +39,7 @@ options:
type: bool
interval:
description:
- The interval to request an update from Tower.
- The interval to request an update from the controller.
required: False
default: 1
type: float

6
awx_collection/plugins/modules/receive.py
View File

@@ -20,9 +20,9 @@ deprecated:
why: Deprecated in favor of upcoming C(_export) module.
alternative: Once published, use M(tower_export) instead.
author: "John Westcott IV (@john-westcott-iv)"
short_description: Receive assets from Automation Controller.
short_description: Receive assets from Automation Platform Controller.
description:
- Receive assets from Automation Controller. See
- Receive assets from Automation Platform Controller. See
U(https://www.ansible.com/tower) for an overview.
options:
all:
@@ -101,7 +101,7 @@ extends_documentation_fragment: awx.awx.auth_legacy
'''
EXAMPLES = '''
- name: Export all tower assets
- name: Export all Automation Platform Controller assets
receive:
all: True
tower_config_file: "~/tower_cli.cfg"

4
awx_collection/plugins/modules/role.py
View File

@@ -16,10 +16,10 @@ DOCUMENTATION = '''
---
module: role
author: "Wayne Witzel III (@wwitzel3)"
short_description: grant or revoke an Automation Controller role.
short_description: grant or revoke an Automation Platform Controller role.
description:
- Roles are used for access control, this module is for managing user access to server resources.
- Grant or revoke Automation Controller roles to users. See U(https://www.ansible.com/tower) for an overview.
- Grant or revoke Automation Platform Controller roles to users. See U(https://www.ansible.com/tower) for an overview.
options:
user:
description:

6
awx_collection/plugins/modules/schedule.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: schedule
author: "John Westcott IV (@john-westcott-iv)"
short_description: create, update, or destroy Automation Controller schedules.
short_description: create, update, or destroy Automation Platform Controller schedules.
description:
- Create, update, or destroy Automation Controller schedules. See
- Create, update, or destroy Automation Platform Controller schedules. See
U(https://www.ansible.com/tower) for an overview.
options:
rrule:
@@ -131,7 +131,7 @@ EXAMPLES = '''
name: "{{ sched1 }}"
state: present
unified_job_template: "Demo Job Template"
rrule: "{{ query('awx.awx.tower_schedule_rrule', 'week', start_date='2019-12-19 13:05:51') }}"
rrule: "{{ query('awx.awx.schedule_rrule', 'week', start_date='2019-12-19 13:05:51') }}"
register: result
'''

6
awx_collection/plugins/modules/send.py
View File

@@ -20,9 +20,9 @@ deprecated:
why: Deprecated in favor of upcoming C(_import) module.
alternative: Once published, use M(tower_import) instead.
author: "John Westcott IV (@john-westcott-iv)"
short_description: Send assets to Automation Controller.
short_description: Send assets to Automation Platform Controller.
description:
- Send assets to Automation Controller. See
- Send assets to Automation Platform Controller. See
U(https://www.ansible.com/tower) for an overview.
options:
assets:
@@ -62,7 +62,7 @@ extends_documentation_fragment: awx.awx.auth_legacy
'''
EXAMPLES = '''
- name: Import all tower assets
- name: Import all Automation Platform Controller assets
send:
assets: "{{ export_output.assets }}"
tower_config_file: "~/tower_cli.cfg"

4
awx_collection/plugins/modules/settings.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: settings
author: "Nikhil Jain (@jainnikhil30)"
short_description: Modify Automation Controller settings.
short_description: Modify Automation Platform Controller settings.
description:
- Modify Automation Controller settings. See
- Modify Automation Platform Controller settings. See
U(https://www.ansible.com/tower) for an overview.
options:
name:

6
awx_collection/plugins/modules/team.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: team
author: "Wayne Witzel III (@wwitzel3)"
short_description: create, update, or destroy Automation Controller team.
short_description: create, update, or destroy Automation Platform Controller team.
description:
- Create, update, or destroy Automation Controller teams. See
- Create, update, or destroy Automation Platform Controller teams. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -50,7 +50,7 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Create tower team
- name: Create team
team:
name: Team Name
description: Team Description

10
awx_collection/plugins/modules/token.py
View File

@@ -17,15 +17,15 @@ DOCUMENTATION = '''
module: token
author: "John Westcott IV (@john-westcott-iv)"
version_added: "2.3"
short_description: create, update, or destroy Automation Controller tokens.
short_description: create, update, or destroy Automation Platform Controller tokens.
description:
- Create or destroy Automation Controller tokens. See
- Create or destroy Automation Platform Controller tokens. See
U(https://www.ansible.com/tower) for an overview.
- In addition, the module sets an Ansible fact which can be passed into other
tower_* modules as the parameter tower_oauthtoken. See examples for usage.
controller modules as the parameter tower_oauthtoken. See examples for usage.
- Because of the sensitive nature of tokens, the created token value is only available once
through the Ansible fact. (See RETURN for details)
- Due to the nature of tokens in Tower this module is not idempotent. A second will
- Due to the nature of tokens this module is not idempotent. A second will
with the same parameters will create a new token.
- If you are creating a temporary token for use with modules you should delete the token
when you are done with it. See the example for how to do it.
@@ -105,7 +105,7 @@ EXAMPLES = '''
RETURN = '''
token:
type: dict
description: An Ansible Fact variable representing a Tower token object which can be used for auth in subsequent modules. See examples for usage.
description: An Ansible Fact variable representing a token object which can be used for auth in subsequent modules. See examples for usage.
contains:
token:
description: The token that was generated. This token can never be accessed again, make sure this value is noted before it is lost.

12
awx_collection/plugins/modules/user.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: user
author: "John Westcott IV (@john-westcott-iv)"
short_description: create, update, or destroy Automation Controller users.
short_description: create, update, or destroy Automation Platform Controller users.
description:
- Create, update, or destroy Automation Controller users. See
- Create, update, or destroy Automation Platform Controller users. See
U(https://www.ansible.com/tower) for an overview.
options:
username:
@@ -71,7 +71,7 @@ extends_documentation_fragment: awx.awx.auth
EXAMPLES = '''
- name: Add tower user
- name: Add user
user:
username: jdoe
password: foobarbaz
@@ -81,7 +81,7 @@ EXAMPLES = '''
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add tower user as a system administrator
- name: Add user as a system administrator
user:
username: jdoe
password: foobarbaz
@@ -90,7 +90,7 @@ EXAMPLES = '''
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Add tower user as a system auditor
- name: Add user as a system auditor
user:
username: jdoe
password: foobarbaz
@@ -99,7 +99,7 @@ EXAMPLES = '''
state: present
tower_config_file: "~/tower_cli.cfg"
- name: Delete tower user
- name: Delete user
user:
username: jdoe
email: jdoe@example.org

2
awx_collection/plugins/modules/workflow_approval.py
View File

@@ -43,7 +43,7 @@ options:
type: str
interval:
description:
- The interval in sections, to request an update from Tower.
- The interval in sections, to request an update from the controller.
required: False
default: 1
type: float

6
awx_collection/plugins/modules/workflow_job_template.py
View File

@@ -16,11 +16,11 @@ DOCUMENTATION = '''
---
module: workflow_job_template
author: "John Westcott IV (@john-westcott-iv)"
short_description: create, update, or destroy Automation Controller workflow job templates.
short_description: create, update, or destroy Automation Platform Controller workflow job templates.
description:
- Create, update, or destroy Automation Controller workflow job templates.
- Create, update, or destroy Automation Platform Controller workflow job templates.
- Replaces the deprecated tower_workflow_template module.
- Use the tower_workflow_job_template_node after this, or use the schema parameter to build the workflow's graph
- Use workflow_job_template_node after this, or use the schema parameter to build the workflow's graph
options:
name:
description:

10
awx_collection/plugins/modules/workflow_job_template_node.py
View File

@@ -16,9 +16,9 @@ DOCUMENTATION = '''
---
module: workflow_job_template_node
author: "John Westcott IV (@john-westcott-iv)"
short_description: create, update, or destroy Automation Controller workflow job template nodes.
short_description: create, update, or destroy Automation Platform Controller workflow job template nodes.
description:
- Create, update, or destroy Automation Controller workflow job template nodes.
- Create, update, or destroy Automation Platform Controller workflow job template nodes.
- Use this to build a graph for a workflow, which dictates what the workflow runs.
- Replaces the deprecated tower_workflow_template module schema command.
- You can create nodes first, and link them afterwards, and not worry about ordering.
@@ -157,7 +157,7 @@ extends_documentation_fragment: awx.awx.auth
'''
EXAMPLES = '''
- name: Create a node, follows tower_workflow_job_template example
- name: Create a node, follows workflow_job_template example
workflow_job_template_node:
identifier: my-first-node
workflow: example-workflow
@@ -283,7 +283,9 @@ def main():
wfjt_search_fields['organization'] = organization_id
wfjt_data = module.get_one('workflow_job_templates', name_or_id=workflow_job_template, **{'data': wfjt_search_fields})
if wfjt_data is None:
module.fail_json(msg="The workflow {0} in organization {1} was not found on the Tower server".format(workflow_job_template, organization))
module.fail_json(
msg="The workflow {0} in organization {1} was not found on the controller instance server".format(workflow_job_template, organization)
)
workflow_job_template_id = wfjt_data['id']
search_fields['workflow_job_template'] = new_fields['workflow_job_template'] = workflow_job_template_id

6
awx_collection/plugins/modules/workflow_launch.py
View File

@@ -13,9 +13,9 @@ DOCUMENTATION = '''
---
module: workflow_launch
author: "John Westcott IV (@john-westcott-iv)"
short_description: Run a workflow in Automation Controller
short_description: Run a workflow in Automation Platform Controller
description:
- Launch an Automation Controller workflows. See
- Launch an Automation Platform Controller workflows. See
U(https://www.ansible.com/tower) for an overview.
options:
name:
@@ -55,7 +55,7 @@ options:
type: bool
interval:
description:
- The interval to request an update from Tower.
- The interval to request an update from the controller.
required: False
default: 1
type: float

2
awx_collection/plugins/modules/workflow_node_wait.py
View File

@@ -37,7 +37,7 @@ options:
type: str
interval:
description:
- The interval in sections, to request an update from Tower.
- The interval in sections, to request an update from the controller.
required: False
default: 1
type: float

4
awx_collection/plugins/modules/workflow_template.py
View File

@@ -20,7 +20,7 @@ deprecated:
why: Deprecated in favor of C(_workflow_job_template) and C(_workflow_job_template_node) modules.
alternative: Use M(tower_workflow_job_template) and M(_workflow_job_template_node) instead.
author: "Adrien Fleury (@fleu42)"
short_description: create, update, or destroy Automation Controller workflow template.
short_description: create, update, or destroy Automation Platform Controller workflow template.
description:
- A tower-cli based module for CRUD actions on workflow job templates.
- Enables use of the old schema functionality.
@@ -64,7 +64,7 @@ options:
description:
- >
The schema is a JSON- or YAML-formatted string defining the
hierarchy structure that connects the nodes. Refer to Tower
hierarchy structure that connects the nodes. Refer to the Automation Platform
documentation for more information.
type: list
elements: dict