How to execute a script when I terminate a docker container

by

The docker stop command attempts to stop a running container first by sending a SIGTERM signal to the root process (PID 1) in the container. If the process hasn’t exited within the timeout period a SIGKILL signal will be sent.

In practice, that means that you have to define an ENTRYPOINT script, which will intercept (trap) the SIGTERM signal and execute any shutdown logic as appropriate.

A sample entrypoint script can look something like this:

#!/bin/bash

#Define cleanup procedure
cleanup() {
    echo "Container stopped, performing cleanup..."
}

#Trap SIGTERM
trap 'cleanup' SIGTERM

#Execute a command
"${@}" &

#Wait
wait $!

(shell signal handling, with respect to wait, is explained in a bit more detail here)

Note, that with the entrypoint above, the cleanup logic will only be executed if container is stopped explicitly, if you wish it to also run when the underlying process or command stops by itself (or fails), you can restructure it as follows.

...
...

#Trap SIGTERM
trap 'true' SIGTERM

#Execute command
"${@}" &

#Wait
wait $!

#Cleanup
cleanup

More Related Contents:

  1. How to copy files from host to Docker container?
  2. Add a volume to Docker, but exclude a sub-folder
  3. Use of Supervisor in docker
  4. How to change the docker image installation directory?
  5. Locating data volumes in Docker Desktop (Windows)
  6. Docker Compose – Share named volume between multiple containers
  7. In a Dockerfile, How to update PATH environment variable?
  8. How to remove old Docker containers
  9. How to keep Docker container running after starting services?
  10. How to show the run command of a docker container
  11. How to make sure docker’s time syncs with that of the host?
  12. Docker remove TAG images
  13. Conditional ENV in Dockerfile
  14. Linux machine with docker deploy windows container
  15. docker data volume vs mounted host directory
  16. Is there a best practice on setting up glibc on docker alpine linux base image?
  17. Docker Compose – How to execute multiple commands?
  18. How do I access a spring app running in a docker container?
  19. How to get ENV variable when doing Docker Inspect
  20. How to pass ARG value to ENTRYPOINT?
  21. Multiple commands on docker ENTRYPOINT
  22. How can I use environment variables in docker-compose?
  23. How to link containers in docker?
  24. Add Insecure Registry to Docker
  25. How to add initial users when starting a RabbitMQ Docker container?
  26. Connect to another container using Docker compose
  27. How to share localhost between two different Docker containers?
  28. How many CPUs does a docker container use?
  29. What is the authoritative list of Docker Run exit codes?
  30. How to stop all containers when one container stops with docker-compose?

Leave a Comment