This project is in it's early stages. There will be bugs!
This project is composed of three main parts:
- Ansible Container project: This project is maintained on GitHub: geerlingguy/awx-container. Please file issues, support requests, etc. against this GitHub repository.
- Docker Hub Image: If you just want to use
geerlingguy/awx_web
andgeerlingguy/awx_task
in your project, you can pull it from Docker Hub. - Ansible Role: If you need an Ansible role to build AWX, check out
geerlingguy.awx
on Ansible Galaxy. (This is the Ansible role that does the bulk of the work in managing the AWX container.)
Currently maintained versions include:
geerlingguy/awx_web
:1.x
,latest
: AWX 1.x1.0.3
geerlingguy/awx_task
:1.x
,latest
: AWX 1.x1.0.3
If you just want to get an AWX environment running quickly, you can use the docker-compose.yml
file included with this project to build a local environment accessible on https://localhost:80/
:
mkdir awx-test && cd awx-test
curl -O https://raw.githubusercontent.com/geerlingguy/awx-container/master/docker-compose.yml
docker-compose up -d
The Docker Compose file uses community images for postgres
, rabbitmq
, and memcached
, and the following images for AWX:
After the initial database migration completes (this can take a few minutes; follow the progress with docker logs -f [id-of-awx_task-container]
), you can able to access the AWX interface at https://localhost/
. The default login is admin
/password
.
Note: Switch the image for the
awx_web
andawx_task
containers indocker-compose.yml
if you want to use thegeerlingguy/
maintained images rather than the ones fromansible/
. If you're just kicking AWX's tires though, stick with the defaults.
Before using this project to build and maintain AWX images for Docker, you need to have the following installed:
- Docker Community Edition (for Mac, Windows, or Linux)
- Ansible Container
Typically, you would build the images as specified in the container.yml
file using ansible-container --var-file config.yml build
, but in this case, since there are many dependencies bundled in the AWX repository, we will build the Docker images using a helper playbook:
$ cd prebuild/
$ ansible-galaxy install -r requirements.yml
$ ansible-playbook -i 'localhost,' -c local prebuild.yml
After this playbook runs, you should see two new Docker images (which we'll use in the Ansible Container definition):
$ docker images
REPOSITORY TAG IMAGE ID CREATED SIZE
awx_task devel 26311794058d 29 seconds ago 938MB
awx_web devel 3d38dccc9190 58 seconds ago 913MB
A Vagrantfile is included with this project to assist in building a clean environment with all the dependencies required to build the AWX images (in case you don't want to install everything on your local workstation!). To use it:
- Run
vagrant up
.- Wait for Vagrant's provisioning to complete (it will run
prebuild.yml
automatically).- Log in with
vagrant ssh
and usedocker
oransible
as needed.
Build the conductor using ansible-container build
:
ansible-container --var-file config.yml build
Note: If you get any permission errors trying to generate a Docker container, make sure you're either running the commands as root or with sudo, or your user is in the
docker
group (e.g.sudo usermod -G docker -a [user]
, then log out and log back in).
Note 2: Currently, some of the features used in this Ansible Container definition require installing
ansible-container
from source, instead of installing the current tagged release, 0.9.1.
ansible-container --var-file config.yml run
You should be able to reach AWX by accessing https://localhost/ in your browser.
(Use stop
to stop the container, and destroy
to reset the containers and all images.)
Currently, the process for updating this image on Docker Hub is manual. Eventually this will be automated via Travis CI using ansible-container push
(currently, this is waiting on this issue to be resolved).
-
Log into Docker Hub on the command line:
docker login --username=geerlingguy
-
Tag the latest version (only if this is the latest/default version):
docker tag awx_web:devel geerlingguy/awx_web:latest docker tag awx_web:devel geerlingguy/awx_web:1.x docker tag awx_task:devel geerlingguy/awx_task:latest docker tag awx_task:devel geerlingguy/awx_task:1.x
-
Push tags to Docker Hub:
docker push geerlingguy/awx_web:latest # (if this was just tagged) docker push geerlingguy/awx_web:1.x [etc...]
MIT / BSD
This container build was created in 2017 by Jeff Geerling, author of Ansible for DevOps.