Skip to content

Docker#

Run commands inside the docker container#

Each docker container uses the entrypoint.

The entrypoint.sh script offers a range of commands to start services or run commands. The full list of commands can be seen in the script. The pattern to run a command is

docker compose run <container-name> <entrypoint-command> <...args>

The following are some examples:

  • Run tests docker compose exec iaso ./manage.py test
  • Create a shell inside the container docker compose run iaso bash
  • Run a shell command docker compose run iaso eval curl http://google.com
  • Run Django manage.py docker compose exec iaso ./manage.py help
  • Launch a python shell docker compose exec iaso ./manage.py shell
  • Launch a postgresql shell docker compose exec iaso ./manage.py dbshell
  • Create pending ORM migration files docker compose exec iaso ./manage.py makemigrations
  • Apply pending ORM migrations docker compose exec iaso ./manage.py migrate
  • Show ORM migrations docker compose exec iaso ./manage.py showmigrations
  • To run a background worker docker compose run iaso manage tasks_worker

Containers and services#

  • iaso The python backend in Django
  • webpack The JS frontend in react
  • db PostgreSQL database

All the container definitions for development can be found in docker-compose.yml.

docker compose run vs. docker compose exec#

docker compose run launches a new docker container, docker compose exec launches a command in the existing container.

So run will ensure the dependencies like the database are up before executing. exec main advantage is that it is faster but the containers must already be running (launched manually)

run will launch the entrypoint.sh script but exec will take a bash command to run which is why if you want to run the django manage.py you will need to use run iaso manage but exec iaso ./manage.py

Also take care that run unless evoked with the --rm will leave you with a lot of left over containers that take up disk space and need to be cleaned occasionally with docker compose rm to reclaim disk space.