awx/tools/docker-compose/editable_dependencies/README.md

Editable dependencies in AWX Docker Compose Development Environment

This folder contains the symlink to editable dependencies for AWX

During the bootstrap of awx development environment we will try to crawl through the symlinks and mount (the source of the symlink) to tools_awx_ containers and init_awx containers then install all the dependencies in editable mode

How to enable/disable editable dependnecies

Enable

Set EDITABLE_DEPENDENCIES=true either as an Environment Variable before invoking make docker-compose

export EDITABLE_DEPENDENCIES=true

or during invocation of make docker-compose

EDITABLE_DEPENDENCIES=true make docker-compose

This will cause the make docker-compose-source to template out docker-compose file with editable dependencies.

Disable

To disable editable dependency simply unset EDITABLE_DEPENDENCIES

How to add editable dependencies

Adding symlink to the directory that contains the source of the editable dependencies will cause the dependency to be mounted and installed in the docker-compose development environment.

Both relative path or absolute path will work.

Examples

I have awx checked out at ~/projects/src/github.com/TheRealHaoLiu/awx I have django-ansible-base checked out at ~/projects/src/github.com/TheRealHaoLiu/django-ansible-base

From root of AWX project ~/projects/src/github.com/TheRealHaoLiu/awx

I can either do

ln -s ~/projects/src/github.com/TheRealHaoLiu/django-ansible-base tools/docker-compose/editable_dependencies/

or

ln -s ../django-ansible-base tools/docker-compose/editable_dependencies/

How to remove indivisual editable dependencies

Simply removing the symlink from tools/docker-compose/editable_dependencies will cause problem!

and the volume tools_awx_var_lib needs to be deleted as well with

make docker-compose-down
docker volume rm tools_awx_var_lib