ansible / ansible.builtin / v2.3.3.0-1 / module / tower_job_launch Launch an Ansible Job. | "added in version" 2.3 of ansible.builtin" Authors: Wayne Witzel III (@wwitzel3) preview | supported by communityansible.builtin.tower_job_launch (v2.3.3.0-1) — module
pip
Install with pip install ansible==2.3.3.0.post1
Launch an Ansible Tower jobs. See U(https://www.ansible.com/tower) for an overview.
- name: Launch a job tower_job_launch: job_template: "My Job Template" register: job
- name: Wait for job max 120s tower_job_wait: job_id: job.id timeout: 120
tags: default: null description: - Specific tags to use for from playbook. limit: default: null description: - Limit to use for the job_template. job_type: choices: - run - check - scan default: null description: - Job_type to use for the job, only used if prompt for job_type is set. inventory: default: null description: - Inventory to use for the job, only used if prompt for inventory is set. credential: default: null description: - Credential to use for job, only used if prompt for credential is set. extra_vars: default: null description: - Extra_vars to use for the job_template. Use '@' for a file. job_template: description: - Name of the job_template to use. required: true validate_certs: aliases: - tower_verify_ssl description: - Whether to allow insecure connections to AWX. - If C(no), SSL certificates will not be validated. - This should only be used on personally controlled sites using self-signed certificates. - If value not set, will try environment variable C(CONTROLLER_VERIFY_SSL) and then config files type: bool controller_host: aliases: - tower_host description: - URL to your Automation Platform Controller instance. - If value not set, will try environment variable C(CONTROLLER_HOST) and then config files - If value not specified by any means, the value of C(127.0.0.1) will be used type: str job_explanation: default: null description: - Job explanation field. request_timeout: description: - Specify the timeout Ansible should use in requests to the controller host. - Defaults to 10s, but this is handled by the shared module_utils code type: float use_job_endpoint: default: false description: - Disable launching jobs from job template. controller_password: aliases: - tower_password description: - Password for your controller instance. - If value not set, will try environment variable C(CONTROLLER_PASSWORD) and then config files type: str controller_username: aliases: - tower_username description: - Username for your controller instance. - If value not set, will try environment variable C(CONTROLLER_USERNAME) and then config files type: str controller_oauthtoken: aliases: - tower_oauthtoken description: - The OAuth token to use. - This value can be in one of two formats. - A string which is the token itself. (i.e. bqV5txm97wqJqtkxlMkhQz0pKhRMMX) - A dictionary structure as returned by the token module. - If value not set, will try environment variable C(CONTROLLER_OAUTH_TOKEN) and then config files type: raw version_added: 3.7.0 version_added_collection: awx.awx controller_config_file: aliases: - tower_config_file description: - Path to the controller config file. - If provided, the other locations for config files will not be considered. type: path
id: description: job id of the newly launched job returned: success sample: 86 type: int status: description: status of newly launched job returned: success sample: pending type: string