Ansible Pilot

Install Ansible AWX Operator for Kubernetes (K8s) and OpenShift (OCP) - Ansible AWX

How to deploy the latest Ansible AWX Operator in your local Red Hat OpenShift Local (formerly Red Hat CodeReady Containers), fully compatible with Kubernetes (K8s)

September 21, 2022
Access the Complete Video Course and Learn Quick Ansible by 200+ Practical Lessons

How to Install Ansible AWX Operator for Kubernetes (K8s) and OpenShift (OCP)?

Ansible AWX Operator is the preferred way to deploy an AWX instance in your network. The alternative way is to build and run Docker containers only for experienced users and developers. I’m Luca Berton and welcome to today’s episode of Ansible Pilot.

Install Ansible AWX

Ansible AWX is the upstream project of Ansible Automation Controller (formerly Ansible Tower), providing a modern web-UI and API interface to manage Ansible Playbooks, inventories, Credentials, and Vaults between your team in your organization. Running AWX using the AWX Operator is the preferred way for you to test the AWX web-UI and API to manage Ansible Playbook execution easily. Ansible AWX operator for Kubernetes built with Operator SDK and Ansible. AWX can also be installed and run in Docker, but this install path is only recommended for development/test-oriented deployments and has no official release.

The Best Resources For Ansible

Video Course

Books

demo

How to Install Ansible AWX Operator for Kubernetes (K8s). I will show you how to install the latest Ansible AWX Operator in your local Red Hat OpenShift Local (formerly Red Hat CodeReady Containers). If available, you can also use a Kubernetes (K8s) cluster or Red Hat OpenShift (OCP)cluster.

code

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
resources:
  # Find the latest tag here: https://github.com/ansible/awx-operator/releases
  - github.com/ansible/awx-operator/config/default?ref=<tag>
# Set the image tags to match the git version from above
images:
  - name: quay.io/ansible/awx-operator
    newTag: <tag>
# Specify a custom namespace in which to install AWX
namespace: awx

Substitute <tag> with the latest AWX operator release, for example, 0.29.0.

Kubernetes (K8s) execution

  1. Install the kustomize tool in your system
$ curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh"  | bash
  1. Install the customization manifests in Kubernetes (K8s) by running this:
$ ./kustomize build . | kubectl apply -f -
namespace/awx created
customresourcedefinition.apiextensions.k8s.io/awxbackups.awx.ansible.com created
customresourcedefinition.apiextensions.k8s.io/awxrestores.awx.ansible.com created
customresourcedefinition.apiextensions.k8s.io/awxs.awx.ansible.com created
serviceaccount/awx-operator-controller-manager created
role.rbac.authorization.k8s.io/awx-operator-awx-manager-role created
role.rbac.authorization.k8s.io/awx-operator-leader-election-role created
clusterrole.rbac.authorization.k8s.io/awx-operator-metrics-reader created
clusterrole.rbac.authorization.k8s.io/awx-operator-proxy-role created
rolebinding.rbac.authorization.k8s.io/awx-operator-awx-manager-rolebinding created
rolebinding.rbac.authorization.k8s.io/awx-operator-leader-election-rolebinding created
clusterrolebinding.rbac.authorization.k8s.io/awx-operator-proxy-rolebinding created
configmap/awx-operator-awx-manager-config created
service/awx-operator-controller-manager-metrics-service created
deployment.apps/awx-operator-controller-manager created
  1. Wait a bit, and you should have the awx-operator running:
$ kubectl get pods -n awx
NAME                                               READY   STATUS    RESTARTS   AGE
awx-operator-controller-manager-7d5f849d55-8sv9n   2/2     Running   0          76s

OpenShift (OCP) execution

  1. Install the kustomize tool in your system
curl -s "https://raw.githubusercontent.com/kubernetes-sigs/kustomize/master/hack/install_kustomize.sh"  | bash
  1. Install the customization manifests in OpenShift (OCP) by running this:
$ ./kustomize build . | kubectl apply -f -
namespace/awx created
customresourcedefinition.apiextensions.k8s.io/awxbackups.awx.ansible.com created
customresourcedefinition.apiextensions.k8s.io/awxrestores.awx.ansible.com created
customresourcedefinition.apiextensions.k8s.io/awxs.awx.ansible.com created
serviceaccount/awx-operator-controller-manager created
role.rbac.authorization.k8s.io/awx-operator-awx-manager-role created
role.rbac.authorization.k8s.io/awx-operator-leader-election-role created
clusterrole.rbac.authorization.k8s.io/awx-operator-metrics-reader created
clusterrole.rbac.authorization.k8s.io/awx-operator-proxy-role created
rolebinding.rbac.authorization.k8s.io/awx-operator-awx-manager-rolebinding created
rolebinding.rbac.authorization.k8s.io/awx-operator-leader-election-rolebinding created
clusterrolebinding.rbac.authorization.k8s.io/awx-operator-proxy-rolebinding created
configmap/awx-operator-awx-manager-config created
service/awx-operator-controller-manager-metrics-service created
deployment.apps/awx-operator-controller-manager created
  1. Wait a bit, and you should have the awx-operator running:
$ oc get pods -n awx
NAME                                               READY   STATUS    RESTARTS   AGE
awx-operator-controller-manager-7d5f849d55-8sv9n   2/2     Running   0          76s

OpenShift (OCP) Web UI:

Log in to the OpenShift (OCP) cluster

OpenShift (OCP) login

You can find the awx-operator running under the awx project:

AWX Operator PODs detail

AWX Operator PODs status

AWX Operator Services status

In the Networking > Service, you can find the Location URL to access your Ansible AWX instance. In my case http://10.217.4.59:8443. Recap

Now you know how to Install Ansible AWX Operator for Kubernetes (K8s) and OpenShift (OCP).

Subscribe to the YouTube channel, Medium, Website, Twitter, and Substack to not miss the next episode of the Ansible Pilot.

Academy

Learn the Ansible automation technology with some real-life examples in my

My book Ansible By Examples: 200+ Automation Examples For Linux and aws System Administrator and DevOps

BUY the Complete PDF BOOK to easily Copy and Paste the 200+ Ansible code

Want to keep this project going? Please donate

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

Subscribe not to miss any new releases

FREE Top 10 Best Practices

Top 10 Best Practices of Ansible Automation: save time, reduce errors and stress