Custom hello-world Ansible Filter Plugin

Unveiling Ansible’s “hello-world” Filter Plugin in foo.bar: A Glimpse into Personalized Automation

December 4, 2023

Access the Complete Video Course and Learn Quick Ansible by 200+ Practical Lessons

#ansible #automation #filter-plugin #python #configuration-management #foo.bar #devops #scripting #hello-world #plugin-development #playbooks #greeting #personalization #code-example #scripting #custom-filters #it-automation #workflow-automation #ansible-modules

Introduction

In the world of automation and configuration management, Ansible plays a pivotal role in simplifying complex tasks and orchestrating diverse systems. One of the key features that makes Ansible highly versatile is the ability to extend its functionality through plugins. In this article, we’ll dive into the “hello-world" filter plugin written in Python for Ansible within the foo.bar namespace.

Understanding the Basics

The “hello-world” filter plugin is a simple yet illustrative example of a filter plugin in Ansible. The purpose of this plugin is to generate a personalized greeting message, taking a name as input and returning a “Hello, [name]” message.

"""A hello-world filter plugin in foo.bar collection."""

from __future__ import absolute_import, division, print_function

__metaclass__ = type

DOCUMENTATION = r"""
  name: hello-world
  author: Luca Berton <[email protected]>
  version_added: "1.0.0"  # same as collection version
  short_description: hello world
  description:
      - This filter returns the hello from a name input.
  positional: _input
  options:
    _input:
      description: Name to show.
      type: raw
      required: true
"""

def _hello_world(name):
    """Returns Hello message."""
    return "Hello, " + name

class FilterModule:
    """filter plugin."""

    def filters(self):
        """filter plugin."""
        return {"hello_world": _hello_world}

The Best Resources For Ansible

Certifications

The Linux Foundation Linux Performance Tuning - Build a broad toolkit to optimize Linux performance from the kernel up

Coursera Pro - Unlimited access to 7,000+ world-class courses, hands-on projects, and job-ready certificate programs—all included in your subscription

Video Course

Udemy: Learn Ansible Automation in 250+examples & practical lessons: Learn Ansible with some real-life examples of how to use the most common modules and Ansible Playbook

Printed Book

eBooks

Let’s break down the key components of the provided Python script, hello_world.py:

Metadata Section:

name: Specifies the name of the filter plugin.
author: Indicates the author of the plugin along with their contact email.
version_added: Denotes the version in which the plugin was added.
short_description: Provides a brief overview of the plugin.
description: Offers more detailed information about the plugin, including its purpose.
positional: Defines the positional arguments that the plugin accepts.
options: Describes the options, such as input parameters, that the plugin supports.

Filter Implementation:

_hello_world function: This private function takes a name as an argument and returns a greeting message.
FilterModule class: Defines the filter plugin and its associated methods. filters method: Specifies the filters provided by the plugin. In this case, it includes the “hello_world” filter, which is mapped to the _hello_world function.

Practical Use

To utilize this filter plugin in an Ansible playbook, you can invoke it using the hello_world filter with a specific name as input. Here’s an example:

---
- name: Example Playbook
  hosts: localhost
  tasks:
    - name: Display Hello World Message
      debug:
        msg: "{{ 'Your Name' | hello_world }}"

Replace ‘Your Name’ with the desired name, and when you run this playbook, it will output a message like:

TASK [Display Hello World Message] ********************************************
ok: [localhost] => {
    "msg": "Hello, Your Name"
}

Conclusion

Understanding filter plugins in Ansible is crucial for extending the capabilities of your automation scripts. The “hello-world” filter plugin we explored provides a foundation for creating more complex filters tailored to specific use cases. By customizing and expanding upon this example, you can enhance your Ansible playbooks with personalized and dynamic content. Happy automating!

Subscribe to the YouTube channel, Medium, and Website, X (formerly Twitter) to not miss the next episode of the Ansible Pilot.