Ansible : AWX インストール2025/02/20

Red Hat Ansible Tower のコミュニティエディション Ansible AWX のインストールです。

Ansible AWX の実装には、Kubernetes 環境が必要となります。
Kubernetes 環境であれば MicroK8s や K3s, Minikube 等々でも構築可能です。
もちろん RedHat OpenShift またはそのコミュニティエディション OKD でも OK です。

[1]

当例では、開発/テスト用途で便利な Minikube を使用します。
よって、こちらを参考に Minikube をインストールしておきます。

[2]

必要なパッケージをインストールしておきます。

[root@dlp ~]#

dnf -y install git make

[3]	任意の一般ユーザーで Minikube を起動します。

[cent@dlp ~]$

minikube start --vm-driver=kvm2 --cpus=4 --memory=8g --addons=ingress

* minikube v1.35.0 on Centos 10 (kvm/amd64)
* Using the kvm2 driver based on user configuration
* Downloading VM boot image ...
    > minikube-v1.35.0-amd64.iso....:  65 B / 65 B [---------] 100.00% ? p/s 0s
    > minikube-v1.35.0-amd64.iso:  345.38 MiB / 345.38 MiB  100.00% 37.32 MiB p
* Starting "minikube" primary control-plane node in "minikube" cluster

.....
.....

* Verifying ingress addon...
* Enabled addons: storage-provisioner, default-storageclass, ingress
* Done! kubectl is now configured to use "minikube" cluster and "default" namespace by default

[cent@dlp ~]$

minikube status

minikube
type: Control Plane
host: Running
kubelet: Running
apiserver: Running
kubeconfig: Configured

[cent@dlp ~]$

kubectl get pods -A

NAMESPACE       NAME                                        READY   STATUS      RESTARTS      AGE
ingress-nginx   ingress-nginx-admission-create-dbqb8        0/1     Completed   0             50s
ingress-nginx   ingress-nginx-admission-patch-k5r59         0/1     Completed   0             50s
ingress-nginx   ingress-nginx-controller-56d7c84fd4-vpjvt   1/1     Running     0             50s
kube-system     coredns-668d6bf9bc-clqm6                    1/1     Running     0             50s
kube-system     etcd-minikube                               1/1     Running     0             57s
kube-system     kube-apiserver-minikube                     1/1     Running     0             55s
kube-system     kube-controller-manager-minikube            1/1     Running     0             56s
kube-system     kube-proxy-ktwrb                            1/1     Running     0             50s
kube-system     kube-scheduler-minikube                     1/1     Running     0             57s
kube-system     storage-provisioner                         1/1     Running     1 (20s ago)   53s

[4]	Ansible AWX をデプロイします。

# AWX に必要な AWX Operator を取得

[cent@dlp ~]$

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

Cloning into 'awx-operator'...
remote: Enumerating objects: 10992, done.
remote: Counting objects: 100% (2643/2643), done.
remote: Compressing objects: 100% (590/590), done.
remote: Total 10992 (delta 2349), reused 2057 (delta 2052), pack-reused 8349 (from 3)
Receiving objects: 100% (10992/10992), 3.19 MiB | 16.15 MiB/s, done.
Resolving deltas: 100% (6402/6402), done.

[cent@dlp ~]$

cd awx-operator

# AWX Operator のバージョンを指定
# バージョンの確認 : https://github.com/ansible/awx-operator/releases

[cent@dlp awx-operator]$

git checkout 2.19.1

Note: switching to '2.19.1'.

You are in 'detached HEAD' state. You can look around, make experimental
changes and commit them, and you can discard any commits you make in this
state without impacting any branches by switching back to a branch.

If you want to create a new branch to retain commits you create, you may
do so (now or later) by using -c with the switch command. Example:

  git switch -c <new-branch-name>

Or undo this operation with:

  git switch -

Turn off this advice by setting config variable advice.detachedHead to false

HEAD is now at dd37ebd Update index.md (#1904)

# AWX 用に任意のネームスペース名をセットして Operator をデプロイ

[cent@dlp awx-operator]$

export NAMESPACE=ansible-awx

[cent@dlp awx-operator]$

make deploy

namespace/ansible-awx created
customresourcedefinition.apiextensions.k8s.io/awxbackups.awx.ansible.com created
customresourcedefinition.apiextensions.k8s.io/awxmeshingresses.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

[cent@dlp awx-operator]$

kubectl get pods -n $NAMESPACE

NAME                                               READY   STATUS    RESTARTS   AGE
awx-operator-controller-manager-58b7c97f4b-6t97q   2/2     Running   0          119s

[cent@dlp awx-operator]$

cp awx-demo.yml ansible-awx.yml

[cent@dlp awx-operator]$

vi ansible-awx.yml

# 任意のサービス名称に変更

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

# AWX 用のネームスペースを kubectl のコンテキストにセットして AWX をデプロイ

[cent@dlp awx-operator]$

kubectl config set-context --current --namespace=$NAMESPACE

Context "minikube" modified.
[cent@dlp awx-operator]$

kubectl apply -f ansible-awx.yml

awx.awx.ansible.com/ansible-awx created

# 進行状況はログで確認可

[cent@dlp awx-operator]$

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


.....
.....

--------------------------- Ansible Task StdOut -------------------------------

TASK [installer : Start installation if auto_upgrade is false and deployment is missing] ***
task path: /opt/ansible/roles/installer/tasks/main.yml:31

-------------------------------------------------------------------------------
{"level":"info","ts":"2025-02-20T01:17:32Z","logger":"runner","msg":"Ansible-runner exited successfully","job":"4239509331927310085","name":"ansible-awx","namespace":"ansible-awx"}

----- Ansible Task Status Event StdOut (awx.ansible.com/v1beta1, Kind=AWX, ansible-awx/ansible-awx) -----


PLAY RECAP *********************************************************************
localhost                  : ok=88   changed=0    unreachable=0    failed=0    skipped=85   rescued=0    ignored=1

# 最終的に上記のように failed=0 で終了していれば OK

[cent@dlp ~]$

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

NAME                                 READY   STATUS      RESTARTS   AGE
ansible-awx-migration-24.6.1-2pjft   0/1     Completed   0          5m4s
ansible-awx-postgres-15-0            1/1     Running     0          6m22s
ansible-awx-task-5c467c59d8-rpzkw    4/4     Running     0          5m50s
ansible-awx-web-7dcd7c7c56-dcs2t     3/3     Running     0          5m51s

[cent@dlp ~]$

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

NAME                      TYPE        CLUSTER-IP     EXTERNAL-IP   PORT(S)        AGE
ansible-awx-postgres-15   ClusterIP   None           <none>        5432/TCP       6m45s
ansible-awx-service       NodePort    10.111.78.10   <none>        80:32137/TCP   6m16s

# サービス URL 確認

[cent@dlp ~]$

minikube service ansible-awx-service --url -n ansible-awx

http://192.168.39.54:32137

# 管理アカウントのパスワード確認

[cent@dlp ~]$

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

CuGle4q5v0BPYVCNWwsYFPoLIywpu8Sk

# Kubernetes クラスター外部からもアクセスできるようにするには要ポートフォワード
# [10445] ⇒ Minikube インストールホストが待ち受けるポート ⇒ 任意の空きポートを指定すれば OK
# [80] ⇒ AWX コンテナーが待ち受けているポート

[cent@dlp ~]$

kubectl port-forward service/ansible-awx-service --address 0.0.0.0 10445:80

Forwarding from 0.0.0.0:10445 -> 8052

# ポートフォワードした且つ Firewalld 稼働中の場合は root 権限でポート許可

[root@dlp ~]#

firewall-cmd --add-port=10445/tcp

[root@dlp ~]#

firewall-cmd --runtime-to-permanent

[5]	Web ブラウザーを起動して Ansible AWX にアクセスします。 Minikube インストールホストローカルからアクセスする場合は、確認したサービス URL へアクセスします。ポートフォワードした場合は、ローカルネットワーク内の任意のコンピューターから [http://(Minikube インストールホストのホスト名または IP アドレス):(設定したポート)] へアクセスします。アクセスするとログイン画面が表示されます。ユーザー名 [admin], パスワードは確認した管理アカウントのパスワードでログイン可能です。

[6]	正常にログインすると、Ansible AWX のダッシュボードが表示されます。以上でインストール完了です。

[7]	なお、画面例は英語表記となっていますが、日本語 OS でアクセスすれば、自動的に日本語表記となります。