Plugin version 1.1.4
Revised on December 14, 2022
Overview
This plugin provides CloudBees CD/RO integration to Ansible Tower, allowing you to run Ansible playbooks.
Note the following:
-
Ansible Tower inventory tracks hosts, but does not track deployed artifacts.
-
The plugin does not automatically populate inventory.
-
You can specify your deployed artifacts, which are then populated in the inventory during a successful deployment to your hosts.
-
You can extract artifacts with a user-defined regexp.
-
-
Inventory is not updated when a component is not present.
Supported versions
The plugin has been tested with the following versions:
-
Ansible Automation Platform Controller 4.1.0
Plugin configurations
Plugin configurations are sets of parameters that can be applied across some, or all, of the plugin procedures. They can reduce the repetition of common values, create predefined parameter sets, and securely store credentials. Each configuration is given a unique name that is entered in the designated parameter for the plugin procedures that use them.
Creating plugin configurations
To create plugin configurations in CloudBees CD/RO, complete the following steps:
-
Navigate to
. -
Select Add plugin configuration to create a new configuration.
-
In the New Configuration window, specify a Name for the configuration.
-
Select the Project that the configuration belongs to.
-
Optionally, add a Description for the configuration.
-
Select the appropriate Plugin for the configuration.
-
Configure the parameters per the descriptions below.
Configuration procedure parameters
Parameter | Description |
---|---|
Ignore SSL issues |
Turn SSL verification off for instances with self-signed certificates. |
Configuration name |
Required. The unique name for the configuration. |
Description |
The configuration description. |
Ansible Tower Server |
Required. |
Auth scheme |
Required. The authorization scheme for the third-party connection. |
Check Connection? |
If checked, the connection endpoint and credentials entered as part of the configuration will be tested. If this option is checked, configuration will not be saved if the test fails. |
Debug level |
This option sets the debug level for logs. If Info is selected, only a summary is displayed. If Debug is selected, debug information is displayed. If Trace is selected, all requests and responses are displayed. |
Modeling third-party deployments
You can model third-party deployments using the Ansible Tower plugin and Service Catalog item.
To model a third-party deployment with Ansible Tower:
-
Navigate to the Service Catalog.
-
Select Deploy.
-
Select your project.
-
Enter your deployment model details, including the Ansible Tower configuration, job template ID, and regular expression.
-
Select OK.
When you deploy the catalog item, the system creates an application and an environment.
The application contains a three-step component without artifacts.
-
Runs the Ansible playbook. This process requires the Ansible Tower plugin.
-
A placeholder that allows you to add logic to extract artifacts.
-
Seeds the artifacts into the path-to-production inventory.
For more information, refer to Service catalog.
Plugin procedures
Create a Job Template
This procedure creates a job template.
Create an Inventory
This procedure creates an inventory.
Launch a Job Template
This procedure launches a job template.
Launch and Wait a Job Template
This procedure launches a job template and waits for its execution.
Launch and Wait a Job Template parameters
Parameter | Description |
---|---|
Configuration name |
Required. The unique name for the configuration. |
Job Template Id |
Required. The ID of the job template to launch. |
Job Template Parameters |
Parameters of the job template to launch. For example: |
Job Status Polling Interval |
Specifies the frequency, in seconds, to check the job status. |
Depend On Ansible Tower Job Result? |
Checks to enable depend on job status mechanics. In this case, the job result is synchronized with the Ansible Tower job result. |
List Inventories
This procedure lists all the inventories.
List Job Templates
This procedure lists all job templates.
List Organizations
This procedure lists all the organizations.
List Projects
This procedure lists all the projects.
Retrieve a Job Template
This procedure retrieves a job template.
Release notes
EC-AnsibleTower 1.1.4
-
The dynamic dropdown parameter fields were replaced with text fields and validation were removed for the following procedures:
-
Retrieve a Job Template
-
Launch a Job Template
-
Launch and Wait a Job Template
-
Retrieve an Inventory
-
EC-AnsibleTower 1.1.2
-
Updated jackson-databind to 2.14.0-rc1.
-
Fixed issue with dynamic dropdowns when Ansible Tower server endpoint ends with ´/´.