Ansible

Ansible Operations

When to Use

• Agent needs to execute Ansible playbooks or commands.
• User needs to run Ansible automation scripts.
• Troubleshooting hanging issues during Ansible execution.

When Not to Use

• For localized script automation on a single machine where simple shell scripts suffice.
• For managing ephemeral, immutable container infrastructure better suited for Terraform or Dockerfiles.
• When the task explicitly requires agentic AI decision-making loops (Ansible is deterministic).

Common Pitfalls

• Interactive Hangs: Failing to set DEBIAN_FRONTEND=noninteractive or handling sudo passwords poorly, causing the agent to hang indefinitely.
• Ignoring Idempotency: Writing raw shell commands (ansible.builtin.shell) instead of using native Ansible modules, breaking the idempotency guarantee of playbooks.
• Masking Errors: Using ignore_errors: yes to bypass failures rather than fixing the underlying system state.

Troubleshooting

Ansible Environment issues

If you encounter hangs during Ansible execution, especially when interacting with package managers like apt on Debian/Ubuntu systems:

• Use the DEBIAN_FRONTEND environment variable to prevent prompts from hanging the process.
• Set DEBIAN_FRONTEND=noninteractive when running your Ansible commands or in your playbook environment.
• Example: DEBIAN_FRONTEND=noninteractive ansible-playbook playbook.yml

Prohibiting Mocking for Workarounds

Do NOT use mocking to work around unexpected errors:

• Never use mock_modules or mock_roles to bypass tasks that are failing due to environment-specific issues or other "shouldn't happen" errors.
• Underlying issues must be fixed directly; do not mask failures with mocks to unblock progress.

Performance Profiling

To profile the execution time of your playbooks and roles, you can enable the profile_tasks callback plugin. This is useful for identifying slow tasks and optimizing your automation.

• Enable the plugin by adding it to your ansible.cfg file under [defaults] or via environment variables.
• Using environment variables: ANSIBLE_CALLBACKS_ENABLED=profile_tasks ansible-playbook playbook.yml
• In ansible.cfg:

``ini [defaults] callbacks_enabled = ansible.posix.profile_tasks ``

Related Skills

• molecule:

You MUST load this skill when running or managing Molecule tests for Ansible.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: Cogni-AI-OU
• Source: Cogni-AI-OU/cogni-ai-agent-skills
• License: MIT

Install and usage instructions live in the source repository linked above.