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

34 lines
879 B
Markdown

# 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](./../INSTALL.md#deploy-awx),
specify the new custom image.
```
spec:
image: registry.example.com/awx
image_version: test
```