{"id":13584368,"url":"https://github.com/geerlingguy/awx-container","last_synced_at":"2025-04-07T01:32:08.031Z","repository":{"id":139937205,"uuid":"102868487","full_name":"geerlingguy/awx-container","owner":"geerlingguy","description":"Ansible Container project that manages the lifecycle of AWX on Docker.","archived":true,"fork":false,"pushed_at":"2020-04-10T15:47:34.000Z","size":29,"stargazers_count":292,"open_issues_count":1,"forks_count":82,"subscribers_count":25,"default_branch":"master","last_synced_at":"2024-11-06T01:40:03.660Z","etag":null,"topics":["ansible","ansible-container","ansible-tower","awx","cd","ci","docker","image","tower"],"latest_commit_sha":null,"homepage":"https://hub.docker.com/r/geerlingguy/awx_web/","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geerlingguy.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-09-08T14:11:38.000Z","updated_at":"2024-09-15T16:57:34.000Z","dependencies_parsed_at":"2024-01-14T06:54:49.987Z","dependency_job_id":null,"html_url":"https://github.com/geerlingguy/awx-container","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fawx-container","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fawx-container/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fawx-container/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geerlingguy%2Fawx-container/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geerlingguy","download_url":"https://codeload.github.com/geerlingguy/awx-container/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247578042,"owners_count":20961221,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ansible","ansible-container","ansible-tower","awx","cd","ci","docker","image","tower"],"created_at":"2024-08-01T15:04:12.099Z","updated_at":"2025-04-07T01:32:03.017Z","avatar_url":"https://github.com/geerlingguy.png","language":null,"funding_links":[],"categories":["Others","image"],"sub_categories":[],"readme":"# AWX (Built with Ansible Container)\n\n\u003e **DEPRECATED**: This project has been deprecated. Please use the [official AWX containers and docker-compose.yml file](https://github.com/ansible/awx/blob/devel/INSTALL.md#docker-compose) to run AWX instead.\n\n[![Build Status](https://travis-ci.org/geerlingguy/awx-container.svg?branch=master)](https://travis-ci.org/geerlingguy/awx-container) [![](https://images.microbadger.com/badges/image/geerlingguy/awx_web.svg)](https://microbadger.com/images/geerlingguy/awx_web \"Get your own image badge on microbadger.com\") [![](https://images.microbadger.com/badges/image/geerlingguy/awx_task.svg)](https://microbadger.com/images/geerlingguy/awx_task \"Get your own image badge on microbadger.com\")\n\nThis project is in its early stages. _There will be bugs!_\n\nThis project is composed of three main parts:\n\n  - **Ansible Container project**: This project is maintained on GitHub: [geerlingguy/awx-container](https://github.com/geerlingguy/awx-container). Please file issues, support requests, etc. against this GitHub repository.\n  - **Docker Hub Image**: If you just want to use [`geerlingguy/awx_web`](https://hub.docker.com/r/geerlingguy/awx_web/) and [`geerlingguy/awx_task`](https://hub.docker.com/r/geerlingguy/awx_task/) in your project, you can pull it from Docker Hub.\n  - **Ansible Role**: If you need an Ansible role to build AWX, check out [`geerlingguy.awx`](https://galaxy.ansible.com/geerlingguy/awx/) on Ansible Galaxy. (This is the Ansible role that does the bulk of the work in managing the AWX container.)\n\n## Versions\n\nCurrently maintained versions include:\n\n  - `geerlingguy/awx_web`:\n    - `1.x`, `latest`: AWX 1.x\n    - `1.0.5`\n  - `geerlingguy/awx_task`:\n    - `1.x`, `latest`: AWX 1.x\n    - `1.0.5`\n\n## Quickstart - Standalone Usage with Docker Compose\n\nIf 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 `http://localhost:80/`:\n\n    mkdir awx-test \u0026\u0026 cd awx-test\n    curl -O https://raw.githubusercontent.com/geerlingguy/awx-container/master/docker-compose.yml\n    docker-compose up -d\n\nThe Docker Compose file uses community images for `postgres`, `rabbitmq`, and `memcached`, and the following images for AWX:\n\n  - [`ansible/awx_web`](https://hub.docker.com/r/ansible/awx_web/)\n  - [`ansible/awx_task`](https://hub.docker.com/r/ansible/awx_task/)\n\nAfter the initial database migration completes (this can take a few minutes; follow the progress with `docker logs -f [id-of-awx_task-container]`), you will be able to access the AWX interface at `http://localhost/`. The default login is `admin`/`password`.\n\n\u003e Note: Switch the image for the `awx_web` and `awx_task` containers in `docker-compose.yml` if you want to use the `geerlingguy/` maintained images rather than the ones from `ansible/`. If you're just kicking AWX's tires though, stick with the defaults.\n\n## Management with Ansible Container\n\n### Prerequisites\n\nBefore using this project to build and maintain AWX images for Docker, you need to have the following installed:\n\n  - [Docker Community Edition](https://docs.docker.com/engine/installation/) (for Mac, Windows, or Linux)\n  - [Ansible Container](https://docs.ansible.com/ansible-container/installation.html)\n\n### Build the AWX images\n\nTypically, 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:\n\n    $ cd prebuild/\n    $ ansible-galaxy install -r requirements.yml --force\n    $ ansible-playbook -i 'localhost,' -c local prebuild.yml\n\nAfter this playbook runs, you should see two new Docker images (which we'll use in the Ansible Container definition):\n\n    $ docker images\n    REPOSITORY          TAG                 IMAGE ID            CREATED             SIZE\n    awx_task            devel               26311794058d        29 seconds ago      938MB\n    awx_web             devel               3d38dccc9190        58 seconds ago      913MB\n\n\u003e 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:\n\u003e \n\u003e   1. Run `vagrant up`.\n\u003e   2. Wait for Vagrant's provisioning to complete (it will run `prebuild.yml` automatically).\n\u003e   3. Log in with `vagrant ssh` and use `docker` or `ansible` as needed.\n\n### Build the conductor\n\nBuild the conductor using `ansible-container build`:\n\n    ansible-container --var-file config.yml build\n\n\u003e 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).\n\n### Run the containers\n\n    ansible-container --var-file config.yml run\n\nYou should be able to reach AWX by accessing [http://localhost/](http://localhost/) in your browser.\n\n(Use `stop` to stop the container, and `destroy` to reset the containers and _all_ images.)\n\n### Push the containers to Docker Hub\n\nCurrently, 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](https://github.com/ansible/ansible-container/issues/630) to be resolved).\n\n  1. Log into Docker Hub on the command line:\n\n         docker login --username=geerlingguy\n\n  1. Tag the latest version (only if this is the latest/default version):\n\n         docker tag awx_web:devel geerlingguy/awx_web:latest\n         docker tag awx_web:devel geerlingguy/awx_web:1.x\n         docker tag awx_task:devel geerlingguy/awx_task:latest\n         docker tag awx_task:devel geerlingguy/awx_task:1.x\n\n  1. Push tags to Docker Hub:\n\n         docker push geerlingguy/awx_web:latest # (if this was just tagged)\n         docker push geerlingguy/awx_web:1.x\n         [etc...]\n\n## License\n\nMIT / BSD\n\n## Author Information\n\nThis container build was created in 2017 by [Jeff Geerling](https://www.jeffgeerling.com/), author of [Ansible for DevOps](https://www.ansiblefordevops.com/).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fawx-container","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeerlingguy%2Fawx-container","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeerlingguy%2Fawx-container/lists"}