Yes, the Alpine images are known to be problematic in Kubernetes cluster concerning DNS queries.
Even if it is not clear if the bug has been effectively fixed in any current version of Alpine, here are some related links:
I encountered this problem on my side in my Kubernetes clusters as of January 2021 with up-to-date Alpine 3.12 images, so I would assume it is not fixed.
The core problem seems to be that the musl
library stop searching among possible domains specified in the search
directive of /etc/resolv.conf
for a given name if any response is unexpected (basically not something clearly indicating that the FQDN could not be found, or has been found).
This does not play well with the Kubernetes strategy about name resolution in pods.
Indeed, one can see that the typical /etc/resolv.conf
of a pod in the example
namespace is the following:
nameserver 10.3.0.10
search example.svc.cluster.local svc.cluster.local cluster.local
options ndots:5
The strategy is that the resolution of a name, for instance my-service
or www.google.com
, will be tested against each of the domains specified in the search
directive: here for the examples, it would be the FQDN chains my-service.example.svc.cluster.local
,my-service.svc.cluster.local
,my-service.cluster.local
,my-service
and www.google.com.example.svc.cluster.local
,www.google.com.svc.cluster.local
,www.google.com.cluster.local
,www.google.com
. Here obviously it would be the 1st FQDN of the first chain (my-service.example.svc.cluster.local
) and the last FQDN of the second chain (www.google.com
) that would be resolved correctly.
One can see that this strategy is made to optimize resolution of internal name of the cluster, in a way that allows names like my-service
, my-service.my-namespace
or my-service.my-namespace.svc
to be nicely resolved out-of-the-box.
The ndots
parameter in the options
directive defines the minimum number of dots in a name to consider that a name is actually a FQDN and so the search chain should be skiped in favor of a direct DNS resolution attempt. With ndots:2
, www.google.com
will be considered as a FQDN while my-service.my-namespace
will go through the search chain.
Given that the search
option over 3 possible domains, that any obvious URL will not be considered as a FQDN because of ndots:5
and the break of the search loop in musl
library in Alpine docker, all of this dramatically increases the probability of a host resolution failure in a Docker Alpine running in Kubernetes. If your host resolution is part of some kind of a loop running regularly, you will encounter a lot of failures that need to be handled.
What to do about this ?
- you can use a
dnsPolicy
to reduce ndots
and consider shorter names as FQDN and skip the search loop (see https://pracucci.com/kubernetes-dns-resolution-ndots-options-and-why-it-may-affect-application-performances.html)
- you can generate a entrypoint script for your image that would modify the
/etc/resolv.conf
accordingly to your needs, for instance cat /etc/resolv.conf | sed -r "s/^(search.*|options.*)/#\1/" > /tmp/resolv && cat /tmp/resolv > /etc/resolv.conf
will remove all the stuff about search
and options
, if you do not rely on any internal name of the cluster in your process
- direct edition of
/etc/host
to hardcode some FQDN to their known IPs
- move away from Alpine images, and go for Ubi or Debian/Ubuntu based images
Personally I started with Alpine, like a lot of us in the early days of Docker industrialization because the other full OS images were insanely big. This is mostly not the case anymore with strongly tested slim images for Ubuntu or Debian, or even Kubernetes-centric initiatives like Ubi. That is why I usually choose the last alternative (move away from Alpine images).