Vagrant AWX

With this repository you can create a local Ansible AWX server implementation with vagrant (CentOS 7 VM).

Table of contents

• Vagrant AWX
• Table of contents
  • Usage
    • Dependencies
    • First usage
    • Credentials
    • Manual start / stop
  • Used technologies & Software
    • Bash script
    • Ansible
    • Docker
    • Visual Studio Code
    • Vagrant
  • Describe files
    • Vagrantfile
    • README.md
    • LICENSE
    • .gitignore
    • install_scripts\docker.sh
    • install_scripts\os_dep.sh
  • License
  • Author Information

Usage

Dependencies

From technology point of view:

• Installed Vagrant

• Windows OS

First usage

Change your current working directory here, and execute: vagrant up. It takes ~ 11mins (basebox exist in cache, with SSD - Dell latitude e6540) to spin up the VM with vagrant.

After vagrant up, you should able to login AWX http://192.168.56.150 with default credentials.

Please be patient (it takes ~2mins after installation finished to be able to open). AWX migration / upgrade should takes additional ~ 5mins.

Credentials

Default credentials for installed AWX server.

Username: admin

Password: password

Manual start / stop

Basic information to be able to start it manually, after vagrant box was created succesfully (Starts automatically, it is just for debugging purpose):

docker-compose file's location: /root/.awx/awxcompose/docker-compose.yml

Start it manually:

[root@localhost awxcompose]# cd /root/.awx/awxcompose/
[root@localhost awxcompose]# docker-compose up -d

Used technologies & Software

Bash script

Bash script is responsible to install OS dependencies to the VM && install docker.

Ansible

Provisioning tool to set up AWX server.

Docker

Ansible AWX runs in docker containers. It is required to be able to install AWX.

Visual Studio Code

This IDE was used to prepare and handle all of the code.

Vagrant

Vagrant is a hashicorp tool which provides you a way to spin up a virtual machine in your local computer (via virtualbox). It is ideal to reproduce the server in your local computer, without any cloud provider.

Describe files

Vagrantfile

Settings of VM created by vagrant.

README.md

This file, what you are reading now. It is in Markdown language.

LICENSE

License file.

.gitignore

File to define excluded files, folders, patterns by git.

install_scripts\docker.sh

Bash script to install docker to the VM. Docker is a dependency for AWX.

install_scripts\os_dep.sh

Bash script to install OS dependencies to the VM.

License

MIT

Author Information

Peter Mikaczo - [email protected]