I created the following Vagrantfile to launch a CentOS 7 server;
# -*- mode: ruby -*- # vi: set ft=ruby : VAGRANTFILE_API_VERSION = "2" Vagrant.configure(VAGRANTFILE_API_VERSION) do |config| config.vm.box = "centos/7" config.vm.provider :virtualbox do |v| v.memory = 4048 v.cpus = 2 v.customize ["modifyvm", :id, "--natdnshostresolver1", "on"] v.customize ["modifyvm", :id, "--ioapic", "on"] end config.vm.define "awx" do |awx| awx.vm.hostname = "awx.local" awx.vm.network :forwarded_port, guest: "80", host: "8080" awx.vm.provision :ansible do |ansible| ansible.playbook = "playbook.yml" ansible.become = true end end end
This launches the following playbook.yml which prepares the CentOS 7 box by installing Docker and the other prerequisites need to build and launch AWX;
- name: Deploy AWX hosts: all become: true become_user: root tasks: - name: sort out the yum repos yum: name: "" state: "latest" with_items: - "epel-release" - "yum-utils" - name: add the docker ce yum repo yum_repository: name: "docker-ce" description: "Docker CE YUM repo" gpgcheck: "yes" enabled: "yes" baseurl: "https://download.docker.com/linux/centos/7/$basearch/stable" gpgkey: "https://download.docker.com/linux/centos/gpg" - name: install the prerequisites using yum yum: name: "" state: "latest" with_items: - "epel-release" - "libselinux-python" - "python-wheel" - "python-pip" - "git" - "docker-ce" - name: start and enable docker systemd: name: "docker" enabled: "yes" state: "started" - name: install the python packages using pip pip: name: "" state: "latest" with_items: - "pip" - "ansible" - "boto" - "boto3" - "docker" - name: check out the awx repo git: repo: "https://github.com/ansible/awx.git" dest: "~/awx" clone: "yes" update: "yes" - name: install awx command: "ansible-playbook -i inventory install.yml" args: chdir: "~/awx/installer"
(You can find the files above in a gist on GitHub) Running
vagrant up will launch the CentOS 7 machine and execute the playbook to install AWX, this process takes about 15 minutes.
The complete playbook run In the background the installer has built and downloaded several Docker images, you can check what is going on the machine by running;
vagrant ssh sudo docker image ls sudo docker container ls
Once the build has completed you should the following images; Also, you should have several containers running; Once the containers have launched, going to http://localhost:8080/ should show you the following;
This will take about 5 minutes to upgrade After a while the page will eventually refresh into a login screen, the default user is admin and the password is password. Once logged in you will be taken to the dashboard, here you can see that there is already a project created, this is a simple test job; You can test your installation by running the test job, which is the Ansible equivalent of a Hello World, you can see the output of running the template below; As I said at the start of this post this was a only a quick post to document how you can get quickly (well sort of quickly) get an AWX host up and running, if you would like more detail on how to use AWX see the Ansible Tower Document site.