Permalink
Cannot retrieve contributors at this time
Name already in use
A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
ansible-role-awx/README.md
Go to fileThis commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.
86 lines (58 sloc)
2.26 KB
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
# ansible-role-awx | |
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) | |
[![Build Status](https://travis-ci.org/joshuacherry/ansible-role-awx.svg?branch=master)](https://travis-ci.org/joshuacherry/ansible-role-awx) | |
![Ansible](https://img.shields.io/badge/ansible-2.4-green.svg) | |
Configures [AWX](https://github.com/ansible/awx) on a server. | |
## Requirements | |
- Ansible >= 2.4 | |
## Install | |
### Install from GitHub | |
`ansible-galaxy install git+https://github.com/joshuacherry/ansible-role-awx.git` | |
## Features | |
- Web-based user interface | |
- REST API | |
- Ansible Task Engine | |
| OS | | | |
| :------------ | :-----------: | | |
| Ubuntu 16.04 | ✓ | | |
| Centos 7 | ✓ | | |
## Versioning | |
[Semantic Versioning](http://semver.org/) | |
For the versions available, see the [tags on this repository](https://github.com/joshuacherry/ansible-role-awx/tags). | |
Additionaly you can see what change in each version in the [CHANGELOG.md](CHANGELOG.md) file. | |
## Role variables | |
Look to the [defaults](defaults/main.yml) properties file to see the possible configuration properties. | |
## Testing | |
This role includes a Vagrantfile used with a Docker-based test harness for integration testing. Using Vagrant allows all contributors to test on the same platform and avoid false test failures due to untested or incompatible docker versions. | |
1. Install [Vagrant](https://www.vagrantup.com/) and [VirtualBox](https://www.virtualbox.org/). | |
1. Run `vagrant up` from the same directory as the Vagrantfile in this repository. | |
1. SSH into the VM with: `vagrant ssh` | |
1. Run tests with `molecule`. | |
### Testing with Docker and molecule | |
```bash | |
cd /ansible-role-awx | |
molecule test | |
``` | |
See `molecule` for more information including a full list of available commands. | |
### interactive debugging | |
You can use log into a docker image created by molecule for interactive testing with the below commands. | |
```bash | |
cd /ansible-role-awx | |
molecule converge | |
# Ubuntu | |
docker exec -it ubuntu /bin/bash | |
# CentOS | |
docker exec -it centos /bin/bash | |
``` | |
## Example Playbook | |
```yaml | |
--- | |
- name: Playbook for ansible-role-awx | |
hosts: all | |
tasks: | |
- include_role: | |
name: ansible-role-awx | |
vars: | |
awx_inv_awx_official: true | |
cleanup_docker_base: false | |
``` |