AWX in Action

What you'll learn

	You'll start with the essentials of setting up AWX in your environment. We will explore various installation methods, including using Docker and deploying AWX to a Kubernetes cluster. Documentation regarding installation can be overwhelming, but we will simplify the process and guide you through the steps to get AWX up and running — straightforward and hassle-free.
	Dive into managing hosts and inventories within AWX. You will learn how to create and manage static and dynamic inventories (e.g., AWS), group hosts, add credentials, and use constructed inventories for more advanced scenarios.
	Master the core components of AWX by exploring projects, job templates, and jobs. You'll learn how to create and manage projects, configure job templates, run ad hoc commands, and launch and schedule jobs.
	You'll understand the lifecycle of an AWX job and how to orchestrate complex workflows using workflow templates and surveys.
	You'll learn about enabling content signature validation to reinforce the integrity of your automation content.
	You will understand project synchronization, job notifications, and how to manage job artifacts.
	Discover the power of the AWX Command Line Interface (CLI). Learn what the AWX CLI is, why it is beneficial, and how to install and authenticate it.
	You'll explore generating organization-scoped tokens, managing resources, and importing and exporting data.
	Gain insights into execution environments and instances. Learn about creating custom execution environments using Ansible Builder and Ansible Runner, adding and building execution environments, and managing execution and hop instances.
	You will dive into instance groups, clustering, container groups, and capacity adjustment to optimize your automation infrastructure.

	You'll start with the essentials of setting up AWX in your environment. We will explore various installation methods, including using Docker and deploying AWX to a Kubernetes cluster. Documentation regarding installation can be overwhelming, but we will simplify the process and guide you through the steps to get AWX up and running — straightforward and hassle-free.
	Dive into managing hosts and inventories within AWX. You will learn how to create and manage static and dynamic inventories (e.g., AWS), group hosts, add credentials, and use constructed inventories for more advanced scenarios.
	Master the core components of AWX by exploring projects, job templates, and jobs. You'll learn how to create and manage projects, configure job templates, run ad hoc commands, and launch and schedule jobs.
	You'll understand the lifecycle of an AWX job and how to orchestrate complex workflows using workflow templates and surveys.
	You'll learn about enabling content signature validation to reinforce the integrity of your automation content.
	You will understand project synchronization, job notifications, and how to manage job artifacts.
	Discover the power of the AWX Command Line Interface (CLI). Learn what the AWX CLI is, why it is beneficial, and how to install and authenticate it.
	You'll explore generating organization-scoped tokens, managing resources, and importing and exporting data.
	Gain insights into execution environments and instances. Learn about creating custom execution environments using Ansible Builder and Ansible Runner, adding and building execution environments, and managing execution and hop instances.
	You will dive into instance groups, clustering, container groups, and capacity adjustment to optimize your automation infrastructure.
	Explore the various settings in AWX, including authentication, job settings, and logging.
	Understand how and where to configure settings, manage cache, debug, and logging settings, and other advanced options to optimize your AWX environment.
	Understand how to monitor your AWX setup and view status updates.
	You will learn about different status views like the dashboard, jobs, schedules, and activity streams.
	You will explore management jobs, notifications, logging, and metrics to keep track of your automation processes. If you plan to monitor your automation using Prometheus, this guide gives you a head start.
	Put your knowledge into practice with a real-world example. Learn how to use custom execution environments and external roles, create workflows, schedule and send notifications, launch jobs using the AWX CLI, AWX API, and from your CI pipelines.
	You will be equipped with the necessary knowledge and skills to succeed in your AWX adoption journey, whether you are working independently or collaborating as part of a team.
	Understand how to organize your automation environment by setting up organizations, users, and teams in AWX. Learn how these elements fit together and how they can be used to manage permissions and secure your automation processes.

Read less

Description

You know Ansible. Your playbooks work. But your team is drowning in YAML sprawl, missed schedules, untracked changes, and "who ran what when" questions nobody can answer.

AWX fixes this if you know how to wield it.

"AWX in Action: Ansible Orchestration at Scale" is the practical guide for Ansible users ready to graduate from command-line scripts to a production-grade automation platform. AWX is the most powerful way to scale Ansible beyond CLI execution. But the official docs are dense, the moving parts are many, and most teams adopt AWX without ever using half of what it can do.

This book ch…

You know Ansible. Your playbooks work. But your team is drowning in YAML sprawl, missed schedules, untracked changes, and "who ran what when" questions nobody can answer.

AWX fixes this if you know how to wield it.

This book changes that.

Written by Aymen El Amri - a cloud-native engineer with 15+ years in production systems, founder of FAUN.dev, and recognized by TechBeacon among the top 100 DevOps professionals to follow - this guide distills years of consulting engagements and battle-tested workshop teaching into a single hands-on reference.

Installation and architecture

Install AWX on Docker or K8s using the AWX Operator. Understand the architecture (web pods, task pods, PostgreSQL, receptor) so you can debug it - not just deploy it.
Configure authentication, logging, and job settings including SAML, LDAP, OAuth, and external log forwarding to Splunk, Logstash, or Loki.

Access control and organization

Structure your platform with organizations, teams, users, and granular RBAC that scales past a 5-person team.
Manage credentials securely with credential types, custom credentials, and integration with external secret stores.

Inventories and hosts

Build inventories that fit your environment: static lists, dynamic AWS inventories, constructed inventories, smart inventories, and host groups - with practical patterns for each.

Orchestration

Create job templates and surveys with parameterized inputs, custom playbooks, and content signature validation.
Build workflow templates with approval nodes, conditional branches, and notification triggers across start, success, and failure stages.
Master the AWX CLI and API, including organization-scoped tokens, resource import/export, and CI-triggered job launches.

Custom execution environments

Build production-ready execution environments with Ansible Builder and Ansible Runner - the modern replacement for legacy virtualenvs.

Scaling and high availability

Run AWX in HA mode with execution and hop instances, instance groups, clustering, container groups, and capacity tuning.

Monitoring and observability

Answer "what's running, what failed, and who did what" with AWX's status views, activity streams, workflow approvals, notifications, Prometheus metrics, and structured logs from pods and receptor nodes

CI/CD integration

Launch AWX jobs from your pipelines using the CLI and API - with a complete real-world example you can adapt directly.

The book closes with a complete real-world example: custom execution environments, external roles, scheduled workflows, notifications, and CI-triggered jobs - an end-to-end reference you can adapt directly to your own infrastructure.

Who this book is for: Experienced Ansible users, DevOps engineers, SREs, sysadmins, and platform teams who want to move beyond ansible-playbook and operate Ansible like production infrastructure - not just script it.

What sets this book apart: Built from real consulting engagements and a battle-tested workshop, not vendor marketing. Every chapter explains not just how AWX works but why - so you can debug, extend, and operate it long after you finish reading.

Read less

Tools and technologies you will practice

AWX

Docker

Ansible

Kubernetes

Learning path

Follow the winding road from start to finish

Why This Book Exists

5 sections · 30m read

Who This Guide Is For 9m What You Will Learn 13m About the Author 3m Join the Community 2m Your Feedback Matters 3m

How to Get the Most Out of This Book

2 sections · 18m read

What This Book Asks of You 9m Conventions 9m

AWX Decoded: Architecture, Ecosystem, and the Tradeoffs That Matter

5 sections · 36m read

How Ansible Became AWX 6m Ansible Core vs. AWX: When Each One Wins 8m What Upstream AWX Doesn't Give You 6m Which One Should You Actually Pick? 3m Under the Hood: The AWX Architecture 13m

From Zero to AWX: A Kubernetes Install That Actually Works

2 sections · 45m read

What You'll Need: Hardware, OS, and Network 10m Deploying AWX on K3s With the Operator 35m

The AWX Object Model: Organizations, Teams, and RBAC From Day One

4 sections · 32m read

Organizations: Where Everything Lives 2m Users and the Three User Types 5m Teams: Less Permission Pain 4m The Object Model in One Page 21m

Inventories Done Right: From Static Hosts to Dynamic Cloud Discovery

5 sections · 108m read

What Inventories Actually Do 9m Creating Your First Inventory 15m Credentials: How AWX Connects to Hosts 9m Constructed Inventories in Depth 32m Dynamic Inventories: Letting the Cloud Build Your Inventory 43m

Execution Environments Demystified: Build Once, Run Anywhere, Pin Every Version

7 sections · 59m read

Why Execution Environments Exist 13m What Happens Between "Launch" and the Pod 8m Meet Ansible Builder 8m Ansible Runner: The Wrapper Inside Every EE 2m Adding and Managing EEs in AWX 8m Building Your First Custom EE 12m What Builder Actually Does Under the Hood 8m

Scale AWX Without Breaking It: Mesh, Hop Nodes, and Capacity Planning

8 sections · 67m read

Control Nodes: The Brain of the Cluster 1m Execution Instances: Where Jobs Actually Run 16m Hop Nodes: Reaching Across Firewalls and NATs 7m Hybrid Nodes (and Why You Won't Use Them on Kubernetes) 1m Instance Groups: Splitting Workloads by Intent 12m Capacity, Forks, and the Math Behind Scheduling 16m Container Groups: Running Jobs as Kubernetes Pods 13m Seeing the Whole Mesh: The Topology View 1m

From Playbook to Production: Projects, Templates, Jobs, and Workflows in Practice

8 sections · 160m read

Ad-Hoc Commands: One-Liners Without a Playbook 11m Projects: Where Your Playbooks Live 59m Job Templates: The Reusable Definition 32m Launching Your First Job 1m Scheduling Jobs (the Right and Wrong Ways) 12m Workflow Templates: Chaining Jobs Into a DAG 28m Surveys: Turning Templates Into Forms 12m Key Objects and Their Relationships in Task Automation 5m

What Really Happens When You Hit Launch: The AWX Job Lifecycle

7 sections · 10m read

Step 1: User launches a job 1m Step 2: Task Manager picks up the pending job 1m Step 3: pg_notify hands off to the dispatcher 3m Step 4: TaskWorker prepares the payload 1m Step 5: Receptor routes the work 1m Step 6: The playbook runs in the EE container 1m Step 7: Events flow back 2m

Skip the UI: Driving AWX Entirely From the Command Line

7 sections · 63m read

What the AWX CLI Actually Is 1m Why Bother With the CLI? 3m Installing the CLI on Any Platform 3m Three Ways to Authenticate 10m OAuth Applications: Per-Integration Credentials 17m Generating Tokens From an Application 7m Using the CLI in Real Workflows 22m

From Git Push to Running PostgreSQL: An End-to-End AWX Workflow

5 sections · 67m read

The Building Blocks: Custom EE, Project, and Job Templates 19m Chaining Deploy and Check Into One Workflow 6m Monitoring on a Schedule, Alerting on Failure 5m Launching the Workflow From the CLI 5m Triggering Workflows From CI: A GitHub Actions Example 32m

Inside the AWX Settings Menu: Auth Methods, Job Limits, and the Defaults Worth Changing

7 sections · 17m read

Authentication: SSO, LDAP, OIDC, and the Local Fallback 3m Jobs: Ad Hoc Module Allowlist, Fact Cache TTL, and Job Limits 4m System: Activity Stream, Base URL, and Reverse Proxy Headers 2m Auth Behaviors: Basic Auth, Sessions, and OAuth2 Tokens 2m Logging: Shipping AWX Events to an Aggregator 2m UI: Custom Logo and Login Message 1m Troubleshooting: Keep Job Dirs, Profile Requests, Receptor Cleanup 3m

Watching AWX: Status Views, Notifications, Logs, and Prometheus Metrics

5 sections · 38m read

Status Views in the AWX UI 7m Management Jobs: AWX's Built-In Cleanup Schedules 3m Notifications: Templates, Custom Messages, and Inheritance Rules 13m Logs: AWX Pods, Receptor Nodes, and Where to Look First 10m Metrics: The Prometheus Endpoint and What It Exposes 5m

Afterword: Where to Go From Here

2 sections · 8m read

What's Next? 5m Your Feedback Matters 3m

The author

Aymen El Amri

@eon01

Aymen El Amri is a software engineer, author, and founder of FAUN.dev, a platform and newsletter network serving hundreds of thousands of developers across DevOps, cloud native, Kubernetes, and applied AI. He writes practical, hands-on technical books for engineers, covering Docker, Kubernetes, Ansible, AWX, Python, and large language models. His work focuses on turning complex infrastructure and AI topics into clear, example-driven guides that practitioners can apply immediately. More at FAUN.dev.