Skip to content

Commit

Permalink
Add "Why Tini?" section in the README
Browse files Browse the repository at this point in the history
Adds a summary of #8 and a link to that discussion.
  • Loading branch information
krallin committed Jan 2, 2017
1 parent c6e0058 commit 39f7778
Show file tree
Hide file tree
Showing 2 changed files with 38 additions and 0 deletions.
19 changes: 19 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,24 @@ and wait for it to exit all the while reaping zombies and performing
signal forwarding.


Why Tini?
---------

Using Tini has several benefits:

- It protects you from software that accidentally creates zombie processes,
which can (over time!) starve your entire system for PIDs (and make it
unusable).
- It ensures that the *default signal handlers* work for the software you run
in your Docker image. For example, with Tini, `SIGTERM` properly terminates
your process even if you didn't explicitly install a signal handler for it.
- It does so completely transparently! Docker images that work without Tini
will work with Tini without any changes.

If you'd like more detail on why this is useful, review this issue discussion:
[What is advantage of Tini?][0].


Using Tini
----------

Expand Down Expand Up @@ -225,6 +243,7 @@ Special thanks to:
+ [Asko Soukka][41] for packaging Tini for Nix


[0]: https://github.com/krallin/tini/issues/8
[10]: https://github.com/krallin/tini-images
[20]: https://github.com/krallin/
[30]: https://github.com/tianon
Expand Down
19 changes: 19 additions & 0 deletions tpl/README.md.in
Original file line number Diff line number Diff line change
Expand Up @@ -20,6 +20,24 @@ and wait for it to exit all the while reaping zombies and performing
signal forwarding.


Why Tini?
---------

Using Tini has several benefits:

- It protects you from software that accidentally creates zombie processes,
which can (over time!) starve your entire system for PIDs (and make it
unusable).
- It ensures that the *default signal handlers* work for the software you run
in your Docker image. For example, with Tini, `SIGTERM` properly terminates
your process even if you didn't explicitly install a signal handler for it.
- It does so completely transparently! Docker images that work without Tini
will work with Tini without any changes.

If you'd like more detail on why this is useful, review this issue discussion:
[What is advantage of Tini?][0].


Using Tini
----------

Expand Down Expand Up @@ -225,6 +243,7 @@ Special thanks to:
+ [Asko Soukka][41] for packaging Tini for Nix


[0]: https://github.com/krallin/tini/issues/8
[10]: https://github.com/krallin/tini-images
[20]: https://github.com/krallin/
[30]: https://github.com/tianon
Expand Down

0 comments on commit 39f7778

Please sign in to comment.