Merge pull request #10024 from rooftopcellist/build_awx_docs

Add docs for building and using custom awx image

SUMMARY
Docs for how to build and push a custom AWX image to be used by the awx-operator.
ISSUE TYPE


Docs Pull Request

AWX VERSION

19.0.0

Reviewed-by: Shane McDonald <me@shanemcd.com>
Reviewed-by: Christian Adams <rooftopcellist@gmail.com>

INSTALL.md

@@ -78,6 +78,8 @@ spec:
   tower_ingress_type: Ingress
 ```
 
+> If a custom AWX image is needed, see [these docs](./docs/build_awx_image.md) on how to build and use it.
+
 And then creating the AWX object in the Kubernetes API:
 
 ```

docs/build_awx_image.md

@@ -0,0 +1,28 @@
+# Building the AWX Image
+
+## Build & Push Image
+
+To build a custom awx image to use with the awx-operator, use the `build_image` role:
+
+```
+$ ansible-playbook tools/ansible/build.yml -v -e awx_image=registry.example.com/awx -e awx_version=test
+```
+
+This will build an AWX image and tag it.  You can then push that image to your container registry:
+
+
+```
+$ docker push registry.example.com/awx:test
+```
+
+
+## Using this image with the awx-operator
+
+In the spec section of the `my-awx.yml` file described in the [install docs](./../INSTALL.md#deploy-awx),
+specify the new custom image.  
+
+```
+spec:
+  tower_image: registry.example.com/awx
+  tower_image_version: test
+```