From 13259ceec68081d12f4c2faef5a72133c501ce39 Mon Sep 17 00:00:00 2001 From: Eugene Burkov <e.burkov@adguard.com> Date: Tue, 18 Apr 2023 19:58:03 +0300 Subject: [PATCH] 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 --- Docker.md | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) diff --git a/Docker.md b/Docker.md index e8ddc36..9f18cd2 100644 --- a/Docker.md +++ b/Docker.md @@ -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