README.md

AWX

Installation and configuration AWX(Ansible Tower) running docker

Table of contents

• Getting started
  • Clone the repo
  • AWX branding
  • Prerequisites
  • System Requirements
  • AWX Tunables
  • Choose a deployment platform
  • Official vs Building Images
• OpenShift
  • Prerequisites
    • Deploying to Minishift
  • Pre-build steps
  • PostgreSQL
  • Start the build
  • Post build
  • Accessing AWX
• Kubernetes
  • Prerequisites
  • Pre-build steps
  • Configuring Helm
  • Start the build
  • Accessing AWX
  • SSL Termination
• Docker Compose
  • Prerequisites
  • Pre-build steps
    • Deploying to a remote host
    • Inventory variables
      • Docker registry
      • PostgreSQL
      • Proxy settings
  • Start the build
  • Post build
  • Accessing AWX

Prerequisites

Before you can run a deployment, you'll need the following installed in your local environment:

• Ansible Requires Version 2.4+
• Docker
• docker-py Python module
• GNU Make
• Git Requires Version 1.8.4+
• Node 8.x LTS version
• NPM 6.x LTS

Installing prerequisites

Checking prerequisites

System Requirements

The system that runs the AWX service will need to satisfy the following requirements

• At leasts 4GB of memory
• At least 2 cpu cores
• At least 20GB of space
• Running Docker, Openshift, or Kubernetes
• If you choose to use an external PostgreSQL database, please note that the minimum version is 9.6+.

Checking system requirements

Local installation

Clone the repo

git clone https://github.com/ansible/awx