Yogesh blog

Integrating Jenkins with Ansible for Seamless CI/CD Workflows

Yogesh Borude's photo
Yogesh Borude
·

4 min read

In the realm of DevOps, automation is essential for achieving efficiency and consistency across development and production environments. One of the most powerful combinations for automating infrastructure provisioning, configuration management, and application deployment is the integration of Jenkins and Ansible. This blog will guide you through the steps to achieve this integration on an Ubuntu machine.

Why Integrate Jenkins and Ansible?

Jenkins serves as an open-source automation server that facilitates Continuous Integration (CI) and Continuous Delivery (CD) in software projects. Ansible, on the other hand, is an automation tool that simplifies configuration management and deployment through a human-readable language called YAML. By combining these two powerful tools, you can streamline your CI/CD workflows and maintain consistency across multiple environments.

Prerequisites

Before diving into the integration process, ensure you have the following:

  • An Ubuntu machine (VM or server)

  • Jenkins installed and running

  • Ansible installed on the Jenkins server

Step-by-Step Setup

1. Install Jenkins on Ubuntu

If Jenkins is not already set up on your machine, follow these steps to install it:

  1. Update System Packages:

    bashCopy

     sudo apt update
 sudo apt upgrade -y

  2. Install Java: Jenkins requires Java to run. Install OpenJDK:

     sudo apt install openjdk-11-jdk -y

  3. Add Jenkins Repository and Install Jenkins:

     wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
 sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
 sudo apt update
 sudo apt install jenkins -y

  4. Start and Enable Jenkins Service:

     sudo systemctl start jenkins
 sudo systemctl enable jenkins

  5. Access Jenkins: Open your web browser and go to http://your_server_ip_or_domain:8080 to complete the Jenkins setup.

2. Install Ansible on Ubuntu

If Ansible is not installed yet, you can do so by following these steps:

  1. Add Ansible PPA:

     sudo apt update
 sudo apt install software-properties-common -y
 sudo add-apt-repository --yes --update ppa:ansible/ansible

  2. Install Ansible:

     sudo apt install ansible -y

  3. Verify Ansible Installation:

     ansible --version

3. Configure Jenkins for Ansible Integration

  1. Install the Ansible Plugin in Jenkins:

    • Go to Jenkins Dashboard → Manage Jenkins → Manage Plugins.

    • In the "Available" tab, search for "Ansible" and install the "Ansible" plugin.

    • Restart Jenkins after the plugin installation.

  2. Configure Ansible in Jenkins:

    • Go to Jenkins Dashboard → Manage Jenkins → Global Tool Configuration.

    • Scroll down to the "Ansible" section and click "Add Ansible".

    • Provide a name (e.g., "Ansible") and specify the path to your Ansible executable (/usr/bin/ansible).

  3. Add Ansible Credentials in Jenkins:

    • Go to Jenkins Dashboard → Manage Jenkins → Manage Credentials.

    • Add new SSH credentials with the necessary details for remote access.

4. Create a Jenkins Job to Run Ansible Playbook

  1. Create a New Jenkins Job:

    • Go to Jenkins Dashboard → New Item → Freestyle Project.

    • Enter a name for your job and select "Freestyle project".

  2. Configure Source Code Management:

    • Under the "Source Code Management" section, select "Git" and provide your repository URL and credentials.

  3. Add Build Step to Run Ansible Playbook:

    • In the "Build" section, click "Add build step" and select "Invoke Ansible Playbook".

    • Fill in the details for the playbook path, inventory, and SSH credentials.

  4. Save and Build the Job:

    • Save the configuration and click "Build Now" to run the job.

5. Create a Jenkins Pipeline to Run Ansible Playbook (Optional)

For a more advanced setup, you can create a pipeline job. Here’s a basic pipeline script to get you started:

pipeline {
    agent any
    stages {
        stage('Checkout') {
            steps {
                git url: 'https://github.com/your-repo/your-ansible-playbook.git', credentialsId: 'your-credentials-id'
            }
        }
        stage('Run Ansible Playbook') {
            steps {
                ansiblePlaybook playbook: 'your-playbook.yml', inventory: 'your-inventory', credentialsId: 'your-credentials-id'
            }
        }
    }
}

Replace placeholders with your repository URL, playbook path, inventory file, and credentials ID.

Conclusion

Integrating Jenkins with Ansible significantly enhances your DevOps capabilities by automating infrastructure management tasks. By following the steps outlined above, you can set up a robust CI/CD workflow that leverages the strengths of both tools. This integration not only streamlines your processes but also enables your team to focus on more meaningful development tasks, ultimately accelerating your deployment cycles.

For more information, you can refer to the official Jenkins documentation and Ansible documentation. Happy automating!

DevopsJenkinsansibleautomationcicd