Pull request 167: 5713-healthcheck-warning

Merge in GO/adguard-home-wiki from 5713-healthcheck-warning to master

Squashed commit of the following:

commit 214d775e6a4ca215565a5a3148df2c1b16255270
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Tue Apr 18 19:24:48 2023 +0300

    Docker: fix typos

commit 9e449b4c721bc552206b919718316d071df02fd0
Author: Eugene Burkov <E.Burkov@AdGuard.COM>
Date:   Tue Apr 18 19:13:06 2023 +0300

    Docker: add known issues
Eugene Burkov 2023-04-18 19:58:03 +03:00
parent 9c70993472
commit 13259ceec6
1 changed files with 34 additions and 0 deletions

@ -224,3 +224,37 @@ your machine:
```sh
systemctl reload-or-restart systemd-resolved
```
## <a href="#known-issues" id="known-issues" name="known-issues">Known issues</a>
### Healthcheck
Since **v0.107.28** the container uses Docker-provided healthcheck mechanism.
If the implementation of the healthcheck script causes any issues with custom
Docker images and orchestration tools (like [#5711], [#5713]), then we recommend
disabling it by adding `--no-healthcheck` to the `docker run` command or using
your tool's equivalent.
(The actual change was made due to a necessity to handle zombie processes of
`wget` instances, see [PID 1 Docker problem][pid1]).
<!--
TODO(e.burkov): Fix the healthcheck for zeroes, update and uncomment this
section. Add the link to the issue.
### Listen addresses
The healthcheck script uses nslookup to check if the DNS server is up and
healthy. If the configuration contains `0.0.0.0` or `::` in the `bind_host`
property, the healthcheck will try to only check the `localhost.`.
Nevertheless, it will sometimes fail ([#5714]), the workaround is to configure
the actual IP address of the interface you want to listen on. Disabling the
healthcheck as described above should also work.
-->
[#5711]: https://github.com/AdguardTeam/AdGuardHome/issues/5711
[#5713]: https://github.com/AdguardTeam/AdGuardHome/issues/5713
[pid1]: https://blog.phusion.nl/2015/01/20/docker-and-the-pid-1-zombie-reaping-problem