awx/docs/build_awx_image.md
Shane McDonald c9b53cf975
Refactor image_build and image_push roles
Primary changes are:

- Generalized variable names (remove "docker")
- Add explicit "push" variable rather than checking if the "registry" variable is defined.
- Allow for passing in version as build arg
2021-10-12 18:59:13 -04:00

879 B

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 \
    -e registry=registry.example.com \
    -e awx_image=ansible/awx \
    -e awx_version=test -v

Note: The development image (make docker-compose-build) will not work with the awx-operator, the UI is not built in that image, among other things (see Dockerfile.j2 for more info).

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, specify the new custom image.

spec:
  image: registry.example.com/awx
  image_version: test