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/ansible-runner tools/docker-compose/editable_dependencies/
or
ln -s ../ansible-runner 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_var_lib_awx needs to be deleted as well with
make docker-compose-down
docker volume rm tools_var_lib_awx