Install Ansible AWX using AWX Operator (on Kubernetes)

Follow · 3 mins read
Share this

Install Ansible AWX using AWX Operator (on Kubernetes)

Setup a Kubernete s Cluster

We will install it on a minikube. (Refere minikube installation)

$ minikube start --addons=ingress --cni=flannel --install-addons=true \
    --kubernetes-version=stable \
    --vm-driver=docker --wait=false \
    --cpus=4 --memory=6g

Enable Addons as needed

## Check addons
$ minikube addons list
$ minikube addons enable metrics-server
$ minikube dashboard

Deploy AWX Operator

Replace TAG with the version from Release Page

kubectl apply -f<TAG>/deploy/awx-operator.yaml

Create AWX Deployment

Create a file awx-demo.yaml

kind: AWX
  name: awx-demo
  service_type: nodeport
  ingress_type: none
$ kubectl apply -f awx-demo.yml created

Refer AWX Operator documentation for advanced installation options.

Get Admin Password

By default, the admin user is admin and the password is available in the <resourcename>-admin-password secret.

$ kubectl get secret awx-demo-admin-password -o jsonpath="{.data.password}" | base64 --decode

Get the Path to Access Ansible AWX

You will find the NodePort and IP for service awx-demo-service

$ kubectl get svc
NAME                   TYPE        CLUSTER-IP       EXTERNAL-IP   PORT(S)             AGE
awx-demo-postgres      ClusterIP   None             <none>        5432/TCP            23m
awx-demo-service       NodePort   <none>        80:31726/TCP        23m
awx-operator-metrics   ClusterIP    <none>        8383/TCP,8686/TCP   23m
kubernetes             ClusterIP        <none>        443/TCP             26m

Access Ansible AWX Portal at IP_ADDRESS:NODE_PORT.

Or let minikube open the browser

$ minikube service hello-minikube

Access Ansible AWX on Remote Minikube or Kubernetes Cluster

If your Kubernetes/minikube Cluster is on Remote Machine/VM (eg: Cloud Instance with Public IP) then you can access it using above method (if NodePort is same is remote IP) or you can use LoadBalancer methods.

In our case, we have deplyed this in a Google Cloud instance without GUI and we need to enabled port-forwading as below.

## Forward localhost (minkube VM Localhost) port 7080 -> 80
$ kubectl port-forward service/awx-demo-service 7080:80

So the Ansible AWX service is available at minikube VM localhost:7080 now; but we dont have GUI there to access !!

So, we do a port-forwarding from our laptop/workstation via SSH Tunnel.

## On your Workstation/Laptop
## ssh -L LOCAL_PORT:localhost:REMOTE_PORT [email protected]_IP
$ ssh -L 7080:localhost:7080 [email protected]

Now, open a browser on your laptop/workstation and goto localhost:7080; that’s it.

Enjoy Ansible AWX running on top of Kubernetes/minikube.


Latest Stories