Deploy Ansible AWX di CentOS

AWX adalah perangkat lunak berbasis web yang digunakan sebagai user interface dan penyedia REST API untuk engine Ansible. AWX merupakan versi upstream dari Ansible Tower, sama seperti biasanya Red Hat selalu mewujudkan representatif layanan berbayarnya dengan project - project open source sebagai development version. Jika Ansible Tower membutuhkan biaya untuk subscription, maka AWX sama sekali tidak dipungut biaya.

Ansible

Contoh Kasus

Sebagai contoh misalkan kita memiliki tugas untuk mengganti nameserver menjadi 8.8.8.8 pada puluhan hingga ratusan server. Pada proses tradisional, kita akan melakukan login (misalnya melalui SSH) kemudian memanipulasi file /etc/resolv.conf pada masing - masing server, tentu saja mengulang-ulang tugas yang sama adalah hal membosankan. Mungkin kita bisa berusaha membuat sebuah shell script (misalnya bash) yang dijalankan sebagai program untuk melakukan itu semua, tapi tidak semua orang mau melakukan effort tersebut. Maka kita dapat menggunakan Ansible sebagai solusi, cukup install Ansible pada Control Node yang dapat terkoneksi dengan list server. Kemudian memasukkan seluruh list hostname atau alamat IP server ke dalam file inventory, dan menjalankan Ansible Ad-Hoc berisi instruksi perintah untuk mengganti isi file /etc/resolv.conf lalu masalah terselesaikan. Sedangkan untuk tugas yang lebih rumit kita dapat menulisnya ke dalam script YAML untuk kemudian dieksekusi dengan Ansible Playbook.

Prerequisites

Sebelum melanjutkan lebih jauh, pastikan sudah memenuhi beberapa prasyarat berikut.

System Requirements

Untuk mendapatkan performa yang baik saat pertama kali melakukan deployment, setidaknya dibutuhkan spesifikasi seperti berikut.

• 4 GB Memory
• 2 Core CPU
• 20 GB Storage

Saya akan menggunakan VM Guest CentOS 8 sebagai Control Node. Namun jika ingin menggunakan CentOS 7 setidaknya gunakan CentOS 7.7 atau versi lebih baru.

Disable SELinux

Untuk sementara saya merubah SELinux menjadi permissive agar proses deployment berjalan lancar.

1
2

sed -i 's/^SELINUX=.*/SELINUX=permissive/g' /etc/selinux/config
setenforce permissive

EPEL dan Extra Packages

Jalankan perintah berikut ini.

1

dnf install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm

Instalasi Ansible

Kita membutuhkan Ansible Engine versi 2.8 atau lebih baru. Jalankan perintah berikut ini.

1

dnf install ansible

Paket Tambahan

Jalankan perintah berikut ini untuk memasang beberapa paket tambahan.

1
2
3

dnf install git python3-pip curl \
    wget nodejs gettext lvm2 \
    device-mapper-persistent-data bzip2

Development Tools

AWX membutuhkan beberapa paket lain dari group Development Tools untuk GNU Make.

1

dnf group install "Development Tools"

Docker dan Docker Compose

Karena AWX akan dijalankan di container, by-default AWX menyarankan untuk memakai Docker CE.

1
2
3
4
5

dnf config-manager \
    --add-repo \
    https://download.docker.com/linux/centos/docker-ce.repo
dnf install docker-ce docker-ce-cli containerd.io
systemctl enable --now docker

Lalu pasang docker-compose menggunakan pip3.

1

pip3 install docker-compose

Deploy AWX

Clone Repository

Periksa terlebih dahulu release yang tersedia dari remote repository AWX pada halaman releases. Kemudian jalankan clone dengan perintah berikut.

1

git clone -b x.y.z https://github.com/ansible/awx.git

Generate Secret Key

Biasanya AWX membutuhkan Secret Key, kita dapat membuatnya menggunakan openssl yang sudah tersedia di CentOS 8.

1

openssl rand -hex 32

Catat output yang dihasilkan dari perintah diatas.

Edit Inventory

Buka file inventory yang terdapat dalam direktori instaler AWX misalnya menggunakan vi.

1
2

cd awx/installer
vi inventory

Cari dan edit beberapa baris yang ada seperti berikut.

1
2
3
4
5

secret_key=<SECRET_KEY>
admin_password=<PASSWORD_AWX>
project_data_dir=/var/lib/awx/projects
awx_official=true
awx_alternate_dns_servers="8.8.8.8,8.8.4.4"

Membuat Direktori Project

Karena kita mengaktifkan variabel project_data_dir maka kita perlu membuat direktorinya juga.

1

mkdir -p /var/lib/awx/projects

Direktori tersebut nantinya akan berisi project yang akan kita gunakan dalam AWX.

Konfigurasi Firewall

Supaya AWX dapat diakses dari luar VM maka kita perlu melakukan beberapa konfigurasi firewall.

1
2
3

firewall-cmd --zone=public --add-masquerade --permanent
firewall-cmd --add-service=http --add-service=https --permanent
firewall-cmd --reload

Deployment

Eksekusi file YAML bernama install.yml menggunakan ansible-playbook.

1

ansible-playbook -i inventory install.yml

Proses akan memakan waktu cukup lama hingga akhirnya selesai. Apabila tidak ada kendala maka akan muncul tampilan seperti berikut.

1
2

PLAY RECAP ****************************************************************************************
localhost   : ok=21   changed=8    unreachable=0    failed=0    skipped=73   rescued=0    ignored=1   

Post-Deployment

Jangan lupa untuk mengembalikan kondisi SELinux menjadi enforcing dari yang tadinya telah kita manipulasi menjadi permissive.

1
2

sed -i 's/^SELINUX=.*/SELINUX=enforcing/g' /etc/selinux/config
setenforce enforcing

Pengujian

Periksa apakah ada container yang berjalan.

1

docker ps

Jika berhasil maka akan ada 4 container yang dalam status Up.

1
2
3
4

003389b920b6   ansible/awx:17.0.1   "/usr/bin/tini -- /u..."   7 minutes ago   Up 7 minutes   8052/tcp               awx_task
42d2ff79f8e1   ansible/awx:17.0.1   "/usr/bin/tini -- /b..."   7 minutes ago   Up 7 minutes   0.0.0.0:80->8052/tcp   awx_web
3e73bd538074   postgres:12          "docker-entrypoint.s..."   7 minutes ago   Up 7 minutes   5432/tcp               awx_postgres
94ee8bb7949b   redis                "docker-entrypoint.s..."   7 minutes ago   Up 7 minutes   6379/tcp               awx_redis

Sekarang coba buka user interface AWX di Web Browser menggunakan alamat IP milik VM. Jika berhasil kita dapat melakukan login memakai username dan password yang sebelumnya telah kita isi pada file inventory.

Kesimpulan

Berdasarkan FAQ (Frequently Asked Questions) dikatakan bahwa AWX sangat tidak dianjurkan untuk dipakai di production, namun jika untuk sekedar mempelajari fitur-fitur yang ada saya rasa AWX sudah cukup. Jika sudah terbiasa mengoperasikan AWX, kita bisa saja beralih untuk berlangganan Ansible Tower di production environment. Selama saya mencoba melakukan deployment AWX, saya melihat banyak sekali issue masih dalam status Open di repositori Github milik AWX.

Referensi

• docs.ansible.com/ansible/latest/user_guide/intro_getting_started.html
• github.com/ansible/awx/
• www.ansible.com/overview/how-ansible-works
• www.ansible.com/community/awx-project
• www.ansible.com/products/awx-project/faq
• www.redhat.com/en/resources/awx-and-ansible-tower-datasheet