$ git clone -b develop --recursive https://github.com/UWA-FoS/docker-mytardis.git mytardis
$ cd mytardis
Required to contribute the the MyTardis project.
This will pull all the MyTardis develop branch source and set docker-compose.yml file for the latest UWA develop docker image with prerequisites for testing, etc...
To contribute to the MyTardis project please read the CONTRIBUTING.rst.
$ git clone --recursive https://github.com/UWA-FoS/docker-mytardis.git mytardis
$ cd mytardis
Required to add new features and/or settings to the current UWA production MyTardis service.
- rename the relevant env_template.MODULE file removing the "_template" from the name.
- edit the env.MODULE files with the required settings.
- template file that are not required, ensure the files are renamed and blank OR remove the relevant entry in the docker-compose.yml file.
- edit Dockerfile and/or docker-compose.yml to your desired settings / alterations.
$ docker-compose pull # acquire the latest image from DockerHub
$ docker-compose up -d # start docker containers
$ docker-compose logs --no-color -f # check logging output
(wait for logging output to stop, usually after a group of lines like this, then interrupt with Ctrl-C:)
django_1 | [2018-02-26 04:37:36 +0000] [106] [INFO] Booting worker with pid: 106
django_1 | [2018-02-26 04:37:36 +0000] [111] [INFO] Booting worker with pid: 111
django_1 | [2018-02-26 04:37:36 +0000] [114] [INFO] Booting worker with pid: 114
$ docker-compose exec django python mytardis.py createsuperuser
Once the startup process has completed point you browser to http://localhost:8001/ and login using the credentials provided to the createsuperuser script above.
This development uses Git Submodules to incorporate other code bases into the build process were appropriate, such as the MyTardis source. To work on a different upstream version you should follow "Working on a Project with Submodules", "Pulling in Upstream Changes". E.g.,
To pull the latest upstream changes from MyTardis.
From the cloned project directory run
$ cd src/mytardis
$ git fetch
$ git merge origin/master
$ cd ../..
$ docker-compose build
Configuration can be accomplished in a number of different was as circumstance dictates.
-
Dockerfile
-
docker-entrypoint.d/
Processed in the Django containers.
Dump directory for Docker entrypoint bash scripts.
The scripts are executed in the startup shell (not spawned) and are processed in lexical order.
-
docker-entrypoint_celery.d/
Processed in the Celery containers.
Dump directory for Docker entrypoint bash scripts.
The scripts are executed in the startup shell (not spawned) and are processed in lexical order.
-
settings.d/
Django settings dump directory.
- docker-compose.yml
-
env.MODULE
Entries to these are placed in the docker-compose.yml file env_file and allow environment settings for container instances/deployments.
env_template.MODULE templates are provided for examples and reference. Alter the settings for your deployment and rename the files to env.MODULE (remove the _template part of the name).
-