Kick off your book project in 3 hours! Live workshop on Zoom. You’ll leave with a real book project, progress on your first chapter, and a clear plan to keep going. Saturday, June 6, 2026. Learn more…

Leanpub Header

Skip to main content

AWX in Action

Ansible Orchestration at Scale

This book is 100% completeLast updated on 2026-05-27

Unlock more of Ansible's superpowers with AWX

Minimum price

$30.99

$35.99

You pay

Author earns

$

Buying multiple copies for your team? See below for a discount!

PDF
EPUB
WEB
About

About

About the Book

In this guide, you will embark on a comprehensive journey through AWX, the powerful web-based interface for Ansible. By the end of this guide, you will have gained a thorough understanding of how to leverage AWX to enhance and scale your automation workflows.

Here's a preview of what you'll learn:

Installation and Configuration

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.

AWX Organizations, Users, and Teams

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 streamline your automation processes.

Hosts and Inventories

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.

Projects, Templates, and Jobs

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. Additionally, you'll understand the lifecycle of an AWX job and how to automate complex workflows using workflow templates and surveys. You'll also learn about enabling content signature validation to ensure the integrity of your automation content. You will understand project synchronization, job notifications, and how to manage job artifacts. This part is crucial for understanding how to automate your automation, and that's why this guide focuses on it by providing practical examples and best practices.

AWX CLI

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 also explore generating organization-scoped tokens, managing resources, and importing and exporting data.

Execution Environments and Instances

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 also delve into instance groups, clustering, container groups, and capacity adjustment to optimize your automation infrastructure. This guide covers this part as it is crucial for scaling your automation and ensuring high availability. It not only provides practical examples but also shares how AWX internally works to help you understand the concepts better.

AWX Settings

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 settings to optimize your AWX environment.

AWX Monitoring and Status Views

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. Additionally, 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 and Grafana, this guide gives you a head start.

Real World Example

Finally, 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. This part goes back to the most important part of this guide, which is to provide you with a practical example that you can use as a starting reference for your future automation tasks.

By the end of this guide, you will be equipped with the necessary knowledge and skills to succeed in your AWX adoption journey as an individual or as part of a team.

Team Discounts

Team Discounts

Get a team discount on this book!

  • Up to 3 members

    Minimum price
    $77.00
    Suggested price
    $89.00
  • Up to 5 members

    Minimum price
    $123
    Suggested price
    $143
  • Up to 10 members

    Minimum price
    $216
    Suggested price
    $251
  • Up to 15 members

    Minimum price
    $309
    Suggested price
    $359
  • Up to 25 members

    Minimum price
    $464
    Suggested price
    $539

Author

About the Author

Aymen El Amri

Aymen El Amri is an author, entrepreneur, trainer, and polymath software engineer who has excelled in a range of roles and responsibilities in the field of technology including DevOps & Cloud Native, Cloud Architecture, Python, NLP, Data Science, and more.

Aymen has trained hundreds of software engineers and written multiple books and courses read by thousands of other developers and software engineers.

Aymen El Amri has a practical approach to teaching based on breaking down complex concepts into easy-to-understand language and providing real-world examples that resonate with his audience.

Some projects he founded are FAUN, eralabs.io, and Marketto. You can find Aymen on Twitter and Linkedin.

Leanpub Podcast

Episode 88

An Interview with Aymen El Amri

Contents

Table of Contents

Why This Book Exists (and Who It’s For)

  1. Who This Guide Is For
  2. What You Will Learn
  3. About the Author
  4. Join the Community
  5. Your Feedback Matters

How to Get the Most Out of This Book

  1. What This Book Asks of You
  2. How to Read This So It Sticks
  3. The Companion Kit
  4. Recommended Environment
  5. Conventions
  6. Heredoc

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

  1. How Ansible Became AWX
  2. Ansible Core vs. AWX: When Each One Wins
  3. What Upstream AWX Doesn’t Give You
  4. Which One Should You Actually Pick?
  5. Under the Hood: The AWX Architecture
  6. Execution environments
  7. Why AWX Needs Kubernetes
  8. The API Is the Real Product
  9. The Data Plane: PostgreSQL and Redis

From Zero to AWX: A Kubernetes Install That Actually Works

  1. What You’ll Need: Hardware, OS, and Network
  2. Deploying AWX on K3s With the Operator
  3. Getting Into the UI

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

  1. Organizations: Where Everything Lives
  2. Users and the Three User Types
  3. The Three User Types and When to Use Each
  4. Teams: Less Permission Pain
  5. Team roles
  6. The Object Model in One Page

Inventories Done Right: From Static Hosts to Dynamic Cloud Discovery

  1. What Inventories Actually Do
  2. Creating Your First Inventory
  3. Standard Inventory: The Default Choice
  4. Smart Inventory: Why You Shouldn’t Use It
  5. Constructed Inventory: The Modern Replacement
  6. Credentials: How AWX Connects to Hosts
  7. Constructed Inventories in Depth
  8. Dynamic Inventories: Letting the Cloud Build Your Inventory

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

  1. Why Execution Environments Exist
  2. What Happens Between “Launch” and the Pod
  3. Meet Ansible Builder
  4. Container Basics in Three Terms
  5. Anatomy of an Execution Environment
  6. Ansible Runner: The Wrapper Inside Every EE
  7. Adding and Managing EEs in AWX
  8. Building Your First Custom EE
  9. What Builder Actually Does Under the Hood

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

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

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

  1. Ad-Hoc Commands: One-Liners Without a Playbook
  2. Projects: Where Your Playbooks Live
  3. Creating a Manual Project (PV-Backed)
  4. Creating a Git-Backed Project
  5. Locking Down Projects With Signature Validation
  6. Job Templates: The Reusable Definition
  7. Building a Job Template, Field by Field
  8. Launching Your First Job
  9. Scheduling Jobs (the Right and Wrong Ways)
  10. Workflow Templates: Chaining Jobs Into a DAG
  11. Adding Human-in-the-Loop With Approval Nodes
  12. Surveys: Turning Templates Into Forms
  13. Key Objects and Their Relationships in Task Automation

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

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

Skip the UI: Driving AWX Entirely From the Command Line

  1. What the AWX CLI Actually Is
  2. Why Bother With the CLI?
  3. Installing the CLI on Any Platform
  4. Three Ways to Authenticate
  5. Authenticating From the CLI
  6. Authenticating With a curl Call
  7. Generating a Token From the Web UI
  8. OAuth Applications: Per-Integration Credentials
  9. Authorization Grant Types
  10. Authorization Code
  11. Resource Owner Password-Based Grant Type
  12. Redirect URIs and Why AWX Is Strict About Them
  13. Client Type: Confidential vs Public
  14. Confidential
  15. Public
  16. Generating Tokens From an Application
  17. Using the CLI in Real Workflows
  18. Output Formats: JSON, Human, and jq
  19. Backup and Restore: Export, Import, Done
  20. Managing Any Resource From the Command Line

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

  1. The Building Blocks: Custom EE, Project, and Job Templates
  2. Chaining Deploy and Check Into One Workflow
  3. Monitoring on a Schedule, Alerting on Failure
  4. Launching the Workflow From the CLI
  5. Triggering Workflows From CI: A GitHub Actions Example

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

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

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

  1. Status Views in the AWX UI
  2. Dashboard
  3. Jobs
  4. Schedules
  5. Activity Streams
  6. Workflow Approvals
  7. Management Jobs: AWX’s Built-In Cleanup Schedules
  8. Notifications: Templates, Custom Messages, and Inheritance Rules
  9. Logs: AWX Pods, Receptor Nodes, and Where to Look First
  10. Metrics: The Prometheus Endpoint and What It Exposes

Afterword: Where to Go From Here

  1. What’s Next?
  2. Your Feedback Matters

The Leanpub 60 Day 100% Happiness Guarantee

Within 60 days of purchase you can get a 100% refund on any Leanpub purchase, in two clicks.

Now, this is technically risky for us, since you'll have the book or course files either way. But we're so confident in our products and services, and in our authors and readers, that we're happy to offer a full money back guarantee for everything we sell.

You can only find out how good something is by trying it, and because of our 100% money back guarantee there's literally no risk to do so!

So, there's no reason not to click the Add to Cart button, is there?

See full terms...

Earn $8 on a $10 Purchase, and $16 on a $20 Purchase

We pay 80% royalties on purchases of $7.99 or more, and 80% royalties minus a 50 cent flat fee on purchases between $0.99 and $7.98. You earn $8 on a $10 sale, and $16 on a $20 sale. So, if we sell 5000 non-refunded copies of your book for $20, you'll earn $80,000.

(Yes, some authors have already earned much more than that on Leanpub.)

In fact, authors have earned over $15 million writing, publishing and selling on Leanpub.

Learn more about writing on Leanpub

Free Updates. DRM Free.

If you buy a Leanpub book, you get free updates for as long as the author updates the book! Many authors use Leanpub to publish their books in-progress, while they are writing them. All readers get free updates, regardless of when they bought the book or how much they paid (including free).

Most Leanpub books are available in PDF (for computers) and EPUB (for phones, tablets and Kindle). The formats that a book includes are shown at the top right corner of this page.

Finally, Leanpub books don't have any DRM copy-protection nonsense, so you can easily read them on any supported device.

Learn more about Leanpub's ebook formats and where to read them

Write and Publish on Leanpub

You can use Leanpub to easily write, publish and sell in-progress and completed ebooks and online courses!

Leanpub is a powerful platform for serious authors, combining a simple, elegant writing and publishing workflow with a store focused on selling in-progress ebooks.

Leanpub is a magical typewriter for authors: just write in plain text, and to publish your ebook, just click a button. (Or, if you are producing your ebook your own way, you can even upload your own PDF and/or EPUB files and then publish with one click!) It really is that easy.

Learn more about writing on Leanpub