AWX MiniKube Install

Installing AWX using MiniKube was pretty simple.

Install minikube:

curl -LO https://storage.googleapis.com/minikube/releases/latest/minikube-latest.x86_64.rpm
sudo rpm -Uvh minikube-latest.x86_64.rpm

Install podman:

dnf -y install podman

Start a cluster:

minikube start --cpus=4 --memory=6g --addons=ingress

Checl node status:

minikube kubectl -- get nodes

minikube kubectl -- get pods -A

Create an alias for easier useage:

alias kubectl="minikube kubectl --"

Clone the awx operator repository:

git clone git@github.com:ansible/awx-operator.git

Get the current tag:

cd awx-operator 
git tag

Check out the latest tag:

git checkout tags/2.9.0

Create a kubctl wrapper script in your PATH

sudo tee /usr/local/bin/kubectl > /dev/null << 'EOF' #!/bin/sh exec minikube kubectl -- "$@" EOF sudo chmod +x /usr/local/bin/kubectl

Run the make target:

make deploy KUBECTL="minikube kubectl --"

Create kustomization.yaml, fill in tag from earlier:

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=2.9.0

# Set the image tags to match the git version from above
images:
  - name: quay.io/ansible/awx-operator
    newTag: 2.9.0

# Specify a custom namespace in which to install AWX
namespace: awx

Install the manifest:

kubectl apply -k .

Verify the pod is running:

kubectl get pods -n awx

Set the namespace to awx so we don’t have to keep using -n awx:

kubectl config set-context --current --namespace=awx

Create the file awx-demo.yml with the following content:

---
apiVersion: awx.ansible.com/v1beta1
kind: AWX
metadata:
  name: awx-demo
spec:
  service_type: nodeport

Change awx-demo to the name you want for your project.

Add this file to the resources section of your kustomization.yaml:

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=2.9.0
  - awx-demo.yml

# Set the image tags to match the git version from above
images:
  - name: quay.io/ansible/awx-operator
    newTag: 2.9.0

# Specify a custom namespace in which to install AWX
namespace: awx

Apply changes to create the AWX instance in your cluster:

kubectl apply -k .

After a few minutes, verify the new resources are created, grab the node port for later:

kubectl get pods -l "app.kubernetes.io/managed-by=awx-operator"

kubectl get svc -l "app.kubernetes.io/managed-by=awx-operator"

Check logs for current status:

kubectl logs -f deployments/awx-operator-controller-manager -c awx-manager

Check the pods status:

kubectl get pods -n awx

NAME                                               READY   STATUS             RESTARTS   AGE
awx-demo-postgres-13-0                             1/1     Running            0          7m7s
awx-demo-task-79d8f64ffd-pv5xb                     4/4     Running            0          6m42s
awx-demo-web-c6d789748-nt4n7                       3/3     Running            0          5m20s
awx-operator-controller-manager-76fbc57b56-8fwvm   1/2     ImagePullBackOff   0          17m

Get the URL:

minikube service awx-demo-service -n awx

┌───────────┬──────────────────┬─────────────┬───────────────────────────┐
│ NAMESPACE │       NAME       │ TARGET PORT │            URL            │
├───────────┼──────────────────┼─────────────┼───────────────────────────┤
│ awx       │ awx-demo-service │ http/80     │ http://192.168.49.2:32597 │
└───────────┴──────────────────┴─────────────┴───────────────────────────┘
🎉  Opening service awx/awx-demo-service in default browser...

Get the admin password using (<resourcename>-admin-password):

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