Ansible plugin

Navigate to DevOps Essentials  Plugin Management  Plugin configurations.

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.

Create a Task in your step and define the task to run the EC-Ansible plugin Run Playbook procedure.

Add the parameters for the task, such as shown in:

Run the pipeline. The following is an example of the step’s operations:

Create a Task in your step and define the task to run the EC-Ansible plugin Run adhoc procedure.

Add the parameters for the task, such as shown in:

Run the pipeline. The following is an example of the step’s operations:

Create Plugin configuration. If you have not created a Windows configuration, refer to Configuring for Windows hosts.

Create Run Ad-Hoc Command procedure:

Run the procedure. Expected outcome should be:

Or use the following sample Windows playbook for the Run Playbook procedure on Windows hosts:

Create a pipeline.

Add a pipeline stage with a step and define it to use the EC-Ansible plugin Run Playbook procedure.

Select Define and edit the Procedure Input Parameters.

Define Procedure parameters:

Select OK and Save.

Create an application.

Create an application component using EC-Artifact or EC-Artifactory to retrieve the application’s Tomcat '*.war' artifact.

Create an application process

Create a step to run the EC-Ansible Run Playbook procedure.

Choose Plugins  Resource Management  Ansible  Run Playbook procedure.

Add your procedure parameters, path to Ansible inventory with hosts and path to the sample deploy-playbook.yml:

Deploy the following sample deploy-playbook.yml in the path you added for the procedure parameter.

---
- name: Deploy Application
 hosts: linux-vm1
 connection: ssh
 become: true
 become_user: root
 become_method: sudo
 vars:
   user: build
 tasks:
 - name: Delete application if exist
   file:
     state: absent
     path: /var/lib/tomcat7/webapps/hello-world.war
 - name: Copy Artifact to remote Tomcat Server
   copy:
     src: /home/ecloud/ansible/application/hello-world.war
     dest: /var/lib/tomcat7/webapps/
     owner: root
     group: root
     mode: 0644
 - name: Show application is copied
   shell: "ls -l /var/lib/tomcat7/webapps"
   register: out
 - debug: msg="{{ out.stdout_lines }}"
 - name: Restart Tomcat server
   shell: service tomcat7 restart
   register: restart
 - debug: msg="{{ restart.stdout_lines }}"
....

Map the application to an existing an Ansible resource (local or remote) and run the application.

Create a sample playbook and encrypt it using the following command:

ansible-vault encrypt /path/to/playbook.yml --ask-vault-pass.

Provide the vault password.

Create a new plugin configuration and set the Vault credentials. Ensure your ansible playbook path and password match the vault you want to use. For instance:

When you run Ansible Run Playbook procedures, ensure you set the Configuration name to the one you configured the Vault credentials for.